Shop MCP

Ask an agent to

• Find a waterproof rain jacket under $150 across Shopify stores
• Create a cart and prepare checkout with Shop Pay
• Track my recent Shop orders

20 tools

• cancel_spend_requestasks to confirmuntrusted content

  Cancel the spend request; this does not cancel/refund the purchase or revoke an issued credential.

  id: string, meta: object?

• clear_terminal

  Clear idle pending input, the terminal display and scrollback. Refuses while a command is active. Does not sign out.

• complete_checkoutasks to confirmuntrusted content

  Send user-approved payment to the same shop/exact checkout ID with one exact offered instrument selected:true. Only completed + order proves purchase. After uncertainty, read get_checkout; never repeat completion or…

  checkout: object, id: string, meta: object?, shop: string

• complete_spend_requestasks to confirmuntrusted content

  Report the purchase attempt's outcome as success or error. Include order details when available, or failure information for an error. This records your report, not payment confirmation.

  id: string, result: object

• create_cartasks to confirmuntrusted content

  Create a cart only when asked to save items; interest is not permission. Use exact returned variant IDs/quantities. Use create_checkout for Review and pay. Does not order.

  cart: object, meta: object?, shop: string

• create_checkoutasks to confirmuntrusted content

  Prepare Shop/UCP checkout only when asked. No separate spend request is needed. Use exact variant IDs/quantities. Share continue_url unchanged for Review and pay, including requires_escalation. Never recreate…

  checkout: object, meta: object?, shop: string

• create_spend_requestasks to confirmuntrusted content

  Request buyer approval for a purchase where the agent enters a payment credential into a website's checkout form using a browser. Provide the purchase terms and spending limit; name a saved card, or omit it to use the…

  meta: object?, spend_request: object

• get_accountread-onlyuntrusted content

  Read signed-in Shop account, addresses, budget/cards. For missing checkout delivery, copy one addresses[] entry unchanged into fulfillment destinations and select its id; preferred_address_id is default. buyer.email…

• get_cartread-onlyuntrusted content

  Read with the same shop/exact opaque ID before update or after an uncertain cart write.

  id: string, shop: string

• get_checkoutread-onlyuntrusted content

  Read with the same shop/exact opaque ID before update/completion or after an uncertain write. continue_url is Review and pay, not a product page/purchase proof.

  id: string, shop: string

• get_productread-onlyuntrusted content

  Resolve missing details/options for a known product. Use its returned ID/exact option name-label pairs; verify effective selection because requests may drop. Ground availability, seller, price/currency, rating, and…

  catalog: object

• get_spend_requestasks to confirmuntrusted content

  Check the spend request's status. After buyer approval, returns the payment credential. Use it unchanged and only for the approved purchase.

  id: string

• lookup_catalogread-onlyuntrusted content

  Resolve known product/variant IDs, GTINs, UPCs, or URLs. Use search_catalog for discovery; get_product only for unresolved options/details. Preserve IDs/URLs; ground claims in the exact offer. Amounts are minor units.

  catalog: object

• search_catalogread-onlyuntrusted content

  Find by query/like. Anonymous works; sign-in adds saved preferences. Context soft; filters hard. Matches/options do not prove the variant. Check messages; ground options, availability, price/currency, rating, seller…

  catalog: object

• search_ordersread-onlyuntrusted content

  Search signed-in buyer's Shop-tracked orders/standalone shipments. Omit query for recent. Missing is unknown. events[].type is fulfillment; use status/carrier tracking for progress. LABEL_CREATED proves only a label.…

  activity: string?, date_from: string?, date_to: string?, pagination: object?, query: string?

• shop_sign_inasks to confirm

  Connect Shop only when the user agrees. Start with wait:0 to return the current public activation URL and user code without polling. After the user approves in another tab, call wait:90. Only data.signed_in:true…

  wait: integer?

• shop_skillread-only

  Read this skill before using the Shop commerce tools. Start with {} for the entrypoint and follow exact linked references when relevant. Reads are quiet and do not change the terminal.

  reference: string?

• update_cartasks to confirmuntrusted content

  Replace full cart, not a patch. Read first; change only authorized fields; retain all other request fields, including empty objects/arrays. Response-only fields drop. Same shop/exact ID; check returned state. After…

  cart: object, id: string, meta: object?, shop: string

• update_checkoutasks to confirmuntrusted content

  Replace full checkout, not patch/payment. Read first; change only authorized fields; retain all other request fields, including empty objects/arrays. Response-only fields drop. Same shop/exact ID; check…

  checkout: object, id: string, meta: object?, shop: string

• update_spend_requestasks to confirmuntrusted content

  Update the request's address, items, totals or spending limit. Omitted fields stay unchanged. Wallet decides whether its current state allows the update.

  id: string, meta: object?, spend_request: object