Shopping & commerce Shopify
Shop MCP (Shopify Catalog search)
Search participating Shopify product listings and prepare shopping carts through Shop’s hosted MCP service.
Source review: 2026-10-29 · Imported: 1 November 2026
A practical starting point
What could you build?
A shopping assistant can help a visitor compare listed products and assemble a cart for review.
Before you connect
Separate product discovery from account features and purchase approval. Listing prices and availability can change.
Capabilities & requirements
Dated specifications from the licensed source dataset. “Not published” indicates missing information, rather than confirmed absence.
| Capability | Details and source |
|---|---|
| Status | No stage label No preview or beta label on shop.dev; MCP 2026-07-28 and UCP 2026-08-25. Shopify notes catalog endpoint URLs might change. Source (external) · Verified 2026-10-29 on https://shop.dev/docs |
| API key required | No key for search, cart, checkout Keyless search_catalog and tools/list returned HTTP 200 on 2026-10-29; account, order and spend-request tools need a Shop OAuth token (get_account gave 401). Source (external) · Verified 2026-10-29 by test request to https://mcp.shop.com/ |
| Free tier | Free, no account shop.dev: search needs no account or key; a Dev Dashboard key only raises limits. Source (external) · Verified 2026-10-29 on https://shop.dev/ |
| Rate limit | Not published Keyless number not published: anonymous tier is the lowest, per IP plus a shared pool, not for production. Keyed Global Catalog default is 5 requests/second per API client. Source (external) · Not published by vendor: checked 2026-10-29 on https://shopify.dev/docs/agents/profiles/auth-and-rate-limiting |
| Official MCP server | Hosted, mcp.shop.com/ Stateless, MCP 2026-07-28; our tools/list returned 19 tools (docs say 17). Source (external) · Verified 2026-10-29 by test request to https://mcp.shop.com/ |
| Official SDK | CLI only, no SDK library Shopify publishes the shop CLI (npm @shopify/shop 1.2.0, MIT) and plain HTTP examples, but no language SDK for Shop MCP. Source (external) · Verified 2026-10-29 on https://github.com/Shopify/shop |
| Data license / terms | Shopify API Terms + catalog rules API Terms updated Oct 7, 2026: no AI training on derived data, no reproducing catalogs. Catalog rules: no caching results or downloading images. Source (external) · Verified 2026-10-29 on https://www.shopify.com/legal/api-terms |
| Commercial use allowed | Yes, within the API Terms Built for apps and agents to sell through; the training, caching and catalog-copying bans still apply. Source (external) · Verified 2026-10-29 on https://www.shopify.com/legal/api-terms |
| CORS / browser use | Access-Control-Allow-Origin: * Returned on our POST and on a preflight with a third-party Origin on 2026-10-29. Source (external) · Verified 2026-10-29 by test request to https://mcp.shop.com/ |
| Freshness / coverage | Live merchant data; 1B+ products shop.dev says over 1 billion products from millions of stores; results reflect current price and stock and may not be cached. Source (external) · Verified 2026-10-29 on https://shopify.dev/docs/agents/catalog |
Operational reference
Additional facts and qualifications retained from AgentAPIList’s CC BY 4.0 dataset, with provider references.
Price
Free. shop.dev says search “needs no account or key”; an optional Dev Dashboard API key only raises limits. Purchases are paid by the shopper at the merchant’s normal prices.
Provider reference (external)API key / auth
None for search_catalog, lookup_catalog, get_product and the cart and checkout tools. get_account, search_orders and the five spend-request tools need a Shop account token (OAuth, personal_agent scope). Our keyless search_catalog call on 2026-10-29 returned HTTP 200; get_account without a token returned 401 with a WWW-Authenticate header.
Provider reference (external)Rate limit
No number is published for keyless use. Anonymous traffic gets Shopify’s lowest tier, limited per IP and shared with all other unauthenticated traffic, and Shopify says not to use it for production. With an API key the Global Catalog default is 5 requests per second per API client. Shopify’s catalog usage rules add that keyless access cannot get a limit increase.
Provider reference (external)License / terms
Shopify API Terms (last updated Oct 7, 2026) apply. Section 24 bans using anything derived from the API to train or improve AI models, and reproducing substantial parts of catalogs beyond limited previews for product discovery. The catalog usage rules ban caching results and downloading product images.
Provider reference (external)Version status
No stage label on Shop MCP. It uses MCP protocol 2026-07-28 and Universal Commerce Protocol 2026-08-25; Shopify notes catalog endpoint URLs might change.
Provider reference (external)Tools
The docs list 17 tools. Our keyless tools/list on 2026-10-29 returned 19: the 17 plus search_locations and lookup_locations. Search returns 1 to 50 results per call (default 10), and pages stop at 1,000 results.
Provider reference (external)Setup references
HTTP request example
Adapted from the attributed source dataset. Review before running; these examples were not executed by Tech in General.
curl -sS https://mcp.shop.com/ \
-H 'Content-Type: application/json' \
-H 'Accept: application/json, text/event-stream' \
-H 'MCP-Protocol-Version: 2026-07-28' \
-H 'Mcp-Method: tools/call' \
-H 'Mcp-Name: search_catalog' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{
"name":"search_catalog",
"arguments":{"catalog":{"query":"ceramic coffee dripper",
"context":{"address_country":"US","currency":"USD"},
"pagination":{"limit":3}}},
"_meta":{"io.modelcontextprotocol/protocolVersion":"2026-07-28",
"io.modelcontextprotocol/clientInfo":{"name":"my-agent","version":"1.0.0"},
"io.modelcontextprotocol/clientCapabilities":{}}}}'Agent connection example
Adapted from the attributed source dataset. Review before running; these examples were not executed by Tech in General.
# Claude Code (keyless; note the trailing slash, there is no /mcp path)
claude mcp add --transport http shop https://mcp.shop.com/
# Optional: Shopify's plugin adds the same server plus its shopping skill
claude plugin marketplace add Shopify/shop
claude plugin install shop@shop
# Gemini CLI
gemini mcp add --transport http shop https://mcp.shop.com/
# Claude.ai / ChatGPT: add a custom connector with the URL https://mcp.shop.com/
# Any other client works only if it speaks MCP 2026-07-28 (server/discover).
# Older initialize-only clients: use the shop CLI instead
npm i -g @shopify/shop
shop search 'ceramic coffee dripper' --ships-to US --currency USD --limit 25A tool schema needs an HTTP implementation; it does not by itself install an MCP server. Keep credentials out of browser code.
Other connections to explore
- Shopify Global Catalog API (external)
- Shopify Storefront Catalog MCP (external)
- Parallel MCP (free) (external)
- Official MCP Registry API (external)
Source & reuse
Download the complete licensed source snapshot (JSON), including the original source’s caveats, alternative notes and examples.