Add Shop Collection Item
puppetto_add_shop_collection_itemAdd a product template to a shop/store collection. Requires an admin-linked organization API key.
Archive Print Plate
puppetto_archive_print_plateSoft delete a scoped print_plate with its revision while preserving relationships and durable receipts. Does not remove provider output, cancel orders, or publish.
Archive Print Plate Artwork
puppetto_archive_print_plate_artworkSoft delete a scoped print_plate_artwork with its revision while preserving relationships and durable receipts. Does not remove provider output, cancel orders, or publish.
Archive Product Price
puppetto_archive_product_priceSoft delete a scoped product_price with its revision while preserving relationships and durable receipts. Does not remove provider output, cancel orders, or publish.
Archive Product Template
puppetto_archive_product_templateSoft delete a scoped product_template with its revision while preserving relationships and durable receipts. Does not remove provider output, cancel orders, or publish.
Archive Product Variant
puppetto_archive_product_variantSoft delete a scoped product_variant with its revision while preserving relationships and durable receipts. Does not remove provider output, cancel orders, or publish.
Archive Shop
puppetto_archive_shopSoft delete a scoped shop with its revision while preserving relationships and durable receipts. Does not remove provider output, cancel orders, or publish.
Archive Shop Collection
puppetto_archive_shop_collectionSoft delete a scoped shop_collection with its revision while preserving relationships and durable receipts. Does not remove provider output, cancel orders, or publish.
Archive Shop Collection Item
puppetto_archive_shop_collection_itemSoft delete a scoped shop_collection_item with its revision while preserving relationships and durable receipts. Does not remove provider output, cancel orders, or publish.
Create Draft Product Template
puppetto_create_draft_product_templateCreate a draft shop product template for the authorized organization. Requires an admin-linked organization API key.
Create Draft Shop
puppetto_create_draft_shopCreate a draft shop/store for the authorized organization. Requires an admin-linked organization API key.
Create Print Plate
puppetto_create_print_plateCreate a draft/scoped print_plate through the existing product command. Returns its ID, revision, fields, and durable operation receipt. No publication, email, provider submission, or paid generation. Parent relationships and referenced artwork must be available in this organization.
Create Print Plate Artwork
puppetto_create_print_plate_artworkCreate a draft/scoped print_plate_artwork through the existing product command. Returns its ID, revision, fields, and durable operation receipt. No publication, email, provider submission, or paid generation. Parent relationships and referenced artwork must be available in this organization.
Create Product Price
puppetto_create_product_priceCreate a draft/scoped product_price through the existing product command. Returns its ID, revision, fields, and durable operation receipt. No publication, email, provider submission, or paid generation. Parent relationships and referenced artwork must be available in this organization.
Create Product Template
puppetto_create_product_templateCreate a draft/scoped product_template through the existing product command. Returns its ID, revision, fields, and durable operation receipt. No publication, email, provider submission, or paid generation. Parent relationships and referenced artwork must be available in this organization.
Create Product Variant
puppetto_create_product_variantCreate a draft/scoped product_variant through the existing product command. Returns its ID, revision, fields, and durable operation receipt. No publication, email, provider submission, or paid generation. Parent relationships and referenced artwork must be available in this organization.
Create Shop
puppetto_create_shopCreate a draft/scoped shop through the existing product command. Returns its ID, revision, fields, and durable operation receipt. No publication, email, provider submission, or paid generation. Parent relationships and referenced artwork must be available in this organization.
Create Shop Automation Job
puppetto_create_shop_automation_jobCreate a pending ecommerce/shop automation job from a shop, taste profile, character, and flexible job input. Requires an admin-linked organization API key.
Create Shop Collection
puppetto_create_shop_collectionCreate a draft collection for a shop/store. Requires an admin-linked organization API key.
Create Shop Collection Item
puppetto_create_shop_collection_itemCreate a draft/scoped shop_collection_item through the existing product command. Returns its ID, revision, fields, and durable operation receipt. No publication, email, provider submission, or paid generation. Parent relationships and referenced artwork must be available in this organization.
Create Shop Collection V2
puppetto_create_shop_collection_v2Create a draft/scoped shop_collection through the existing product command. Returns its ID, revision, fields, and durable operation receipt. No publication, email, provider submission, or paid generation. Parent relationships and referenced artwork must be available in this organization.
Create Shop Taste Profile
puppetto_create_shop_taste_profileCreate a shop taste profile for ecommerce asset generation defaults. Requires an admin-linked organization API key.
Create Usps Label
puppetto_create_usps_labelCreate a private 4x6 USPS PDF for all manual items in one paid US domestic order. Requires measured packed weight in ounces/dimensions in inches, sender address, and the environment just read from get_usps_shipping. Production charges the organization USPS EPS account; obtain human authorization before setting confirmPostageCharge=true. Test labels buy no postage and cannot ship. A created label is reused, and concurrent web/MCP requests share a durable purchase lock. Never automatically retry an unknown creating/review outcome. Does not mark shipped.
Download Usps Label
puppetto_download_usps_labelRetrieve the private USPS PDF, or recover it from the saved carrier response, without buying postage or contacting USPS. Select test or production explicitly. Returns application/pdf bytes as base64 and a filename; decode base64 into a local file for printing. Labels contain private addresses; keep them private. A saved response that cannot be parsed needs operator review, never repurchase.
Get Commerce Cart Bundle
puppetto_get_commerce_cart_bundleInspect cart lines and catalog-only price diagnostics for this page. Current catalog prices are not a checkout quote; legacy checkout currency/effective-date pricing requires separate verification.
Get Commerce Fulfillment
puppetto_get_commerce_fulfillmentRead a durable fulfillment intent and checkpointed provider identity after timeout/restart. This read makes no provider request and does not assert refunds.
Get Commerce Order Bundle
puppetto_get_commerce_order_bundleInspect an existing order, paginated line IDs and immutable prices, separate fulfillment/provider/shipment/cancellation/refund evidence, and operator recovery handoffs.
Get Product Template
puppetto_get_product_templateGet a shop product template with variants and pricing for the authorized organization.
Get Shop
puppetto_get_shopGet a shop/store by ID for the authorized organization.
Share the full storefront catalogue
puppetto_get_shop_catalogueReturn the public JSON catalogue URL and counts for one published shop in the connected organization. Fetch catalogueUrl to receive the complete published catalogue with collections, descriptions, galleries, variants, options, effective retail prices by currency, cached stock timestamps and product links. No product pagination or truncation. Draft/unpublished shops have no public feed. Internal costs, markup rules, private metadata and digital fulfillment files are excluded. This read does not publish a shop or change checkout.
Get Shop Collection
puppetto_get_shop_collectionGet a shop/store collection and its product items for the authorized organization.
Get Shop Order
puppetto_get_shop_orderGet an ecommerce shop order with line items. Requires an admin-linked organization API key.
Get Shop Website Import Job
puppetto_get_shop_website_import_jobGet a create-shop-from-URL import job for the authorized organization.
Get Usps Shipping
puppetto_get_usps_shippingInspect manual shipment eligibility, checkout delivery address, supported services, connected USPS environment and saved label status for an existing paid order. Credentials and PDF bytes are never returned by this read. Use list_commerce_orders/get_commerce_order_bundle to discover orders. One US domestic package covers all manual items; mixed-order provider items remain separate.
Inspect Catalog Readiness
puppetto_inspect_catalog_readinessInspect up to 100 products linked to a shop, active variants, effective currency-specific resolved prices, published collection membership, and artwork readiness. Missing/foreign products and missing prices are blockers; zero is a valid price. This preparation report excludes checkout/payment/provider readiness and does not publish.
Inspect Commerce Launch Readiness
puppetto_inspect_commerce_launch_readinessReturn catalog, pricing provenance and configured fulfillment diagnostics. Catalog readiness does not prove storefront checkout, payment, tax or shipping readiness; unresolved checks keep overall ready=false.
List Commerce Carts
puppetto_list_commerce_cartsInspect server carts by read-derived cart IDs without exposing shopper client-cart keys.
List Commerce Orders
puppetto_list_commerce_ordersList existing authorized orders with stored amounts, native status and revisions. Does not create checkout, charge, or reprice orders.
List Print Plate Artworks
puppetto_list_print_plate_artworksList scoped print_plate_artwork records with UUID cursor pagination. parentId is required and identifies printPlateTemplateId. Set includeArchived to inspect preserved relationships.
List Print Plates
puppetto_list_print_platesList scoped print_plate records with UUID cursor pagination. parentId is required and identifies productTemplateId. Set includeArchived to inspect preserved relationships.
List Product Prices
puppetto_list_product_pricesList scoped product_price records with UUID cursor pagination. parentId is required and identifies productTemplateVariantId. Set includeArchived to inspect preserved relationships.
List Product Templates
puppetto_list_product_templatesList shop product templates for the authorized organization.
List Product Templates V2
puppetto_list_product_templates_v2List scoped product_template records with UUID cursor pagination. Set includeArchived to inspect preserved relationships.
List Product Variants
puppetto_list_product_variantsList scoped product_variant records with UUID cursor pagination. parentId is required and identifies productTemplateId. Set includeArchived to inspect preserved relationships.
List Shop Automation Jobs
puppetto_list_shop_automation_jobsList ecommerce/shop automation jobs for product, artwork, and merchandising generation. Requires an admin-linked organization API key.
List Shop Collection Items
puppetto_list_shop_collection_itemsList product templates in a shop/store collection.
List Shop Collection Items V2
puppetto_list_shop_collection_items_v2List scoped shop_collection_item records with UUID cursor pagination. parentId is required and identifies shopCollectionId. Set includeArchived to inspect preserved relationships.
List Shop Collections
puppetto_list_shop_collectionsList shop/store collections for the authorized organization, optionally scoped to a shop.
List Shop Collections V2
puppetto_list_shop_collections_v2List scoped shop_collection records with UUID cursor pagination. parentId is required and identifies shopId. Set includeArchived to inspect preserved relationships.
List Shop Orders
puppetto_list_shop_ordersList ecommerce shop orders for the authorized organization. Requires an admin-linked organization API key.
List Shop Taste Profiles
puppetto_list_shop_taste_profilesList shop taste profiles that guide ecommerce artwork, product mockup, and merchandising generation.
List Shop Website Import Jobs
puppetto_list_shop_website_import_jobsList create-shop-from-URL import jobs for the authorized organization.
List Shops
puppetto_list_shopsList shops/stores for the authorized organization.
List Shops V2
puppetto_list_shops_v2List scoped shop records with UUID cursor pagination. Set includeArchived to inspect preserved relationships.
Mark Usps Shipped
puppetto_mark_usps_shippedAfter the human confirms the package was handed to USPS, mark only the label manual items shipped. Requires a created production label and confirmCarrierHandoff=true; test labels cannot ship. Updates the whole order only after all fulfillment groups shipped. Repeats are safe. Label creation alone is not carrier handoff; this does not claim delivery or refund.
Match Cached Printful Catalog
puppetto_match_cached_printful_catalogSearch cached Printful product titles/type/description by literal text. Cursor is the prior product ID. cacheStatus unavailable distinguishes a missing catalog from a zero-match result. No provider sync, vector generation, or spending.
Read Print Plate
puppetto_read_print_plateRead one organization-scoped print_plate, including its revision and archive state. Foreign IDs are unavailable.
Read Print Plate Artwork
puppetto_read_print_plate_artworkRead one organization-scoped print_plate_artwork, including its revision and archive state. Foreign IDs are unavailable.
Read Product Price
puppetto_read_product_priceRead one organization-scoped product_price, including its revision and archive state. Foreign IDs are unavailable.
Read Product Template
puppetto_read_product_templateRead one organization-scoped product_template, including its revision and archive state. Foreign IDs are unavailable.
Read Product Variant
puppetto_read_product_variantRead one organization-scoped product_variant, including its revision and archive state. Foreign IDs are unavailable.
Read Shop
puppetto_read_shopRead one organization-scoped shop, including its revision and archive state. Foreign IDs are unavailable.
Read Shop Collection
puppetto_read_shop_collectionRead one organization-scoped shop_collection, including its revision and archive state. Foreign IDs are unavailable.
Read Shop Collection Item
puppetto_read_shop_collection_itemRead one organization-scoped shop_collection_item, including its revision and archive state. Foreign IDs are unavailable.
Recover Commerce Fulfillment
puppetto_recover_commerce_fulfillmentInspect a saved provider order, request supported cancellation, explicitly retry an authoritative pre-provider rejection, or repair the local submitted pointer from accepted provider evidence without submitting again. Cancellation is confirmed only by local pre-submit cancellation or actual provider evidence and never claims a buyer refund. Unknown submission/cancellation is not automatically retried.
Request Commerce Fulfillment
puppetto_request_commerce_fulfillmentRequest fulfillment of a single-provider physical order using the shared native paid-order path. Requires recorded payment; confirmed submission can charge the provider account. Durable claims block concurrent web/MCP duplicates. Returns receipt plus current intent; unknown outcomes require reconciliation, not automatic retries.
Transition Commerce Order
puppetto_transition_commerce_orderMove a recorded paid order into internal processing using existing domain rules. Cannot assert payment, shipment, cancellation or refund evidence.
Update Print Plate
puppetto_update_print_plateUpdate one scoped print_plate with its current expectedRevision. Same key/input recovers the prior receipt; changed input with the same key conflicts. Shop/collection publication is a distinct operation and is unavailable through this local preparation command.
Update Print Plate Artwork
puppetto_update_print_plate_artworkUpdate one scoped print_plate_artwork with its current expectedRevision. Same key/input recovers the prior receipt; changed input with the same key conflicts. Shop/collection publication is a distinct operation and is unavailable through this local preparation command.
Update Product Price
puppetto_update_product_priceUpdate one scoped product_price with its current expectedRevision. Same key/input recovers the prior receipt; changed input with the same key conflicts. Shop/collection publication is a distinct operation and is unavailable through this local preparation command.
Update Product Template
puppetto_update_product_templateUpdate or activate a shop product template. Product templates must be active before they appear on public storefronts. Requires an admin-linked organization API key.
Update Product Template V2
puppetto_update_product_template_v2Update one scoped product_template with its current expectedRevision. Same key/input recovers the prior receipt; changed input with the same key conflicts. Shop/collection publication is a distinct operation and is unavailable through this local preparation command.
Update Product Variant
puppetto_update_product_variantUpdate one scoped product_variant with its current expectedRevision. Same key/input recovers the prior receipt; changed input with the same key conflicts. Shop/collection publication is a distinct operation and is unavailable through this local preparation command.
Update Shop
puppetto_update_shopUpdate shop/store metadata or status for the authorized organization. Requires an admin-linked organization API key.
Update Shop Collection
puppetto_update_shop_collectionUpdate or publish a shop/store collection. Publish collections before expecting product templates to appear on the public storefront. Requires an admin-linked organization API key.
Update Shop Collection Item
puppetto_update_shop_collection_itemUpdate one scoped shop_collection_item with its current expectedRevision. Same key/input recovers the prior receipt; changed input with the same key conflicts. Shop/collection publication is a distinct operation and is unavailable through this local preparation command.
Update Shop Collection V2
puppetto_update_shop_collection_v2Update one scoped shop_collection with its current expectedRevision. Same key/input recovers the prior receipt; changed input with the same key conflicts. Shop/collection publication is a distinct operation and is unavailable through this local preparation command.
Update Shop Taste Profile
puppetto_update_shop_taste_profileUpdate a shop taste profile used for ecommerce asset generation defaults. Requires an admin-linked organization API key.
Update Shop V2
puppetto_update_shop_v2Update one scoped shop with its current expectedRevision. Same key/input recovers the prior receipt; changed input with the same key conflicts. Shop/collection publication is a distinct operation and is unavailable through this local preparation command.