← All agent tools

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.

Shop MCP (Shopify Catalog search) specifications
CapabilityDetails and source
StatusNo 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 requiredNo 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 tierFree, 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 limitNot 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 serverHosted, 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 SDKCLI 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 / termsShopify 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 allowedYes, 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 useAccess-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 / coverageLive 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 25

A 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

Back to the full directory →

Source & reuse

Download the complete licensed source snapshot (JSON), including the original source’s caveats, alternative notes and examples.