MCP field guide / Shopify
// mcp field guide · commerce
"Shopify MCP" is several servers with opposite risk profiles. The one most developers install — the dev/docs MCP — is read-only and can't touch your store; it's the wrong demo for a safety proxy. The money lives elsewhere: the Checkout MCP that submits payment, and community Admin servers that refund and cancel orders. Here's which is which.
GUARD FIT · DEV/DOCS + CART
LOWDev MCP reads docs/schemas (no store data); cart writes mutate a disposable cart. Little to gate.
GUARD FIT · CHECKOUT + ADMIN
STRONGcomplete_checkout submits payment; community Admin servers refund, cancel and fulfill orders — money + customer-facing.
Overall fit: STRONG for the checkout/admin surface; weak for the dev/docs and cart servers — grade by which server.
| Server | What it is | Risk |
|---|---|---|
Dev MCP (@shopify/dev-mcp) | Official, local. Docs search + GraphQL schema introspection + code/theme validation. No live store data. | read-only |
| Storefront MCP | Official, hosted. Catalog search, product/cart reads; update_cart. | read + cart |
| Cart MCP (UCP) | Official, hosted. create_cart/update_cart/cancel_cart — a disposable cart, no money. | mutating |
| Checkout MCP (UCP) | Official, hosted (JWT). complete_checkout submits payment + places an order. | financial |
| Community Admin servers | Third-party (not Shopify). Full Admin-API CRUD: products, inventory, orders, discounts, refund/cancel/fulfill. | mutating + financial |
| Tier | Tools |
|---|---|
| read-only | Dev: search_docs_chunks, introspect_graphql_schema, validate_graphql_codeblocks. Storefront: search_catalog, get_product, get_cart |
| mutating (no money) | create_cart, update_cart, cancel_cart, create_checkout, update_checkout |
| financial / consequential | complete_checkout (submits payment, places order; idempotency-keyed); community Admin: refund, cancel order, fulfill, delete product, adjust inventory (names vary per project — unverified) |
Honest sourcing note: the read-only Dev/docs MCP tool names have drifted across versions (older introspect_admin_schema/search_dev_docs → introspect_graphql_schema/search_docs_chunks) — verify with npx @shopify/dev-mcp@latest. And no official Shopify-hosted tool named "issue refund" appears in primary docs; refund/capture/cancel writes surface via community Admin-API servers or the Dev MCP driving the Shopify CLI — so we attribute that surface to community servers, whose exact tool names vary and are unverified.
Agentic shopping. Search a merchant catalog (Storefront), assemble a cart (Cart), drive checkout to a placed order (complete_checkout) — or hand the shopper a continue-URL to finish on Shopify's own checkout.
App/theme dev. A coding agent uses Dev MCP to search docs and introspect the schema so generated queries compile against the real API.
Store ops (community). Manage products, inventory, orders and discounts conversationally via an Admin-API server.
Dev/docs MCP → weak — say it plainly. It's read-only against documentation and schemas; nothing to roll back, no store state changed, no money moved. A guard here adds friction for near-zero risk. (When the Dev MCP/CLI is pointed at an authenticated store to run a task, that execute step re-enters mutating territory — and Shopify already gates it with "you choose when to execute.")
Cart/Storefront → medium-weak. update_cart/cancel_cart mutate a disposable cart, not money or customer records.
Checkout + community Admin → strong. This is where a guard earns its place: complete_checkout moves real money and creates an order — a payment, not a reversible state change; and Admin writes (cancel/fulfill an order, adjust inventory, delete products, issue a refund) are customer-facing and consequential.
The honesty point lands hard here: a charge cannot be "undone," only compensated by a refund, which is a new transaction — never claim reversal. And note the guide's own lesson: the safe Shopify MCP (dev/docs) is the wrong thing to wrap in a safety proxy; the commerce/admin MCPs are the right one. Gate the dangerous subset — here, complete_checkout and Admin money/order writes.
ChronoMCP passes the dev/docs and catalog reads through and holds complete_checkout and Admin refund/cancel writes for a human.
complete_checkout submits payment): shopify.dev/docs/agents/carts-and-checkout/checkout-mcpProfiles describe third-party software from its public sources; ChronoMCP is not affiliated with Shopify; community Admin-API servers are independent, unofficial projects. Dev MCP tool names drift across versions; community Admin tool names vary per project and are not enumerated here. Risk groupings are our classification. Sources current as of Aug 2026 — check the source links.