{ "data": { "a": { "slug": "mealme", "name": "MealMe API", "vendor": "MealMe, Inc.", "vendorUrl": "https://www.mealme.ai/", "kind": "http-api", "category": "shopping", "summary": "MealMe is a REST API from MealMe, Inc. that searches restaurants, grocery stores and products across the US and Canada, returns menus and inventory with live quotes, and places pickup or delivery orders with tracking and support chat.", "url": "https://www.anchorterminal.com/tools/mealme", "markdownUrl": "https://www.anchorterminal.com/tools/mealme.md", "slimMarkdownUrl": "https://www.anchorterminal.com/tools/mealme.min.md", "jsonUrl": "https://www.anchorterminal.com/api/v1/tools/mealme.json", "dns": "mealme.grade.anchorterminal.com", "license": "Proprietary service under the MealMe API and SDK Terms of Use", "transports": [], "packages": [], "auth": "api-key", "authNotes": "One API key per account, sent in the Id-Token header on every call. A person creates an account with email and password at https://mealmeai.vercel.app/dashboard, adds a card, then creates the key; the docs also say to request a key through account setup on mealme.ai. No scopes, key expiry or rotation are documented. The embedded SDK uses a separate SDK key issued after a meeting and a licence agreement.", "pricing": "usage", "pricingNotes": "$0.10 per successful API call on the Developer plan with no monthly minimum, invoiced daily; $250 a month for unlimited successful calls on the Unlimited plan; Enterprise at a custom price for 250,000 or more calls a month. A card is required before API access. No free tier or credits found (https://mealmeai.vercel.app/pricing, checked 3 November 2026).", "priceSummary": "$0.10 / call", "where": "local", "x402": { "level": "no", "evidence": "No x402, MPP or L402 in the API reference, llms.txt, pricing page or API terms (checked 3 November 2026).", "endpoints": [] }, "toolCount": 0, "popularity": { "githubStars": null, "npmWeekly": null, "pypiWeekly": null, "asOf": "2026-11-03" }, "docsUrl": "https://docs.mealme.ai/reference/environments", "llmsTxt": "https://mealmeapi.readme.io/llms.txt", "capabilities": [ "shopping.search", "shopping.orders", "shopping.prices", "cooking.grocery", "commerce.cart", "commerce.checkout" ], "tags": [ "hosted", "closed-source", "api-key", "usage-priced", "card-required", "llms-txt", "rest", "webhooks", "sandbox", "no-status-page" ], "lastRelease": "2025-05-06", "graded": true, "anchor": { "graded": true, "score": 38.4, "grade": "E", "agentReady": false, "rank": 1229, "ranked": true, "rankOf": 1349, "categoryRank": 8, "methodology": "0.7", "run": "2026-10-01", "scores": { "ergonomics": 69, "maintenance": 6, "payments": 20, "reliability": 19, "schema": 72, "security": 26, "transparency": 47 }, "pending": [ "performance", "tasks" ], "assessment": { "confidence": "medium", "date": "2026-11-03" }, "negative": 0, "verdict": "An agent can search stores and products, fetch live quotes and place a real order through one REST API priced at $0.10 a successful call. One all-powerful key, no rate limit figures, no status page, no idempotency key on orders and release notes that stop at 6 May 2025 are the limits.", "bestFor": "Agents that must place a real restaurant or grocery order in the US or Canada, or compare live prices across stores, and can hold a card on the account.", "strengths": [ "Search, inventory, cart, order, payment, tracking webhook and support chat in one API, covering restaurants and grocery stores in the US and Canada", "Per-call price published without login, $0.10 a successful call with no monthly minimum, or $250 a month unlimited", "Store search takes a projections list to size responses and pages through next_page; product search accepts UPC codes", "Orders can be quoted first (place_order false returns 202 with the final quote) and placed in a second call", "Seventeen Create Order errors are listed with their status codes, and each endpoint page documents 400, 401 and 429" ], "weaknesses": [ "One key with no scopes, read-only mode, expiry or rotation documented, sent in a custom Id-Token header", "No status page, SLA or rate limit figures; the 429 schema shows only an example message", "No idempotency key on Create Order, so a retried call can place a second order", "A card is required before any call, and there is no free tier or trial", "The newest release note is dated 6 May 2025, and the API and SDK terms of 18 June 2022 license use for personal, noncommercial purposes" ], "agentNotes": [ "Send the key as the Id-Token header, not Authorization. Only latitude and longitude are required for store search; address fields become required when fetch_quotes is true and pickup is false", "Call Create Order with place_order false first, read the 202 final quote, then place it; keep your own customer_order_id and look it up before any retry, since no idempotency key exists", "Set projections on store search to the fields you need; fetch_quotes greatly increases response time per the docs", "Keep use_new_db the same across store search, Get Inventory and Get MealMe Store, or the store ids will not match", "Treat 406 (store closed, out of range, no delivery), 420 (product unavailable) and 422 (checkout error) as fixes to make, not transient failures" ], "metrics": { "kind": "remote", "measured": false }, "reviewCount": 0, "avgRating": 0, "history": [ { "basis": "public evidence", "confidence": "medium", "grade": "E", "methodology": "0.7", "pending": [ "performance", "tasks" ], "run": "2026-10-01", "runLabel": "October 2026 research run", "score": 38.4 } ], "editorialScores": { "ergonomics": 69, "maintenance": 6, "payments": 20, "reliability": 19, "schema": 72, "security": 26, "transparency": 35 }, "provenanceScore": 59, "checked": { "categories": { "ergonomics": "2026-11-03", "maintenance": "2026-11-03", "payments": "2026-11-03", "reliability": "2026-11-03", "schema": "2026-11-03", "security": "2026-11-03", "transparency": "2026-11-03" }, "last": "2026-11-03", "oldest": "2026-11-03", "stale": false, "staleAfterDays": 90 } }, "connect": { "http": "curl 'https://api.mealme.ai/search/store/v3?latitude=37.7786357\u0026longitude=-122.3918135\u0026store_type=grocery' -H 'Id-Token: YOUR_API_KEY'" }, "letme": { "capability": "https://letme.dev/shopping.search", "tool": "https://letme.dev/mealme" }, "alsoIn": [ "cooking" ], "area": "everyday", "unitPrices": [ { "item": "Successful API call, Developer plan", "unit": "call", "usd": 0.1, "note": "No monthly minimum, invoiced daily; https://mealmeai.vercel.app/pricing" }, { "item": "Unlimited plan", "unit": "month", "usd": 250, "note": "Unlimited successful calls, cancel any time" } ], "provenance": { "legalEntity": "MealMe, Inc.", "domain": "mealme.ai", "domainRegistered": "", "endpointOnVendorDomain": true, "terms": "https://www.mealme.ai/privacy", "privacy": "https://www.mealme.ai/privacy", "statusPage": "", "changelog": "https://docs.mealme.ai/reference/release-notes", "securityTxt": "none", "checked": "2026-11-03", "notes": [ "One page at mealme.ai/privacy holds the MealMe Connect Terms of Service (4 April 2025), the Privacy Policy (1 January 2025), the API and SDK Terms of Use (18 June 2022) and the Cookie Policy (1 January 2020). All name MealMe, Inc.; the Connect terms give a Wilmington, Delaware address and the API terms a Scottdale, Georgia notice address.", "The API and SDK terms forbid any robot, spider, scraper or other automatic or manual means to access the services or copy content, and the Connect terms forbid automated data extraction without written permission. Recorded as a fact; public pages were read within robots.txt.", "www.mealme.ai/robots.txt allows all crawlers except URLs with ?lightbox=; docs.mealme.ai/robots.txt allows all except /api-next, /edit/, /login and /logout, and points to mealmeapi.readme.io/llms.txt.", "The dashboard, signup and pricing pages are served from mealmeai.vercel.app, not mealme.ai.", "/.well-known/security.txt on www.mealme.ai returns 400. No status page found; status.mealme.ai does not resolve.", "RDAP for mealme.ai (rdap.nic.ai) returned no readable record, so no registration date is recorded." ], "score": 59 }, "pageJsonUrl": "https://www.anchorterminal.com/tools/mealme.json", "live": { "slug": "mealme", "securityTxt": { "url": "https://mealme.ai/.well-known/security.txt", "state": "unknown", "checkedAt": "2026-11-04T15:53:11.510847421Z" }, "updatedAt": "2026-11-04T15:53:11.510847421Z" } }, "answer": "Shop MCP scores 61.8 (C) on agent readiness against MealMe API's 38.4 (E), and leads in every scored category.", "b": { "slug": "shop-mcp", "name": "Shop MCP", "vendor": "Shopify", "vendorUrl": "https://shop.dev/", "kind": "mcp", "category": "shopping", "summary": "Shop MCP is Shopify's hosted MCP server for shopper-side agents. It searches Shopify's Global Catalog, builds carts and checkouts at the selling store, and with the shopper's Shop sign-in pays with Shop Pay and reads their orders.", "url": "https://www.anchorterminal.com/tools/shop-mcp", "markdownUrl": "https://www.anchorterminal.com/tools/shop-mcp.md", "slimMarkdownUrl": "https://www.anchorterminal.com/tools/shop-mcp.min.md", "jsonUrl": "https://www.anchorterminal.com/api/v1/tools/shop-mcp.json", "dns": "shop-mcp.grade.anchorterminal.com", "repo": "https://github.com/Shopify/shop", "license": "Proprietary hosted service under the Shopify API Terms. The shop CLI package is MIT, with its core shipped as a compiled WebAssembly file", "transports": [ "streamable-http" ], "remoteUrl": "https://mcp.shop.com/", "packages": [ { "registry": "npm", "name": "@shopify/shop" } ], "auth": "mixed", "authNotes": "Ten tools (catalogue search, carts and checkout, including complete_checkout) run with no credential. get_account, search_orders and the five spend request tools need a Shop OAuth 2.0 access token with the personal_agent scope from https://accounts.shop.app, sent only as a Bearer header. Code without an MCP client can use the device flow with Shop's public client ID, or authorisation code with PKCE, and revoke tokens at /oauth/revoke (https://shop.dev/docs/authentication.md).", "pricing": "free", "pricingNotes": "Free. shop.dev answers \"Is it free? Yes. Search needs no account or key.\" Purchases are paid by the shopper to the merchant, with Shop Pay or a saved card. A commission programme, Promoted Placements, is in early access behind a waitlist. The Shopify API Terms allow fees for previously free functions (https://shop.dev/, https://www.shopify.com/legal/api-terms, checked 17 October 2026).", "priceSummary": "Free", "where": "hosted", "x402": { "level": "no", "evidence": "No x402, MPP or L402 in the Shop MCP docs or the tool list served on 17 October 2026. Payment runs through Shop Pay instruments listed in the checkout, or a single-use card issued after the shopper approves a spend request.", "endpoints": [] }, "toolCount": 19, "popularity": { "githubStars": null, "npmWeekly": 570, "pypiWeekly": null, "asOf": "2026-10-17" }, "docsUrl": "https://shop.dev/docs", "capabilities": [ "shopping.search", "shopping.prices", "commerce.cart", "commerce.checkout", "shopping.orders", "payments.card-token", "wallet.spend-limits" ], "tags": [ "hosted", "mcp", "oauth", "keyless", "closed-source", "bug-bounty" ], "lastRelease": "2026-10-28", "graded": true, "anchor": { "graded": true, "score": 61.8, "grade": "C", "agentReady": false, "rank": 533, "ranked": true, "rankOf": 1349, "categoryRank": 2, "methodology": "0.7", "run": "2026-10-01", "scores": { "ergonomics": 79, "maintenance": 66, "payments": 55, "reliability": 33, "schema": 89, "security": 74, "transparency": 61 }, "pending": [ "performance", "tasks" ], "assessment": { "confidence": "medium", "date": "2026-11-01" }, "negative": -3, "negativeNotes": [ "Between 17 and 28 October 2026 (server 1.1.1 to 1.2.0+aebf0c1b9130, CLI tag v1.2.0 on 28 October). Shop MCP changed three published tool behaviours with no notice found in the Shopify developer changelog or on shop.dev, which has no changelog. get_spend_request now returns the issued card only when `include: \"card\"` is sent, where the 17 October docs had `shop spend-request get --wait 90` return it. get_account replaced the Shop Pay budget under `payment.instruments[].display` with `spend_permissions`. search_orders now returns in-progress orders by default. The 28 October tag commit lists these under `Upgrading`, guidance given on the release day rather than notice. A 1.x minor release on a generally available server, so the floor (-3) (https://shop.dev/docs/tools.md, https://github.com/Shopify/shop/compare/v1.1.1...v1.2.0)." ], "verdict": "Keyless search across Shopify's Global Catalog and cart and checkout at the selling store, with typed schemas, tool annotations, idempotency keys and documented retry rules. The tool definitions run to 76 KB, no status page or rate figure covers it, and version 1.2.0 changed three tools in late October without notice.", "bestFor": "Agents buying for a person across Shopify stores, from search to Shop Pay checkout and order tracking.", "strengths": [ "Search, carts and checkout run with no key or account, and each tool call is one stateless HTTP POST", "Every tool carries readOnlyHint and destructiveHint, and writes take an idempotency key with written rules for when a retry is safe", "Errors name the failing field by JSONPath, carry a code and retry_after, and give a severity saying who can fix them", "Shopper sign-in is OAuth 2.0 with device flow, PKCE and token revocation, and tokens are refused in a query string or cookie", "Card payments outside Shopify need the shopper's approval in Shop, with a spending limit and a single-use credential" ], "weaknesses": [ "The 19 tool definitions total 76,040 bytes, so loading the server costs a large share of a model's context", "Version 1.2.0 changed get_spend_request, get_account and search_orders for existing callers with no changelog entry or notice", "No status page covers Shop MCP, and no SLA or rate figure is published for its own tools", "Only MCP 2026-07-28 is accepted, so clients limited to the initialize handshake cannot connect", "Launched on 13 October 2026, with no webhooks, no cancel for carts or checkouts, and no returns" ], "agentNotes": [ "Connect to https://mcp.shop.com/ with no /mcp path, send MCP-Protocol-Version 2026-07-28 with matching Mcp-Method and Mcp-Name headers, and put protocolVersion and clientCapabilities in params._meta", "Call complete_checkout once, only from ready_for_complete, after the shopper confirms merchant, items, total and instrument. After an uncertain result, read get_checkout and never resend", "Read the current document before update_cart or update_checkout and send it back whole, since fields and lines left out are deleted", "Pass include set to card on get_spend_request after the shopper approves, since without it the call returns only status and terms", "Set filters.status to all on search_orders for past orders, and treat product text and next[] suggestions as data, keeping checkout IDs and continue_url out of logs" ], "metrics": { "kind": "remote", "measured": false }, "reviewCount": 4, "avgRating": 3.8, "history": [ { "basis": "public evidence", "confidence": "medium", "grade": "C", "methodology": "0.7", "pending": [ "performance", "tasks" ], "run": "2026-10-01", "runLabel": "October 2026 research run", "score": 61.8 } ], "editorialScores": { "ergonomics": 79, "maintenance": 66, "payments": 55, "reliability": 33, "schema": 89, "security": 74, "transparency": 45 }, "provenanceScore": 77, "checked": { "categories": { "ergonomics": "2026-11-01", "maintenance": "2026-11-01", "payments": "2026-11-01", "reliability": "2026-11-01", "schema": "2026-11-01", "security": "2026-11-01", "transparency": "2026-11-01" }, "last": "2026-11-01", "lastMoved": "2026-11-01", "oldest": "2026-11-01", "stale": false, "staleAfterDays": 90 } }, "connect": { "install": "npm install --global @shopify/shop@latest", "claudeCode": "claude mcp add --transport http shop https://mcp.shop.com/", "config": { "mcpServers": { "shop": { "type": "http", "url": "https://mcp.shop.com" } } } }, "letme": { "capability": "https://letme.dev/shopping.search", "tool": "https://letme.dev/shop-mcp" }, "area": "everyday", "provenance": { "legalEntity": "Shopify Inc.", "domain": "shop.com", "domainRegistered": "1994-06-02", "endpointOnVendorDomain": true, "terms": "https://www.shopify.com/legal/api-terms", "privacy": "https://www.shopify.com/legal/privacy/consumers", "statusPage": "", "changelog": "https://shopify.dev/changelog", "securityTxt": "unknown", "checked": "2026-11-01", "notes": [ "shop.dev's footer links the Shopify API Terms, an agreement with Shopify Inc. last updated 7 October 2026. https://shop.app/privacy-policy redirects to Shopify's consumer privacy policy, last updated 2 March 2026.", "RDAP gives shop.com a registration date of 2 June 1994, registrar MarkMonitor. shop.com's robots.txt is headed \"Shopify robots policy (shop.com)\".", "mcp.shop.com/.well-known/security.txt returned 404, and shop.com answered 429 with a bot classification, so it wasn't read. www.shopify.com's security.txt names HackerOne, security@shopify.com and a PGP key, with no Expires field.", "shopifystatus.com, re-read on 1 November, lists Admin, Checkout, Reports and Dashboards, Storefront, API \u0026 Mobile, Third party services, Support, Point of Sale and Oxygen, with no component for Shop, Shop MCP or the Catalog, so no status page is recorded.", "Shop MCP has no changelog of its own. Its launch is in the Shopify developer changelog, which has no later Shop MCP post on 1 November, and the CLI's releases are tags in https://github.com/Shopify/shop." ], "score": 77 }, "pageJsonUrl": "https://www.anchorterminal.com/tools/shop-mcp.json", "live": { "slug": "shop-mcp", "probe": { "target": "https://mcp.shop.com/", "method": "mcp-initialize", "lastAt": "2026-11-04T21:28:12.765034514Z", "lastOk": true, "lastStatus": 200, "lastMs": 202, "lastNote": "answered, but not with an initialize result", "authRequired": false, "uptime24h": 100, "uptime30d": 100, "p50ms24h": 162, "p95ms24h": 353, "samples24h": 246, "samples30d": 4507, "days": [ { "date": "2026-10-17", "probes": 21, "ok": 21 }, { "date": "2026-10-18", "probes": 256, "ok": 256 }, { "date": "2026-10-19", "probes": 255, "ok": 255 }, { "date": "2026-10-20", "probes": 252, "ok": 252 }, { "date": "2026-10-21", "probes": 253, "ok": 253 }, { "date": "2026-10-22", "probes": 253, "ok": 253 }, { "date": "2026-10-23", "probes": 248, "ok": 248 }, { "date": "2026-10-24", "probes": 251, "ok": 251 }, { "date": "2026-10-25", "probes": 250, "ok": 250 }, { "date": "2026-10-26", "probes": 252, "ok": 252 }, { "date": "2026-10-27", "probes": 249, "ok": 249 }, { "date": "2026-10-28", "probes": 250, "ok": 250 }, { "date": "2026-10-29", "probes": 249, "ok": 249 }, { "date": "2026-10-30", "probes": 249, "ok": 249 }, { "date": "2026-10-31", "probes": 251, "ok": 251 }, { "date": "2026-11-01", "probes": 249, "ok": 249 }, { "date": "2026-11-02", "probes": 250, "ok": 250 }, { "date": "2026-11-03", "probes": 248, "ok": 248 }, { "date": "2026-11-04", "probes": 221, "ok": 221 } ] }, "versions": [ { "registry": "github", "name": "Shopify/shop", "version": "v1.2.0", "released": "2026-10-28", "seenAt": "2026-11-04T20:54:53.728244519Z" }, { "registry": "npm", "name": "@shopify/shop", "version": "1.2.0", "seenAt": "2026-11-04T20:54:50.707562205Z" } ], "githubStars": 11, "npmWeekly": 675, "securityTxt": { "url": "https://shop.com/.well-known/security.txt", "state": "unknown", "checkedAt": "2026-11-04T15:53:14.535007491Z" }, "domain": { "domain": "shop.com", "registered": "1994-06-02", "source": "https://rdap.verisign.com/com/v1/domain/shop.com", "checkedAt": "2026-11-01T14:14:54.439296337Z" }, "pages": [ { "url": "https://shopify.dev/changelog", "kind": "changelog", "status": 200, "checkedAt": "2026-11-04T08:32:42.055671155Z", "changedAt": "2026-11-04T08:32:42.055671155Z", "fingerprint": "eac22181240e" }, { "url": "https://www.shopify.com/legal/privacy/consumers", "kind": "privacy", "status": 200, "checkedAt": "2026-11-04T08:45:21.33312257Z", "changedAt": "2026-11-03T08:11:06.067016888Z", "fingerprint": "0b8a2c28a40c" }, { "url": "https://www.shopify.com/legal/api-terms", "kind": "terms", "status": 200, "checkedAt": "2026-11-04T08:45:17.132021972Z", "changedAt": "2026-11-03T08:11:01.920117802Z", "fingerprint": "ff9f38db33b1" } ], "mcpTools": { "url": "https://mcp.shop.com/", "checkedAt": "2026-11-04T01:23:02.827525226Z", "status": "ok", "protocol": "2026-07-28", "tools": [ { "name": "create_checkout", "description": "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: get/update its ID. Address incomplete via update. Complete ready_for_complete only after buyer approval. Creates no order.", "inputSchema": { "$defs": { "d0": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": true, "name": "dev.ucp.shopping.checkout", "properties": { "buyer": { "additionalProperties": true, "properties": { "email": { "type": "string" }, "first_name": { "type": "string" }, "last_name": { "type": "string" }, "phone_number": { "description": "Buyer phone in E.164.", "type": "string" } }, "title": "Buyer", "type": "object" }, "context": { "additionalProperties": true, "allOf": [ { "additionalProperties": true, "description": "Coarse locality; not an address.", "properties": { "address_country": { "description": "ISO 3166-1 alpha-2, e.g. US.", "type": "string" }, "address_region": { "type": "string" }, "postal_code": { "type": "string" } }, "title": "Locality", "type": "object" }, { "additionalProperties": true, "properties": { "currency": { "description": "ISO 4217 preference/filter currency; verify output.", "type": "string" }, "eligibility": { "description": "Nonidentifying reverse-domain benefits; ignore unknowns.", "items": { "$ref": "#/$defs/d10" }, "type": "array", "uniqueItems": true }, "intent": { "description": "Relevance hint, e.g. 'gift under $50'.", "type": "string" }, "language": { "description": "BCP 47 preference, e.g. fr-CA.", "type": "string" }, "location": { "description": "Opaque merchant location ID, not locality.", "type": "string" }, "payment": { "description": "Advertised handlers, most preferred first; ignore unknowns.", "items": { "properties": { "handler": { "allOf": [ { "$ref": "#/$defs/d10" } ], "description": "Merchant ucp.payment_handlers key." }, "types": { "description": "Instrument types, most preferred first; ignore unknowns.", "items": { "type": "string" }, "type": "array" } }, "required": [ "handler" ], "type": "object" }, "type": "array" } }, "type": "object" } ], "description": "Soft relevance/localization; checkout wins.", "title": "Context", "type": "object" }, "line_items": { "description": "On update send every line; omissions delete, never merge.", "items": { "description": "Uses parent cart/checkout currency.", "properties": { "item": { "properties": { "id": { "description": "Copy exact returned variant ID; never rebuild/truncate.", "type": "string" }, "quantity_unit": { "allOf": [ { "allOf": [ { "if": { "properties": { "unit": { "const": "C62" } }, "required": [ "unit" ] }, "properties": { "display_text": { "description": "Printable label for unrecognized units.", "type": "string" }, "scale": { "default": 0, "description": "One step = 10^-scale units; omitted=0; C62 needs 0.", "maximum": 15, "minimum": 0, "type": "integer" }, "unit": { "description": "UN/CEFACT Rec 20 code, else stable opaque custom ID.", "type": "string" } }, "required": [ "unit", "display_text" ], "then": { "properties": { "scale": { "const": 0 } } }, "title": "Unit", "type": "object" }, { "properties": { "increment": { "default": 1, "description": "Step multiple (default 1); merchant may revise/reject, never reinterpret.", "minimum": 1, "type": "integer" } }, "type": "object" } ], "description": "Sale basis is unit+scale, not display_text/increment.", "title": "Quantity Unit" } ], "description": "Omit for merchant basis; else assert unit/scale. C62/0 = each." } }, "required": [ "id" ], "title": "Item", "type": "object" }, "quantity": { "description": "Integer sale-basis steps; missing quantity_unit is not each.", "maximum": 9007199254740991, "minimum": 1, "type": "integer" } }, "required": [ "item", "quantity" ], "title": "Line Item", "type": "object" }, "type": "array" }, "payment": { "$schema": "https://json-schema.org/draft/2020-12/schema", "description": "Only after shopper selects an instrument.", "properties": { "instruments": { "items": { "allOf": [ { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": true, "properties": { "billing_address": { "properties": { "address_country": { "$ref": "#/$defs/d1" }, "address_locality": { "$ref": "#/$defs/d2" }, "address_region": { "$ref": "#/$defs/d3" }, "extended_address": { "$ref": "#/$defs/d4" }, "first_name": { "$ref": "#/$defs/d5" }, "last_name": { "$ref": "#/$defs/d6" }, "phone_number": { "$ref": "#/$defs/d7" }, "postal_code": { "$ref": "#/$defs/d8" }, "street_address": { "$ref": "#/$defs/d9" } }, "title": "Postal Address", "type": "object" }, "credential": { "additionalProperties": true, "description": "Shape defined by the handler.", "properties": { "type": { "description": "Type the handler requires.", "type": "string" } }, "required": [ "type" ], "title": "Payment Credential", "type": "object" }, "display": { "type": "object" }, "handler_id": { "description": "Merchant-advertised handler ID.", "type": "string" }, "id": { "description": "Opaque; never reuse across merchants.", "type": "string" }, "type": { "description": "Handler category, e.g. card.", "type": "string" } }, "required": [ "id", "handler_id", "type" ], "title": "Payment Instrument", "type": "object" }, { "properties": { "selected": { "description": "True only on the one shopper-approved instrument.", "type": "boolean" } }, "type": "object" } ], "title": "Selected Payment Instrument" }, "type": "array" } }, "title": "Payment", "type": "object" }, "signals": { "additionalProperties": true, "description": "Observed/verified platform facts; no buyer claims.", "properties": { "dev.ucp.buyer_ip": { "type": "string" }, "dev.ucp.user_agent": { "type": "string" } }, "propertyNames": { "allOf": [ { "$ref": "#/$defs/d10" } ] }, "title": "Signals", "type": "object" } }, "required": [ "line_items" ], "title": "Checkout", "type": "object", "version": "2026-08-25" }, "d1": { "description": "ISO 3166-1 alpha-2, e.g. US.", "type": "string" }, "d10": { "description": "Reverse domain, 2+ segments.", "examples": [ "dev.ucp.shopping.checkout", "dev.ucp.common.identity_linking", "com.example.loyalty_gold", "com.example-shop.checkout", "com.2example.cart", "uk.co.example-shop.checkout", "xn--p1ai.example.checkout" ], "pattern": "^[a-z](?:[a-z0-9-]*[a-z0-9])?(?:\\.[a-z0-9](?:[a-z0-9_-]*[a-z0-9_])?)+$", "title": "Reverse Domain Name", "type": "string" }, "d2": { "type": "string" }, "d3": { "type": "string" }, "d4": { "type": "string" }, "d5": { "type": "string" }, "d6": { "type": "string" }, "d7": { "type": "string" }, "d8": { "type": "string" }, "d9": { "type": "string" } }, "properties": { "checkout": { "allOf": [ { "allOf": [ { "$ref": "#/$defs/d0" }, { "properties": { "discounts": { "properties": { "codes": { "description": "Replace case-insensitively; [] clears all.", "items": { "type": "string" }, "type": "array" } }, "type": "object" } }, "type": "object" } ], "title": "Checkout with Discount" }, { "allOf": [ { "$ref": "#/$defs/d0" }, { "properties": { "fulfillment": { "allOf": [ { "properties": { "methods": { "description": "Methods covering the checkout's line items.", "items": { "allOf": [ { "if": { "properties": { "type": { "const": "shipping" } }, "required": [ "type" ] }, "then": { "properties": { "destinations": { "description": "Platform-authored shipping addresses.", "items": { "allOf": [ { "properties": { "address_country": { "$ref": "#/$defs/d1" }, "address_locality": { "$ref": "#/$defs/d2" }, "address_region": { "$ref": "#/$defs/d3" }, "extended_address": { "$ref": "#/$defs/d4" }, "first_name": { "$ref": "#/$defs/d5" }, "last_name": { "$ref": "#/$defs/d6" }, "phone_number": { "$ref": "#/$defs/d7" }, "postal_code": { "$ref": "#/$defs/d8" }, "street_address": { "$ref": "#/$defs/d9" } }, "title": "Postal Address", "type": "object" }, { "properties": { "id": { "description": "Platform-assigned ID for this address.", "type": "string" }, "type": { "const": "shipping_address", "type": "string" } }, "required": [], "type": "object" } ], "title": "Shipping Destination", "type": "object" }, "type": "array" } } } }, { "if": { "properties": { "type": { "const": "pickup" } }, "required": [ "type" ] }, "then": { "properties": {} } } ], "dependentRequired": { "destinations": [ "type" ] }, "properties": { "groups": { "description": "Merchant groups; select returned options.", "items": { "additionalProperties": true, "properties": { "selected_option_id": { "description": "Option ID returned for this group.", "type": [ "string", "null" ] } }, "required": [], "title": "Fulfillment Group", "type": "object" }, "type": "array" }, "selected_destination_id": { "description": "Merchant-scoped; need not be returned.", "type": [ "string", "null" ] }, "type": { "description": "Shipping, pickup, or another supported type.", "type": "string" } }, "required": [ "type" ], "title": "Fulfillment Method", "type": "object" }, "type": "array" } }, "title": "Fulfillment", "type": "object" } ] } }, "type": "object" } ], "title": "Checkout with Fulfillment" }, { "not": { "required": [ "attribution" ] } } ], "type": "object" }, "meta": { "properties": { "idempotency-key": { "description": "UUID for one write; reuse for exact retries. complete_checkout derives if omitted.", "format": "uuid", "type": "string" } }, "type": "object" }, "shop": { "description": "Exact seller.domain storefront hostname from offer; no scheme/path; one seller per cart/checkout.", "minLength": 1, "type": "string" } }, "required": [ "checkout", "shop" ], "type": "object" }, "annotations": { "destructiveHint": true, "idempotentHint": false, "openWorldHint": true, "readOnlyHint": false } }, { "name": "get_checkout", "description": "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.", "inputSchema": { "properties": { "id": { "type": "string" }, "shop": { "description": "Exact seller.domain storefront hostname from offer; no scheme/path; one seller per cart/checkout.", "minLength": 1, "type": "string" } }, "required": [ "id", "shop" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": true, "readOnlyHint": true } }, { "name": "update_checkout", "description": "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 status/messages/continue_url. After uncertainty, read before retry.", "inputSchema": { "$defs": { "d0": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": true, "name": "dev.ucp.shopping.checkout", "properties": { "buyer": { "additionalProperties": true, "properties": { "email": { "type": "string" }, "first_name": { "type": "string" }, "last_name": { "type": "string" }, "phone_number": { "description": "Buyer phone in E.164.", "type": "string" } }, "title": "Buyer", "type": "object" }, "context": { "additionalProperties": true, "allOf": [ { "additionalProperties": true, "description": "Coarse locality; not an address.", "properties": { "address_country": { "description": "ISO 3166-1 alpha-2, e.g. US.", "type": "string" }, "address_region": { "type": "string" }, "postal_code": { "type": "string" } }, "title": "Locality", "type": "object" }, { "additionalProperties": true, "properties": { "currency": { "description": "ISO 4217 preference/filter currency; verify output.", "type": "string" }, "eligibility": { "description": "Nonidentifying reverse-domain benefits; ignore unknowns.", "items": { "$ref": "#/$defs/d10" }, "type": "array", "uniqueItems": true }, "intent": { "description": "Relevance hint, e.g. 'gift under $50'.", "type": "string" }, "language": { "description": "BCP 47 preference, e.g. fr-CA.", "type": "string" }, "location": { "description": "Opaque merchant location ID, not locality.", "type": "string" }, "payment": { "description": "Advertised handlers, most preferred first; ignore unknowns.", "items": { "properties": { "handler": { "allOf": [ { "$ref": "#/$defs/d10" } ], "description": "Merchant ucp.payment_handlers key." }, "types": { "description": "Instrument types, most preferred first; ignore unknowns.", "items": { "type": "string" }, "type": "array" } }, "required": [ "handler" ], "type": "object" }, "type": "array" } }, "type": "object" } ], "description": "Soft relevance/localization; checkout wins.", "title": "Context", "type": "object" }, "line_items": { "description": "On update send every line; omissions delete, never merge.", "items": { "description": "Uses parent cart/checkout currency.", "properties": { "id": { "type": "string" }, "item": { "properties": { "id": { "description": "Copy exact returned variant ID; never rebuild/truncate.", "type": "string" }, "quantity_unit": { "allOf": [ { "allOf": [ { "if": { "properties": { "unit": { "const": "C62" } }, "required": [ "unit" ] }, "properties": { "display_text": { "description": "Printable label for unrecognized units.", "type": "string" }, "scale": { "default": 0, "description": "One step = 10^-scale units; omitted=0; C62 needs 0.", "maximum": 15, "minimum": 0, "type": "integer" }, "unit": { "description": "UN/CEFACT Rec 20 code, else stable opaque custom ID.", "type": "string" } }, "required": [ "unit", "display_text" ], "then": { "properties": { "scale": { "const": 0 } } }, "title": "Unit", "type": "object" }, { "properties": { "increment": { "default": 1, "description": "Step multiple (default 1); merchant may revise/reject, never reinterpret.", "minimum": 1, "type": "integer" } }, "type": "object" } ], "description": "Sale basis is unit+scale, not display_text/increment.", "title": "Quantity Unit" } ], "description": "Omit for merchant basis; else assert unit/scale. C62/0 = each." } }, "required": [ "id" ], "title": "Item", "type": "object" }, "parent_id": { "description": "Copy returned parent line ID unchanged.", "type": "string" }, "quantity": { "description": "Integer sale-basis steps; missing quantity_unit is not each.", "maximum": 9007199254740991, "minimum": 1, "type": "integer" } }, "required": [ "item", "quantity" ], "title": "Line Item", "type": "object" }, "type": "array" }, "payment": { "$schema": "https://json-schema.org/draft/2020-12/schema", "description": "Only after shopper selects an instrument.", "properties": { "instruments": { "items": { "allOf": [ { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": true, "properties": { "billing_address": { "properties": { "address_country": { "$ref": "#/$defs/d1" }, "address_locality": { "$ref": "#/$defs/d2" }, "address_region": { "$ref": "#/$defs/d3" }, "extended_address": { "$ref": "#/$defs/d4" }, "first_name": { "$ref": "#/$defs/d5" }, "last_name": { "$ref": "#/$defs/d6" }, "phone_number": { "$ref": "#/$defs/d7" }, "postal_code": { "$ref": "#/$defs/d8" }, "street_address": { "$ref": "#/$defs/d9" } }, "title": "Postal Address", "type": "object" }, "credential": { "additionalProperties": true, "description": "Shape defined by the handler.", "properties": { "type": { "description": "Type the handler requires.", "type": "string" } }, "required": [ "type" ], "title": "Payment Credential", "type": "object" }, "display": { "type": "object" }, "handler_id": { "description": "Merchant-advertised handler ID.", "type": "string" }, "id": { "description": "Opaque; never reuse across merchants.", "type": "string" }, "type": { "description": "Handler category, e.g. card.", "type": "string" } }, "required": [ "id", "handler_id", "type" ], "title": "Payment Instrument", "type": "object" }, { "properties": { "selected": { "description": "True only on the one shopper-approved instrument.", "type": "boolean" } }, "type": "object" } ], "title": "Selected Payment Instrument" }, "type": "array" } }, "title": "Payment", "type": "object" }, "signals": { "additionalProperties": true, "description": "Observed/verified platform facts; no buyer claims.", "properties": { "dev.ucp.buyer_ip": { "type": "string" }, "dev.ucp.user_agent": { "type": "string" } }, "propertyNames": { "allOf": [ { "$ref": "#/$defs/d10" } ] }, "title": "Signals", "type": "object" } }, "required": [ "line_items" ], "title": "Checkout", "type": "object", "version": "2026-08-25" }, "d1": { "description": "ISO 3166-1 alpha-2, e.g. US.", "type": "string" }, "d10": { "description": "Reverse domain, 2+ segments.", "examples": [ "dev.ucp.shopping.checkout", "dev.ucp.common.identity_linking", "com.example.loyalty_gold", "com.example-shop.checkout", "com.2example.cart", "uk.co.example-shop.checkout", "xn--p1ai.example.checkout" ], "pattern": "^[a-z](?:[a-z0-9-]*[a-z0-9])?(?:\\.[a-z0-9](?:[a-z0-9_-]*[a-z0-9_])?)+$", "title": "Reverse Domain Name", "type": "string" }, "d2": { "type": "string" }, "d3": { "type": "string" }, "d4": { "type": "string" }, "d5": { "type": "string" }, "d6": { "type": "string" }, "d7": { "type": "string" }, "d8": { "type": "string" }, "d9": { "type": "string" } }, "properties": { "checkout": { "allOf": [ { "allOf": [ { "$ref": "#/$defs/d0" }, { "properties": { "discounts": { "properties": { "codes": { "description": "Replace case-insensitively; [] clears all.", "items": { "type": "string" }, "type": "array" } }, "type": "object" } }, "type": "object" } ], "title": "Checkout with Discount" }, { "allOf": [ { "$ref": "#/$defs/d0" }, { "properties": { "fulfillment": { "allOf": [ { "properties": { "methods": { "description": "Methods covering the checkout's line items.", "items": { "allOf": [ { "if": { "properties": { "type": { "const": "shipping" } }, "required": [ "type" ] }, "then": { "properties": { "destinations": { "description": "Platform-authored shipping addresses.", "items": { "allOf": [ { "properties": { "address_country": { "$ref": "#/$defs/d1" }, "address_locality": { "$ref": "#/$defs/d2" }, "address_region": { "$ref": "#/$defs/d3" }, "extended_address": { "$ref": "#/$defs/d4" }, "first_name": { "$ref": "#/$defs/d5" }, "last_name": { "$ref": "#/$defs/d6" }, "phone_number": { "$ref": "#/$defs/d7" }, "postal_code": { "$ref": "#/$defs/d8" }, "street_address": { "$ref": "#/$defs/d9" } }, "title": "Postal Address", "type": "object" }, { "properties": { "id": { "description": "Platform-assigned ID for this address.", "type": "string" }, "type": { "const": "shipping_address", "type": "string" } }, "required": [], "type": "object" } ], "title": "Shipping Destination", "type": "object" }, "type": "array" } } } }, { "if": { "properties": { "type": { "const": "pickup" } }, "required": [ "type" ] }, "then": { "properties": {} } } ], "dependentRequired": { "destinations": [ "type" ] }, "properties": { "groups": { "description": "Merchant groups; select returned options.", "items": { "additionalProperties": true, "properties": { "id": { "description": "On update, merchant-returned group ID.", "type": "string" }, "selected_option_id": { "description": "Option ID returned for this group.", "type": [ "string", "null" ] } }, "required": [ "id" ], "title": "Fulfillment Group", "type": "object" }, "type": "array" }, "id": { "description": "On update, merchant-returned method ID.", "type": "string" }, "line_item_ids": { "description": "On update, returned line IDs fulfilled by this method.", "items": { "type": "string" }, "type": "array" }, "selected_destination_id": { "description": "Merchant-scoped; need not be returned.", "type": [ "string", "null" ] }, "type": { "description": "Shipping, pickup, or another supported type.", "type": "string" } }, "required": [ "line_item_ids" ], "title": "Fulfillment Method", "type": "object" }, "type": "array" } }, "title": "Fulfillment", "type": "object" } ] } }, "type": "object" } ], "title": "Checkout with Fulfillment" }, { "not": { "required": [ "attribution" ] } } ], "type": "object" }, "id": { "type": "string" }, "meta": { "properties": { "idempotency-key": { "description": "UUID for one write; reuse for exact retries. complete_checkout derives if omitted.", "format": "uuid", "type": "string" } }, "type": "object" }, "shop": { "description": "Exact seller.domain storefront hostname from offer; no scheme/path; one seller per cart/checkout.", "minLength": 1, "type": "string" } }, "required": [ "id", "checkout", "shop" ], "type": "object" }, "annotations": { "destructiveHint": true, "idempotentHint": false, "openWorldHint": true, "readOnlyHint": false } }, { "name": "complete_checkout", "description": "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 start a replacement purchase.", "inputSchema": { "$defs": { "d0": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": true, "name": "dev.ucp.shopping.checkout", "properties": { "payment": { "$schema": "https://json-schema.org/draft/2020-12/schema", "description": "Only after shopper selects an instrument.", "properties": { "instruments": { "items": { "allOf": [ { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": true, "properties": { "billing_address": { "properties": { "address_country": { "description": "ISO 3166-1 alpha-2, e.g. US.", "type": "string" }, "address_locality": { "type": "string" }, "address_region": { "type": "string" }, "extended_address": { "type": "string" }, "first_name": { "type": "string" }, "last_name": { "type": "string" }, "phone_number": { "type": "string" }, "postal_code": { "type": "string" }, "street_address": { "type": "string" } }, "title": "Postal Address", "type": "object" }, "credential": { "additionalProperties": true, "description": "Shape defined by the handler.", "properties": { "type": { "description": "Type the handler requires.", "type": "string" } }, "required": [ "type" ], "title": "Payment Credential", "type": "object" }, "display": { "type": "object" }, "handler_id": { "description": "Merchant-advertised handler ID.", "type": "string" }, "id": { "description": "Opaque; never reuse across merchants.", "type": "string" }, "type": { "description": "Handler category, e.g. card.", "type": "string" } }, "required": [ "id", "handler_id", "type" ], "title": "Payment Instrument", "type": "object" }, { "properties": { "selected": { "description": "True only on the one shopper-approved instrument.", "type": "boolean" } }, "type": "object" } ], "title": "Selected Payment Instrument" }, "type": "array" } }, "title": "Payment", "type": "object" }, "signals": { "additionalProperties": true, "description": "Observed/verified platform facts; no buyer claims.", "properties": { "dev.ucp.buyer_ip": { "type": "string" }, "dev.ucp.user_agent": { "type": "string" } }, "propertyNames": { "allOf": [ { "description": "Reverse domain, 2+ segments.", "examples": [ "dev.ucp.shopping.checkout", "dev.ucp.common.identity_linking", "com.example.loyalty_gold", "com.example-shop.checkout", "com.2example.cart", "uk.co.example-shop.checkout", "xn--p1ai.example.checkout" ], "pattern": "^[a-z](?:[a-z0-9-]*[a-z0-9])?(?:\\.[a-z0-9](?:[a-z0-9_-]*[a-z0-9_])?)+$", "title": "Reverse Domain Name", "type": "string" } ] }, "title": "Signals", "type": "object" } }, "required": [ "payment" ], "title": "Checkout", "type": "object", "version": "2026-08-25" } }, "properties": { "checkout": { "allOf": [ { "allOf": [ { "$ref": "#/$defs/d0" }, { "properties": {}, "type": "object" } ], "title": "Checkout with Discount" }, { "allOf": [ { "$ref": "#/$defs/d0" }, { "properties": {}, "type": "object" } ], "title": "Checkout with Fulfillment" }, { "not": { "required": [ "attribution" ] } } ], "type": "object" }, "id": { "type": "string" }, "meta": { "properties": { "idempotency-key": { "description": "UUID for one write; reuse for exact retries. complete_checkout derives if omitted.", "format": "uuid", "type": "string" } }, "type": "object" }, "shop": { "description": "Exact seller.domain storefront hostname from offer; no scheme/path; one seller per cart/checkout.", "minLength": 1, "type": "string" } }, "required": [ "id", "checkout", "shop" ], "type": "object" }, "annotations": { "destructiveHint": true, "idempotentHint": false, "openWorldHint": true, "readOnlyHint": false } }, { "name": "create_cart", "description": "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.", "inputSchema": { "$defs": { "d0": { "description": "Reverse domain, 2+ segments.", "examples": [ "dev.ucp.shopping.checkout", "dev.ucp.common.identity_linking", "com.example.loyalty_gold", "com.example-shop.checkout", "com.2example.cart", "uk.co.example-shop.checkout", "xn--p1ai.example.checkout" ], "pattern": "^[a-z](?:[a-z0-9-]*[a-z0-9])?(?:\\.[a-z0-9](?:[a-z0-9_-]*[a-z0-9_])?)+$", "title": "Reverse Domain Name", "type": "string" } }, "properties": { "cart": { "allOf": [ { "allOf": [ { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": true, "name": "dev.ucp.shopping.cart", "properties": { "buyer": { "additionalProperties": true, "description": "Buyer details for personalized estimates.", "properties": { "email": { "type": "string" }, "first_name": { "type": "string" }, "last_name": { "type": "string" }, "phone_number": { "description": "Buyer phone in E.164.", "type": "string" } }, "title": "Buyer", "type": "object" }, "context": { "allOf": [ { "additionalProperties": true, "allOf": [ { "additionalProperties": true, "description": "Coarse locality; not an address.", "properties": { "address_country": { "description": "ISO 3166-1 alpha-2, e.g. US.", "type": "string" }, "address_region": { "type": "string" }, "postal_code": { "type": "string" } }, "title": "Locality", "type": "object" }, { "additionalProperties": true, "properties": { "currency": { "description": "ISO 4217 preference/filter currency; verify output.", "type": "string" }, "eligibility": { "description": "Nonidentifying reverse-domain benefits; ignore unknowns.", "items": { "$ref": "#/$defs/d0" }, "type": "array", "uniqueItems": true }, "intent": { "description": "Relevance hint, e.g. 'gift under $50'.", "type": "string" }, "language": { "description": "BCP 47 preference, e.g. fr-CA.", "type": "string" }, "location": { "description": "Opaque merchant location ID, not locality.", "type": "string" }, "payment": { "description": "Advertised handlers, most preferred first; ignore unknowns.", "items": { "properties": { "handler": { "allOf": [ { "$ref": "#/$defs/d0" } ], "description": "Merchant ucp.payment_handlers key." }, "types": { "description": "Instrument types, most preferred first; ignore unknowns.", "items": { "type": "string" }, "type": "array" } }, "required": [ "handler" ], "type": "object" }, "type": "array" } }, "type": "object" } ], "description": "Soft relevance/localization; checkout wins.", "title": "Context", "type": "object" } ], "description": "Soft pricing/availability/currency hints; geo-IP may fallback." }, "line_items": { "description": "On update send every line; omissions delete, not merge.", "items": { "description": "Uses parent cart/checkout currency.", "properties": { "item": { "properties": { "id": { "description": "Copy exact returned variant ID; never rebuild/truncate.", "type": "string" }, "quantity_unit": { "allOf": [ { "allOf": [ { "if": { "properties": { "unit": { "const": "C62" } }, "required": [ "unit" ] }, "properties": { "display_text": { "description": "Printable label for unrecognized units.", "type": "string" }, "scale": { "default": 0, "description": "One step = 10^-scale units; omitted=0; C62 needs 0.", "maximum": 15, "minimum": 0, "type": "integer" }, "unit": { "description": "UN/CEFACT Rec 20 code, else stable opaque custom ID.", "type": "string" } }, "required": [ "unit", "display_text" ], "then": { "properties": { "scale": { "const": 0 } } }, "title": "Unit", "type": "object" }, { "properties": { "increment": { "default": 1, "description": "Step multiple (default 1); merchant may revise/reject, never reinterpret.", "minimum": 1, "type": "integer" } }, "type": "object" } ], "description": "Sale basis is unit+scale, not display_text/increment.", "title": "Quantity Unit" } ], "description": "Omit for merchant basis; else assert unit/scale. C62/0 = each." } }, "required": [ "id" ], "title": "Item", "type": "object" }, "quantity": { "description": "Integer sale-basis steps; missing quantity_unit is not each.", "maximum": 9007199254740991, "minimum": 1, "type": "integer" } }, "required": [ "item", "quantity" ], "title": "Line Item", "type": "object" }, "type": "array" }, "signals": { "additionalProperties": true, "description": "Observed/verified platform facts; no buyer claims.", "properties": { "dev.ucp.buyer_ip": { "type": "string" }, "dev.ucp.user_agent": { "type": "string" } }, "propertyNames": { "allOf": [ { "$ref": "#/$defs/d0" } ] }, "title": "Signals", "type": "object" } }, "required": [ "line_items" ], "title": "Cart", "type": "object", "version": "2026-08-25" }, { "properties": { "discounts": { "properties": { "codes": { "description": "Replace case-insensitively; [] clears all.", "items": { "type": "string" }, "type": "array" } }, "type": "object" } }, "type": "object" } ], "title": "Cart with Discount" }, { "not": { "required": [ "attribution" ] } } ], "type": "object" }, "meta": { "properties": { "idempotency-key": { "description": "UUID for one write; reuse for exact retries. complete_checkout derives if omitted.", "format": "uuid", "type": "string" } }, "type": "object" }, "shop": { "description": "Exact seller.domain storefront hostname from offer; no scheme/path; one seller per cart/checkout.", "minLength": 1, "type": "string" } }, "required": [ "cart", "shop" ], "type": "object" }, "annotations": { "destructiveHint": true, "idempotentHint": false, "openWorldHint": true, "readOnlyHint": false } }, { "name": "get_cart", "description": "Read with the same shop/exact opaque ID before update or after an uncertain cart write.", "inputSchema": { "properties": { "id": { "type": "string" }, "shop": { "description": "Exact seller.domain storefront hostname from offer; no scheme/path; one seller per cart/checkout.", "minLength": 1, "type": "string" } }, "required": [ "id", "shop" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": true, "readOnlyHint": true } }, { "name": "update_cart", "description": "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 uncertainty, read before retry.", "inputSchema": { "$defs": { "d0": { "description": "Reverse domain, 2+ segments.", "examples": [ "dev.ucp.shopping.checkout", "dev.ucp.common.identity_linking", "com.example.loyalty_gold", "com.example-shop.checkout", "com.2example.cart", "uk.co.example-shop.checkout", "xn--p1ai.example.checkout" ], "pattern": "^[a-z](?:[a-z0-9-]*[a-z0-9])?(?:\\.[a-z0-9](?:[a-z0-9_-]*[a-z0-9_])?)+$", "title": "Reverse Domain Name", "type": "string" } }, "properties": { "cart": { "allOf": [ { "allOf": [ { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": true, "name": "dev.ucp.shopping.cart", "properties": { "buyer": { "additionalProperties": true, "description": "Buyer details for personalized estimates.", "properties": { "email": { "type": "string" }, "first_name": { "type": "string" }, "last_name": { "type": "string" }, "phone_number": { "description": "Buyer phone in E.164.", "type": "string" } }, "title": "Buyer", "type": "object" }, "context": { "allOf": [ { "additionalProperties": true, "allOf": [ { "additionalProperties": true, "description": "Coarse locality; not an address.", "properties": { "address_country": { "description": "ISO 3166-1 alpha-2, e.g. US.", "type": "string" }, "address_region": { "type": "string" }, "postal_code": { "type": "string" } }, "title": "Locality", "type": "object" }, { "additionalProperties": true, "properties": { "currency": { "description": "ISO 4217 preference/filter currency; verify output.", "type": "string" }, "eligibility": { "description": "Nonidentifying reverse-domain benefits; ignore unknowns.", "items": { "$ref": "#/$defs/d0" }, "type": "array", "uniqueItems": true }, "intent": { "description": "Relevance hint, e.g. 'gift under $50'.", "type": "string" }, "language": { "description": "BCP 47 preference, e.g. fr-CA.", "type": "string" }, "location": { "description": "Opaque merchant location ID, not locality.", "type": "string" }, "payment": { "description": "Advertised handlers, most preferred first; ignore unknowns.", "items": { "properties": { "handler": { "allOf": [ { "$ref": "#/$defs/d0" } ], "description": "Merchant ucp.payment_handlers key." }, "types": { "description": "Instrument types, most preferred first; ignore unknowns.", "items": { "type": "string" }, "type": "array" } }, "required": [ "handler" ], "type": "object" }, "type": "array" } }, "type": "object" } ], "description": "Soft relevance/localization; checkout wins.", "title": "Context", "type": "object" } ], "description": "Soft pricing/availability/currency hints; geo-IP may fallback." }, "line_items": { "description": "On update send every line; omissions delete, not merge.", "items": { "description": "Uses parent cart/checkout currency.", "properties": { "id": { "type": "string" }, "item": { "properties": { "id": { "description": "Copy exact returned variant ID; never rebuild/truncate.", "type": "string" }, "quantity_unit": { "allOf": [ { "allOf": [ { "if": { "properties": { "unit": { "const": "C62" } }, "required": [ "unit" ] }, "properties": { "display_text": { "description": "Printable label for unrecognized units.", "type": "string" }, "scale": { "default": 0, "description": "One step = 10^-scale units; omitted=0; C62 needs 0.", "maximum": 15, "minimum": 0, "type": "integer" }, "unit": { "description": "UN/CEFACT Rec 20 code, else stable opaque custom ID.", "type": "string" } }, "required": [ "unit", "display_text" ], "then": { "properties": { "scale": { "const": 0 } } }, "title": "Unit", "type": "object" }, { "properties": { "increment": { "default": 1, "description": "Step multiple (default 1); merchant may revise/reject, never reinterpret.", "minimum": 1, "type": "integer" } }, "type": "object" } ], "description": "Sale basis is unit+scale, not display_text/increment.", "title": "Quantity Unit" } ], "description": "Omit for merchant basis; else assert unit/scale. C62/0 = each." } }, "required": [ "id" ], "title": "Item", "type": "object" }, "parent_id": { "description": "Copy returned parent line ID unchanged.", "type": "string" }, "quantity": { "description": "Integer sale-basis steps; missing quantity_unit is not each.", "maximum": 9007199254740991, "minimum": 1, "type": "integer" } }, "required": [ "item", "quantity" ], "title": "Line Item", "type": "object" }, "type": "array" }, "signals": { "additionalProperties": true, "description": "Observed/verified platform facts; no buyer claims.", "properties": { "dev.ucp.buyer_ip": { "type": "string" }, "dev.ucp.user_agent": { "type": "string" } }, "propertyNames": { "allOf": [ { "$ref": "#/$defs/d0" } ] }, "title": "Signals", "type": "object" } }, "required": [ "line_items" ], "title": "Cart", "type": "object", "version": "2026-08-25" }, { "properties": { "discounts": { "properties": { "codes": { "description": "Replace case-insensitively; [] clears all.", "items": { "type": "string" }, "type": "array" } }, "type": "object" } }, "type": "object" } ], "title": "Cart with Discount" }, { "not": { "required": [ "attribution" ] } } ], "type": "object" }, "id": { "type": "string" }, "meta": { "properties": { "idempotency-key": { "description": "UUID for one write; reuse for exact retries. complete_checkout derives if omitted.", "format": "uuid", "type": "string" } }, "type": "object" }, "shop": { "description": "Exact seller.domain storefront hostname from offer; no scheme/path; one seller per cart/checkout.", "minLength": 1, "type": "string" } }, "required": [ "id", "cart", "shop" ], "type": "object" }, "annotations": { "destructiveHint": true, "idempotentHint": false, "openWorldHint": true, "readOnlyHint": false } }, { "name": "search_catalog", "description": "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, and URL in the exact offer. Use get_product only for unresolved facts/options. Amounts are minor units.", "inputSchema": { "$defs": { "d0": { "description": "Reverse domain, 2+ segments.", "examples": [ "dev.ucp.shopping.checkout", "dev.ucp.common.identity_linking", "com.example.loyalty_gold", "com.example-shop.checkout", "com.2example.cart", "uk.co.example-shop.checkout", "xn--p1ai.example.checkout" ], "pattern": "^[a-z](?:[a-z0-9-]*[a-z0-9])?(?:\\.[a-z0-9](?:[a-z0-9_-]*[a-z0-9_])?)+$", "title": "Reverse Domain Name", "type": "string" }, "d1": { "additionalProperties": true, "properties": { "categories": { "items": { "type": "string" }, "type": "array" }, "price": { "description": "Inclusive context.currency minor-unit bounds.", "properties": { "max": { "allOf": [ { "$ref": "#/$defs/d2" } ] }, "min": { "allOf": [ { "$ref": "#/$defs/d2" } ] } }, "title": "Price Filter", "type": "object" } }, "title": "Search Filters", "type": "object" }, "d2": { "description": "ISO 4217 minor units: USD2, JPY0, KWD3.", "maximum": 9007199254740991, "minimum": 0, "title": "Amount", "type": "integer" } }, "properties": { "catalog": { "allOf": [ { "allOf": [ { "properties": { "context": { "additionalProperties": true, "allOf": [ { "additionalProperties": true, "description": "Coarse locality; not an address.", "properties": { "address_country": { "description": "ISO 3166-1 alpha-2, e.g. US.", "type": "string" }, "address_region": { "type": "string" }, "postal_code": { "type": "string" } }, "title": "Locality", "type": "object" }, { "additionalProperties": true, "properties": { "currency": { "description": "ISO 4217 preference/filter currency; verify output.", "type": "string" }, "eligibility": { "description": "Nonidentifying reverse-domain benefits; ignore unknowns.", "items": { "$ref": "#/$defs/d0" }, "type": "array", "uniqueItems": true }, "intent": { "description": "Relevance hint, e.g. 'gift under $50'.", "type": "string" }, "language": { "description": "BCP 47 preference, e.g. fr-CA.", "type": "string" }, "location": { "description": "Opaque merchant location ID, not locality.", "type": "string" }, "payment": { "description": "Advertised handlers, most preferred first; ignore unknowns.", "items": { "properties": { "handler": { "allOf": [ { "$ref": "#/$defs/d0" } ], "description": "Merchant ucp.payment_handlers key." }, "types": { "description": "Instrument types, most preferred first; ignore unknowns.", "items": { "type": "string" }, "type": "array" } }, "required": [ "handler" ], "type": "object" }, "type": "array" } }, "type": "object" } ], "description": "Soft relevance/localization; checkout wins.", "title": "Context", "type": "object" }, "filters": { "$ref": "#/$defs/d1" }, "pagination": { "properties": { "cursor": { "type": "string" }, "limit": { "minimum": 1, "type": "integer" } }, "type": "object" }, "query": { "type": "string" }, "signals": { "additionalProperties": true, "description": "Observed/verified platform facts; no buyer claims.", "properties": { "dev.ucp.buyer_ip": { "type": "string" }, "dev.ucp.user_agent": { "type": "string" } }, "propertyNames": { "allOf": [ { "$ref": "#/$defs/d0" } ] }, "title": "Signals", "type": "object" } }, "type": "object" }, { "anyOf": [ { "required": [ "query" ] }, { "required": [ "like" ] } ], "properties": { "filters": { "allOf": [ { "$ref": "#/$defs/d1" }, { "allOf": [ { "properties": { "available": { "default": true, "type": "boolean" } }, "title": "Shopify Filters", "type": "object" }, { "properties": { "condition": { "items": { "type": "string" }, "type": "array" }, "ships_from": { "items": { "properties": { "country": { "pattern": "^[A-Z]{2}$", "type": "string" } }, "required": [ "country" ], "type": "object" }, "type": "array" }, "ships_to": { "properties": { "country": { "pattern": "^[A-Z]{2}$", "type": "string" }, "postal_code": { "type": "string" }, "region": { "type": "string" } }, "required": [ "country" ], "type": "object" }, "shops": { "items": { "type": "string" }, "maxItems": 1000, "type": "array" } }, "type": "object" } ], "title": "Global Filters" }, { "properties": { "attributes": { "items": { "properties": { "name": { "type": "string" }, "values": { "items": { "type": "string" }, "maxItems": 50, "minItems": 1, "type": "array" } }, "required": [ "name", "values" ], "type": "object" }, "maxItems": 25, "type": "array" }, "categories": { "items": { "type": "string" }, "type": "array" }, "price_tier": { "items": { "type": "string" }, "type": "array" }, "rating": { "properties": { "variant": { "properties": { "min": { "maximum": 5, "minimum": 0, "type": "number" }, "min_count": { "maximum": 2147483647, "minimum": 0, "type": "integer" } }, "type": "object" } }, "type": "object" } }, "type": "object" } ], "title": "Global Search Filters" } }, "type": "object" } ], "title": "Global Search Request", "type": "object" }, { "anyOf": [ { "required": [ "query" ] }, { "required": [ "like" ] } ], "properties": { "catalog_id": { "description": "Saved catalog ID whose configuration constrains search.", "type": "string" }, "context": { "additionalProperties": true, "properties": { "address_country": { "type": "string" }, "address_region": { "type": "string" }, "currency": { "type": "string" }, "intent": { "type": "string" }, "language": { "type": "string" }, "postal_code": { "type": "string" } }, "type": "object" }, "filters": { "additionalProperties": true, "description": "Hard requirements; fields AND, stated lists OR. Check messages/every offer.", "properties": { "attributes": { "description": "Attributes AND; each value list OR. Check ignored-name messages.", "items": { "properties": { "name": { "description": "Supported names: Color, Size, Target gender.", "type": "string" }, "values": { "description": "OR across taxonomy values.", "items": { "type": "string" }, "maxItems": 50, "minItems": 1, "type": "array" } }, "required": [ "name", "values" ], "type": "object" }, "maxItems": 25, "type": "array" }, "available": { "default": true, "description": "true/omitted: sale-ready only; false: include unavailable.", "type": "boolean" }, "categories": { "description": "OR taxonomy category GIDs.", "items": { "type": "string" }, "type": "array" }, "condition": { "description": "OR new/secondhand; omit for either.", "items": { "type": "string" }, "type": "array" }, "price": { "properties": { "max": { "type": "integer" }, "min": { "type": "integer" } }, "type": "object" }, "price_tier": { "description": "OR category-relative tiers, not a budget cap; check ignored-value messages.", "items": { "type": "string" }, "type": "array" }, "rating": { "properties": { "variant": { "description": "At least one variant must meet these thresholds.", "properties": { "min": { "description": "Minimum rating on a 0–5 scale.", "maximum": 5, "minimum": 0, "type": "number" }, "min_count": { "description": "Minimum variant review count.", "maximum": 2147483647, "minimum": 0, "type": "integer" } }, "type": "object" } }, "type": "object" }, "ships_from": { "description": "OR origins; omit for any.", "items": { "properties": { "country": { "description": "ISO 3166-1 alpha-2.", "pattern": "^[A-Z]{2}$", "type": "string" } }, "required": [ "country" ], "type": "object" }, "type": "array" }, "ships_to": { "description": "Hard destination; context may supply it if omitted; matching context may refine estimates.", "properties": { "country": { "description": "ISO 3166-1 alpha-2.", "pattern": "^[A-Z]{2}$", "type": "string" }, "postal_code": { "type": "string" }, "region": { "type": "string" } }, "required": [ "country" ], "type": "object" }, "shops": { "description": "OR seller.id Shop GIDs/domains; check unmatched messages.", "items": { "type": "string" }, "maxItems": 1000, "type": "array" } }, "type": "object" }, "like": { "description": "One product/variant ID or image reference for similarity. Add query to refine an image reference. Put hard requirements in supported filters.", "items": { "oneOf": [ { "additionalProperties": false, "properties": { "id": { "description": "Exact Shopify product or variant GID.", "pattern": "^gid://shopify/", "type": "string" } }, "required": [ "id" ], "title": "Item Reference" }, { "additionalProperties": false, "properties": { "image": { "additionalProperties": false, "properties": { "content_type": { "description": "Image MIME type, e.g. image/jpeg or image/webp.", "type": "string" }, "data": { "contentEncoding": "base64", "description": "Base64-encoded image bytes.", "type": "string" } }, "required": [ "content_type", "data" ], "type": "object" } }, "required": [ "image" ], "title": "Image Content" } ], "title": "Like Item", "type": "object" }, "maxItems": 2, "minItems": 1, "type": "array" }, "pagination": { "properties": { "cursor": { "description": "Pass unchanged with the same query, like, context, and filters.", "type": "string" }, "limit": { "default": 10, "description": "Page size. Defaults to 10; maximum 50.", "maximum": 50, "minimum": 1, "type": "integer" } }, "type": "object" }, "query": { "description": "Preserve intent; clarify only. Add no preferences/popularity. Put hard requirements in supported filters.", "type": "string" }, "signals": { "additionalProperties": true, "properties": { "dev.ucp.buyer_ip": { "type": "string" }, "dev.ucp.user_agent": { "type": "string" } }, "type": "object" } }, "type": "object" }, { "not": { "required": [ "attribution" ] } }, { "not": { "required": [ "view" ] } } ], "type": "object" } }, "required": [ "catalog" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": true, "readOnlyHint": true } }, { "name": "lookup_catalog", "description": "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.", "inputSchema": { "$defs": { "d0": { "description": "Reverse domain, 2+ segments.", "examples": [ "dev.ucp.shopping.checkout", "dev.ucp.common.identity_linking", "com.example.loyalty_gold", "com.example-shop.checkout", "com.2example.cart", "uk.co.example-shop.checkout", "xn--p1ai.example.checkout" ], "pattern": "^[a-z](?:[a-z0-9-]*[a-z0-9])?(?:\\.[a-z0-9](?:[a-z0-9_-]*[a-z0-9_])?)+$", "title": "Reverse Domain Name", "type": "string" }, "d1": { "description": "ISO 4217 minor units: USD2, JPY0, KWD3.", "maximum": 9007199254740991, "minimum": 0, "title": "Amount", "type": "integer" } }, "properties": { "catalog": { "allOf": [ { "allOf": [ { "properties": { "context": { "additionalProperties": true, "allOf": [ { "additionalProperties": true, "description": "Coarse locality; not an address.", "properties": { "address_country": { "description": "ISO 3166-1 alpha-2, e.g. US.", "type": "string" }, "address_region": { "type": "string" }, "postal_code": { "type": "string" } }, "title": "Locality", "type": "object" }, { "additionalProperties": true, "properties": { "currency": { "description": "ISO 4217 preference/filter currency; verify output.", "type": "string" }, "eligibility": { "description": "Nonidentifying reverse-domain benefits; ignore unknowns.", "items": { "$ref": "#/$defs/d0" }, "type": "array", "uniqueItems": true }, "intent": { "description": "Relevance hint, e.g. 'gift under $50'.", "type": "string" }, "language": { "description": "BCP 47 preference, e.g. fr-CA.", "type": "string" }, "location": { "description": "Opaque merchant location ID, not locality.", "type": "string" }, "payment": { "description": "Advertised handlers, most preferred first; ignore unknowns.", "items": { "properties": { "handler": { "allOf": [ { "$ref": "#/$defs/d0" } ], "description": "Merchant ucp.payment_handlers key." }, "types": { "description": "Instrument types, most preferred first; ignore unknowns.", "items": { "type": "string" }, "type": "array" } }, "required": [ "handler" ], "type": "object" }, "type": "array" } }, "type": "object" } ], "description": "Soft relevance/localization; checkout wins.", "title": "Context", "type": "object" }, "filters": { "allOf": [ { "additionalProperties": true, "properties": { "categories": { "items": { "type": "string" }, "type": "array" }, "price": { "description": "Inclusive context.currency minor-unit bounds.", "properties": { "max": { "allOf": [ { "$ref": "#/$defs/d1" } ] }, "min": { "allOf": [ { "$ref": "#/$defs/d1" } ] } }, "title": "Price Filter", "type": "object" } }, "title": "Search Filters", "type": "object" } ] }, "ids": { "items": { "type": "string" }, "minItems": 1, "type": "array" }, "signals": { "additionalProperties": true, "description": "Observed/verified platform facts; no buyer claims.", "properties": { "dev.ucp.buyer_ip": { "type": "string" }, "dev.ucp.user_agent": { "type": "string" } }, "propertyNames": { "allOf": [ { "$ref": "#/$defs/d0" } ] }, "title": "Signals", "type": "object" } }, "required": [ "ids" ], "type": "object" }, { "properties": { "filters": { "allOf": [ { "properties": { "available": { "default": true, "type": "boolean" } }, "title": "Shopify Filters", "type": "object" }, { "properties": { "condition": { "items": { "type": "string" }, "type": "array" }, "ships_from": { "items": { "properties": { "country": { "pattern": "^[A-Z]{2}$", "type": "string" } }, "required": [ "country" ], "type": "object" }, "type": "array" }, "ships_to": { "properties": { "country": { "pattern": "^[A-Z]{2}$", "type": "string" }, "postal_code": { "type": "string" }, "region": { "type": "string" } }, "required": [ "country" ], "type": "object" }, "shops": { "items": { "type": "string" }, "maxItems": 1000, "type": "array" } }, "type": "object" } ], "title": "Global Filters" } }, "type": "object" } ], "title": "Global Lookup Request", "type": "object" }, { "properties": { "context": { "additionalProperties": true, "properties": { "address_country": { "type": "string" }, "address_region": { "type": "string" }, "currency": { "type": "string" }, "intent": { "type": "string" }, "language": { "type": "string" }, "postal_code": { "type": "string" } }, "type": "object" }, "filters": { "additionalProperties": true, "description": "Hard requirements; fields AND, stated lists OR. Verify the offer.", "properties": { "available": { "default": true, "description": "true/omitted: sale-ready only; false: include unavailable.", "type": "boolean" }, "categories": { "description": "OR taxonomy category GIDs.", "items": { "type": "string" }, "type": "array" }, "condition": { "description": "OR new/secondhand; omit for either.", "items": { "type": "string" }, "type": "array" }, "price": { "properties": { "max": { "type": "integer" }, "min": { "type": "integer" } }, "type": "object" }, "ships_from": { "description": "OR origins; omit for any.", "items": { "properties": { "country": { "description": "ISO 3166-1 alpha-2.", "pattern": "^[A-Z]{2}$", "type": "string" } }, "required": [ "country" ], "type": "object" }, "type": "array" }, "ships_to": { "description": "Hard destination; context may supply it if omitted; matching context may refine estimates.", "properties": { "country": { "description": "ISO 3166-1 alpha-2.", "pattern": "^[A-Z]{2}$", "type": "string" }, "postal_code": { "type": "string" }, "region": { "type": "string" } }, "required": [ "country" ], "type": "object" }, "shops": { "description": "OR seller.id Shop GIDs/domains; check unmatched messages.", "items": { "type": "string" }, "maxItems": 1000, "type": "array" } }, "type": "object" }, "ids": { "description": "Up to 50 exact IDs/URLs; preserve returned values.", "items": { "type": "string" }, "maxItems": 50, "minItems": 1, "type": "array" }, "signals": { "additionalProperties": true, "properties": { "dev.ucp.buyer_ip": { "type": "string" }, "dev.ucp.user_agent": { "type": "string" } }, "type": "object" } }, "required": [ "ids" ], "type": "object" }, { "not": { "required": [ "attribution" ] } }, { "not": { "required": [ "view" ] } } ], "type": "object" } }, "required": [ "catalog" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": true, "readOnlyHint": true } }, { "name": "get_product", "description": "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 URL in the exact offer. Skip if prior results prove facts. Amounts are minor units.", "inputSchema": { "$defs": { "d0": { "description": "Reverse domain, 2+ segments.", "examples": [ "dev.ucp.shopping.checkout", "dev.ucp.common.identity_linking", "com.example.loyalty_gold", "com.example-shop.checkout", "com.2example.cart", "uk.co.example-shop.checkout", "xn--p1ai.example.checkout" ], "pattern": "^[a-z](?:[a-z0-9-]*[a-z0-9])?(?:\\.[a-z0-9](?:[a-z0-9_-]*[a-z0-9_])?)+$", "title": "Reverse Domain Name", "type": "string" }, "d1": { "description": "ISO 4217 minor units: USD2, JPY0, KWD3.", "maximum": 9007199254740991, "minimum": 0, "title": "Amount", "type": "integer" } }, "properties": { "catalog": { "allOf": [ { "allOf": [ { "properties": { "context": { "additionalProperties": true, "allOf": [ { "additionalProperties": true, "description": "Coarse locality; not an address.", "properties": { "address_country": { "description": "ISO 3166-1 alpha-2, e.g. US.", "type": "string" }, "address_region": { "type": "string" }, "postal_code": { "type": "string" } }, "title": "Locality", "type": "object" }, { "additionalProperties": true, "properties": { "currency": { "description": "ISO 4217 preference/filter currency; verify output.", "type": "string" }, "eligibility": { "description": "Nonidentifying reverse-domain benefits; ignore unknowns.", "items": { "$ref": "#/$defs/d0" }, "type": "array", "uniqueItems": true }, "intent": { "description": "Relevance hint, e.g. 'gift under $50'.", "type": "string" }, "language": { "description": "BCP 47 preference, e.g. fr-CA.", "type": "string" }, "location": { "description": "Opaque merchant location ID, not locality.", "type": "string" }, "payment": { "description": "Advertised handlers, most preferred first; ignore unknowns.", "items": { "properties": { "handler": { "allOf": [ { "$ref": "#/$defs/d0" } ], "description": "Merchant ucp.payment_handlers key." }, "types": { "description": "Instrument types, most preferred first; ignore unknowns.", "items": { "type": "string" }, "type": "array" } }, "required": [ "handler" ], "type": "object" }, "type": "array" } }, "type": "object" } ], "description": "Soft relevance/localization; checkout wins.", "title": "Context", "type": "object" }, "filters": { "allOf": [ { "additionalProperties": true, "properties": { "categories": { "items": { "type": "string" }, "type": "array" }, "price": { "description": "Inclusive context.currency minor-unit bounds.", "properties": { "max": { "allOf": [ { "$ref": "#/$defs/d1" } ] }, "min": { "allOf": [ { "$ref": "#/$defs/d1" } ] } }, "title": "Price Filter", "type": "object" } }, "title": "Search Filters", "type": "object" } ] }, "id": { "type": "string" }, "preferences": { "description": "Ordered option names, relaxed from the end; not hard requirements.", "items": { "type": "string" }, "type": "array" }, "selected": { "items": { "properties": { "id": { "description": "Copy returned option_value.id unchanged.", "type": "string" }, "label": { "type": "string" }, "name": { "type": "string" } }, "required": [ "name", "label" ], "title": "Selected Option", "type": "object" }, "type": "array" }, "signals": { "additionalProperties": true, "description": "Observed/verified platform facts; no buyer claims.", "properties": { "dev.ucp.buyer_ip": { "type": "string" }, "dev.ucp.user_agent": { "type": "string" } }, "propertyNames": { "allOf": [ { "$ref": "#/$defs/d0" } ] }, "title": "Signals", "type": "object" } }, "required": [ "id" ], "type": "object" }, { "properties": { "filters": { "allOf": [ { "properties": { "available": { "default": true, "type": "boolean" } }, "title": "Shopify Filters", "type": "object" }, { "properties": { "condition": { "items": { "type": "string" }, "type": "array" }, "ships_from": { "items": { "properties": { "country": { "pattern": "^[A-Z]{2}$", "type": "string" } }, "required": [ "country" ], "type": "object" }, "type": "array" }, "ships_to": { "properties": { "country": { "pattern": "^[A-Z]{2}$", "type": "string" }, "postal_code": { "type": "string" }, "region": { "type": "string" } }, "required": [ "country" ], "type": "object" }, "shops": { "items": { "type": "string" }, "maxItems": 1000, "type": "array" } }, "type": "object" } ], "title": "Global Filters" } }, "type": "object" } ], "title": "Global Get Product Request", "type": "object" }, { "properties": { "context": { "additionalProperties": true, "properties": { "address_country": { "type": "string" }, "address_region": { "type": "string" }, "currency": { "type": "string" }, "intent": { "type": "string" }, "language": { "type": "string" }, "postal_code": { "type": "string" } }, "type": "object" }, "filters": { "additionalProperties": true, "description": "Hard requirements; fields AND, stated lists OR. Verify the offer.", "properties": { "available": { "default": true, "description": "true/omitted: sale-ready only; false: include unavailable.", "type": "boolean" }, "categories": { "description": "OR taxonomy category GIDs.", "items": { "type": "string" }, "type": "array" }, "condition": { "description": "OR new/secondhand; omit for either.", "items": { "type": "string" }, "type": "array" }, "price": { "properties": { "max": { "type": "integer" }, "min": { "type": "integer" } }, "type": "object" }, "ships_from": { "description": "OR origins; omit for any.", "items": { "properties": { "country": { "description": "ISO 3166-1 alpha-2.", "pattern": "^[A-Z]{2}$", "type": "string" } }, "required": [ "country" ], "type": "object" }, "type": "array" }, "ships_to": { "description": "Hard destination; context may supply it if omitted; matching context may refine estimates.", "properties": { "country": { "description": "ISO 3166-1 alpha-2.", "pattern": "^[A-Z]{2}$", "type": "string" }, "postal_code": { "type": "string" }, "region": { "type": "string" } }, "required": [ "country" ], "type": "object" }, "shops": { "description": "OR seller.id Shop GIDs/domains; check unmatched messages.", "items": { "type": "string" }, "maxItems": 1000, "type": "array" } }, "type": "object" }, "id": { "description": "Exact returned product ID; resolve URL/variant via lookup_catalog first.", "type": "string" }, "preferences": { "items": { "type": "string" }, "type": "array" }, "selected": { "description": "Exact returned name/label pairs; verify effective selection because requests may drop.", "items": { "properties": { "label": { "type": "string" }, "name": { "type": "string" } }, "type": "object" }, "type": "array" }, "signals": { "additionalProperties": true, "properties": { "dev.ucp.buyer_ip": { "type": "string" }, "dev.ucp.user_agent": { "type": "string" } }, "type": "object" } }, "required": [ "id" ], "type": "object" }, { "not": { "required": [ "attribution" ] } }, { "not": { "required": [ "view" ] } } ], "type": "object" } }, "required": [ "catalog" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": true, "readOnlyHint": true } }, { "name": "search_locations", "description": "Search shop's physical stores by city, neighborhood, street or postal code (query), by radius around coordinates the user gave (distance), or by item availability (filters.items); filters combine. One shop per call. Omit filters to list every store.", "inputSchema": { "$defs": { "d0": { "properties": { "context": { "additionalProperties": true, "allOf": [ { "$ref": "#/$defs/d1" }, { "additionalProperties": true, "properties": { "currency": { "description": "ISO 4217 preference/filter currency; verify output.", "type": "string" }, "eligibility": { "description": "Nonidentifying reverse-domain benefits; ignore unknowns.", "items": { "$ref": "#/$defs/d2" }, "type": "array", "uniqueItems": true }, "intent": { "description": "Relevance hint, e.g. 'gift under $50'.", "type": "string" }, "language": { "description": "BCP 47 preference, e.g. fr-CA.", "type": "string" }, "location": { "description": "Opaque merchant location ID, not locality.", "type": "string" }, "payment": { "description": "Advertised handlers, most preferred first; ignore unknowns.", "items": { "properties": { "handler": { "allOf": [ { "$ref": "#/$defs/d2" } ], "description": "Merchant ucp.payment_handlers key." }, "types": { "description": "Instrument types, most preferred first; ignore unknowns.", "items": { "type": "string" }, "type": "array" } }, "required": [ "handler" ], "type": "object" }, "type": "array" } }, "type": "object" } ], "description": "Soft relevance/localization; checkout wins.", "title": "Context", "type": "object" }, "distance": { "allOf": [ { "additionalProperties": true, "description": "Stores within max meters of an explicit center. Use coordinates the user or host gave; never derive them. The radius is never widened or clamped.", "properties": { "center": { "allOf": [ { "$ref": "#/$defs/d3" } ] }, "max": { "description": "Inclusive radius in meters.", "minimum": 0, "type": "number" } }, "required": [ "center", "max" ], "title": "Location Distance", "type": "object" } ] }, "filters": { "additionalProperties": true, "description": "Hard requirements; fields AND. A merchant rejects a filter it cannot evaluate with invalid_input rather than ignoring it; Shopify stores evaluate items only.", "properties": { "amenities": { "description": "Exact amenity IDs, all required.", "items": { "allOf": [ { "$ref": "#/$defs/d2" } ], "examples": [ "dev.ucp.amenity.wi_fi", "dev.ucp.amenity.parking", "dev.ucp.amenity.shopping.in_store_pickup", "dev.ucp.amenity.shopping.curbside_pickup" ], "title": "Amenity Type" }, "type": "array" }, "hours": { "properties": { "open_at": { "description": "RFC 3339 instant the store must be open at.", "format": "date-time", "pattern": "(?:[Zz]|[+-](?:[01][0-9]|2[0-3]):[0-5][0-9])$", "type": "string" } }, "required": [ "open_at" ], "type": "object" }, "items": { "description": "Variant IDs from catalog results; returns stores that have all of them available, up to 10 items per call.", "items": { "minLength": 1, "type": "string" }, "minItems": 1, "type": "array", "uniqueItems": true } }, "title": "Location Filter", "type": "object" }, "pagination": { "properties": { "cursor": { "type": "string" }, "limit": { "minimum": 1, "type": "integer" } }, "type": "object" }, "query": { "description": "City, neighborhood, street or postal code, matched literally (New York, not NY). Omit to list every store.", "type": "string" }, "serves": { "allOf": [ { "additionalProperties": true, "description": "Serviceability (can this store deliver to the target), not proximity; use distance for near. Exactly one of point or address. Merchants that cannot evaluate it, Shopify stores included, return invalid_input.", "maxProperties": 1, "minProperties": 1, "properties": { "address": { "allOf": [ { "$ref": "#/$defs/d1" }, { "anyOf": [ { "properties": { "address_country": { "minLength": 1, "type": "string" } }, "required": [ "address_country" ] }, { "properties": { "address_region": { "minLength": 1, "type": "string" } }, "required": [ "address_region" ] }, { "properties": { "postal_code": { "minLength": 1, "type": "string" } }, "required": [ "postal_code" ] } ], "type": "object" } ] }, "point": { "allOf": [ { "$ref": "#/$defs/d3" } ] } }, "propertyNames": { "anyOf": [ { "const": "point" }, { "const": "address" }, { "$ref": "#/$defs/d2" } ] }, "title": "Location Serves", "type": "object" } ] }, "signals": { "additionalProperties": true, "description": "Observed/verified platform facts; no buyer claims.", "properties": { "dev.ucp.buyer_ip": { "type": "string" }, "dev.ucp.user_agent": { "type": "string" } }, "propertyNames": { "allOf": [ { "$ref": "#/$defs/d2" } ] }, "title": "Signals", "type": "object" } }, "type": "object" }, "d1": { "additionalProperties": true, "description": "Coarse locality; not an address.", "properties": { "address_country": { "description": "ISO 3166-1 alpha-2, e.g. US.", "type": "string" }, "address_region": { "type": "string" }, "postal_code": { "type": "string" } }, "title": "Locality", "type": "object" }, "d2": { "description": "Reverse domain, 2+ segments.", "examples": [ "dev.ucp.shopping.checkout", "dev.ucp.common.identity_linking", "com.example.loyalty_gold", "com.example-shop.checkout", "com.2example.cart", "uk.co.example-shop.checkout", "xn--p1ai.example.checkout" ], "pattern": "^[a-z](?:[a-z0-9-]*[a-z0-9])?(?:\\.[a-z0-9](?:[a-z0-9_-]*[a-z0-9_])?)+$", "title": "Reverse Domain Name", "type": "string" }, "d3": { "description": "WGS 84 decimal degrees.", "properties": { "latitude": { "maximum": 90, "minimum": -90, "type": "number" }, "longitude": { "maximum": 180, "minimum": -180, "type": "number" } }, "required": [ "latitude", "longitude" ], "title": "Geo", "type": "object" } }, "properties": { "location": { "$ref": "#/$defs/d0", "allOf": [ { "not": { "required": [ "attribution" ] } } ], "type": "object" }, "shop": { "description": "Exact seller.domain storefront hostname from offer; no scheme/path; one seller per cart/checkout.", "minLength": 1, "type": "string" } }, "required": [ "location", "shop" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": true, "readOnlyHint": true } }, { "name": "lookup_locations", "description": "Fetch shop's stores by store ID from search_locations — to re-read a store you saved, or check it against filters.items or distance. Same fields as search; results list which input IDs matched. Up to 10 IDs per call.", "inputSchema": { "$defs": { "d0": { "properties": { "context": { "additionalProperties": true, "allOf": [ { "$ref": "#/$defs/d1" }, { "additionalProperties": true, "properties": { "currency": { "description": "ISO 4217 preference/filter currency; verify output.", "type": "string" }, "eligibility": { "description": "Nonidentifying reverse-domain benefits; ignore unknowns.", "items": { "$ref": "#/$defs/d2" }, "type": "array", "uniqueItems": true }, "intent": { "description": "Relevance hint, e.g. 'gift under $50'.", "type": "string" }, "language": { "description": "BCP 47 preference, e.g. fr-CA.", "type": "string" }, "location": { "description": "Opaque merchant location ID, not locality.", "type": "string" }, "payment": { "description": "Advertised handlers, most preferred first; ignore unknowns.", "items": { "properties": { "handler": { "allOf": [ { "$ref": "#/$defs/d2" } ], "description": "Merchant ucp.payment_handlers key." }, "types": { "description": "Instrument types, most preferred first; ignore unknowns.", "items": { "type": "string" }, "type": "array" } }, "required": [ "handler" ], "type": "object" }, "type": "array" } }, "type": "object" } ], "description": "Soft relevance/localization; checkout wins.", "title": "Context", "type": "object" }, "distance": { "allOf": [ { "additionalProperties": true, "description": "Stores within max meters of an explicit center. Use coordinates the user or host gave; never derive them. The radius is never widened or clamped.", "properties": { "center": { "allOf": [ { "$ref": "#/$defs/d3" } ] }, "max": { "description": "Inclusive radius in meters.", "minimum": 0, "type": "number" } }, "required": [ "center", "max" ], "title": "Location Distance", "type": "object" } ] }, "filters": { "additionalProperties": true, "description": "Hard requirements; fields AND. A merchant rejects a filter it cannot evaluate with invalid_input rather than ignoring it; Shopify stores evaluate items only.", "properties": { "amenities": { "description": "Exact amenity IDs, all required.", "items": { "allOf": [ { "$ref": "#/$defs/d2" } ], "examples": [ "dev.ucp.amenity.wi_fi", "dev.ucp.amenity.parking", "dev.ucp.amenity.shopping.in_store_pickup", "dev.ucp.amenity.shopping.curbside_pickup" ], "title": "Amenity Type" }, "type": "array" }, "hours": { "properties": { "open_at": { "description": "RFC 3339 instant the store must be open at.", "format": "date-time", "pattern": "(?:[Zz]|[+-](?:[01][0-9]|2[0-3]):[0-5][0-9])$", "type": "string" } }, "required": [ "open_at" ], "type": "object" }, "items": { "description": "Variant IDs from catalog results; returns stores that have all of them available, up to 10 items per call.", "items": { "minLength": 1, "type": "string" }, "minItems": 1, "type": "array", "uniqueItems": true } }, "title": "Location Filter", "type": "object" }, "ids": { "description": "Store IDs from search_locations, up to 10 per call.", "items": { "type": "string" }, "minItems": 1, "type": "array" }, "serves": { "allOf": [ { "additionalProperties": true, "description": "Serviceability (can this store deliver to the target), not proximity; use distance for near. Exactly one of point or address. Merchants that cannot evaluate it, Shopify stores included, return invalid_input.", "maxProperties": 1, "minProperties": 1, "properties": { "address": { "allOf": [ { "$ref": "#/$defs/d1" }, { "anyOf": [ { "properties": { "address_country": { "minLength": 1, "type": "string" } }, "required": [ "address_country" ] }, { "properties": { "address_region": { "minLength": 1, "type": "string" } }, "required": [ "address_region" ] }, { "properties": { "postal_code": { "minLength": 1, "type": "string" } }, "required": [ "postal_code" ] } ], "type": "object" } ] }, "point": { "allOf": [ { "$ref": "#/$defs/d3" } ] } }, "propertyNames": { "anyOf": [ { "const": "point" }, { "const": "address" }, { "$ref": "#/$defs/d2" } ] }, "title": "Location Serves", "type": "object" } ] }, "signals": { "additionalProperties": true, "description": "Observed/verified platform facts; no buyer claims.", "properties": { "dev.ucp.buyer_ip": { "type": "string" }, "dev.ucp.user_agent": { "type": "string" } }, "propertyNames": { "allOf": [ { "$ref": "#/$defs/d2" } ] }, "title": "Signals", "type": "object" } }, "required": [ "ids" ], "type": "object" }, "d1": { "additionalProperties": true, "description": "Coarse locality; not an address.", "properties": { "address_country": { "description": "ISO 3166-1 alpha-2, e.g. US.", "type": "string" }, "address_region": { "type": "string" }, "postal_code": { "type": "string" } }, "title": "Locality", "type": "object" }, "d2": { "description": "Reverse domain, 2+ segments.", "examples": [ "dev.ucp.shopping.checkout", "dev.ucp.common.identity_linking", "com.example.loyalty_gold", "com.example-shop.checkout", "com.2example.cart", "uk.co.example-shop.checkout", "xn--p1ai.example.checkout" ], "pattern": "^[a-z](?:[a-z0-9-]*[a-z0-9])?(?:\\.[a-z0-9](?:[a-z0-9_-]*[a-z0-9_])?)+$", "title": "Reverse Domain Name", "type": "string" }, "d3": { "description": "WGS 84 decimal degrees.", "properties": { "latitude": { "maximum": 90, "minimum": -90, "type": "number" }, "longitude": { "maximum": 180, "minimum": -180, "type": "number" } }, "required": [ "latitude", "longitude" ], "title": "Geo", "type": "object" } }, "properties": { "location": { "$ref": "#/$defs/d0", "allOf": [ { "not": { "required": [ "attribution" ] } } ], "type": "object" }, "shop": { "description": "Exact seller.domain storefront hostname from offer; no scheme/path; one seller per cart/checkout.", "minLength": 1, "type": "string" } }, "required": [ "location", "shop" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": true, "readOnlyHint": true } }, { "name": "search_orders", "description": "Search the signed-in buyer's Shop-tracked orders and shipments from any store. Returns in-progress orders by default; set filters.status to all to search the full order history.", "inputSchema": { "properties": { "orders": { "properties": { "filters": { "description": "Narrow the search; fields AND.", "properties": { "date": { "description": "Order placement dates, YYYY-MM-DD.", "properties": { "from": { "format": "date", "type": "string" }, "to": { "format": "date", "type": "string" } }, "title": "Date Range", "type": "object" }, "status": { "default": "in_progress", "description": "in_progress: orders still in progress. all: the full order history.", "enum": [ "in_progress", "all" ], "type": "string" } }, "title": "Search Filters", "type": "object" }, "pagination": { "description": "Page orders and standalone shipments together.", "properties": { "cursor": { "description": "Pass unchanged with the same query and filters.", "minLength": 1, "type": "string" }, "limit": { "default": 5, "description": "Page size. Defaults to 5; maximum 10.", "maximum": 10, "minimum": 1, "type": "integer" } }, "title": "Pagination Request", "type": "object" }, "query": { "description": "Merchant, item, or order number; omit to list.", "maxLength": 200, "type": "string" } }, "title": "Search Request", "type": "object" } }, "required": [ "orders" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": true, "readOnlyHint": true } }, { "name": "get_account", "description": "Read signed-in Shop account, addresses, spend permissions, cards. For missing checkout delivery, copy one addresses[] entry unchanged into fulfillment destinations and select its id; preferred_address_id is default. buyer.email is display-only, never checkout input. Missing is unknown (messages say why); empty spend_permissions means none is set.", "inputSchema": { "properties": {}, "required": [], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": true, "readOnlyHint": true } }, { "name": "create_spend_request", "description": "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 account's preferred card. Share the returned continue_url unchanged for review and approval. This does not pay or place an order.", "inputSchema": { "$defs": { "d0": { "description": "ISO 4217 minor units: USD2, JPY0, KWD3.", "maximum": 9007199254740991, "minimum": 0, "title": "Amount", "type": "integer" } }, "properties": { "meta": { "properties": { "idempotency-key": { "description": "Reuse only for exact retries. Update/cancel derive a key if omitted.", "format": "uuid", "type": "string" } }, "type": "object" }, "spend_request": { "properties": { "approval_limit": { "allOf": [ { "$ref": "#/$defs/d0" } ], "description": "Positive spending limit in currency minor units.", "minimum": 1 }, "business": { "properties": { "country": { "description": "Omit unless the site states it.", "maxLength": 2, "minLength": 2, "pattern": "^[A-Z]{2}$", "type": "string" }, "name": { "minLength": 1, "type": "string" }, "url": { "format": "uri", "type": "string" } }, "required": [ "name", "url" ], "type": "object" }, "context": { "properties": { "address_country": false, "address_region": false, "currency": false, "eligibility": false, "intent": { "allOf": [ { "description": "Relevance hint, e.g. 'gift under $50'.", "type": "string" } ], "description": "Describe the purchase and rationale (100-500 chars); the buyer reads this when approving." }, "language": false, "location": false, "payment": false, "postal_code": false }, "required": [ "intent" ], "type": "object" }, "currency": { "pattern": "^[A-Z]{3}$", "type": "string" }, "instrument_id": { "description": "Saved card chosen by the buyer; omit to use get_account.preferred_instrument_id.", "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$", "type": "string" }, "line_items": { "items": { "properties": { "item": { "properties": { "price": { "$ref": "#/$defs/d0" }, "title": { "type": "string" } }, "required": [ "title", "price" ], "type": "object" }, "quantity": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" } }, "required": [ "item", "quantity" ], "type": "object" }, "type": "array" }, "shipping_address": { "properties": { "address_country": { "type": "string" }, "address_locality": { "type": "string" }, "address_region": { "type": "string" }, "extended_address": { "type": "string" }, "first_name": { "type": "string" }, "last_name": { "type": "string" }, "postal_code": { "type": "string" }, "street_address": { "type": "string" } }, "type": "object" }, "totals": { "contains": { "properties": { "type": { "const": "total" } }, "required": [ "type" ], "type": "object" }, "items": { "allOf": [ { "if": { "properties": { "type": { "enum": [ "discount", "items_discount" ] } }, "required": [ "type" ] }, "then": { "properties": { "amount": { "exclusiveMaximum": 0 } } } }, { "if": { "properties": { "type": { "enum": [ "subtotal", "fulfillment", "tax", "fee" ] } }, "required": [ "type" ] }, "then": { "properties": { "amount": { "minimum": 0 } } } } ], "properties": { "amount": { "description": "Signed ISO 4217 minor units; discounts negative.", "maximum": 9007199254740991, "minimum": -9007199254740991, "title": "Signed Amount", "type": "integer" }, "type": { "minLength": 1, "type": "string" } }, "required": [ "type", "amount" ], "type": "object" }, "maxContains": 1, "minContains": 1, "minItems": 1, "type": "array" } }, "required": [ "business", "currency", "totals", "approval_limit", "context" ], "type": "object" } }, "required": [ "spend_request" ], "type": "object" }, "annotations": { "destructiveHint": true, "idempotentHint": false, "openWorldHint": true, "readOnlyHint": false } }, { "name": "get_spend_request", "description": "Read a spend request, optionally requesting an issued card. Omit include to read status and terms only. Set include to \"card\" to obtain the issued card after the buyer approves the request.", "inputSchema": { "properties": { "id": { "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$", "type": "string" }, "include": { "description": "Optional credential selection. Currently supported: card. Omit to read status and terms only.", "type": "string" } }, "required": [ "id" ], "type": "object" }, "annotations": { "destructiveHint": true, "idempotentHint": false, "openWorldHint": true, "readOnlyHint": false } }, { "name": "update_spend_request", "description": "Update the request's address, items, totals or spending limit. Omitted fields stay unchanged. Wallet decides whether its current state allows the update.", "inputSchema": { "$defs": { "d0": { "description": "ISO 4217 minor units: USD2, JPY0, KWD3.", "maximum": 9007199254740991, "minimum": 0, "title": "Amount", "type": "integer" } }, "properties": { "id": { "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$", "type": "string" }, "meta": { "properties": { "idempotency-key": { "description": "Reuse only for exact retries. Update/cancel derive a key if omitted.", "format": "uuid", "type": "string" } }, "type": "object" }, "spend_request": { "minProperties": 1, "properties": { "approval_limit": { "allOf": [ { "$ref": "#/$defs/d0" } ], "description": "Positive spending limit in currency minor units.", "minimum": 1 }, "business": false, "context": false, "currency": false, "instrument_id": false, "line_items": { "items": { "properties": { "item": { "properties": { "price": { "$ref": "#/$defs/d0" }, "title": { "type": "string" } }, "required": [ "title", "price" ], "type": "object" }, "quantity": { "maximum": 9007199254740991, "minimum": 1, "type": "integer" } }, "required": [ "item", "quantity" ], "type": "object" }, "type": "array" }, "shipping_address": { "properties": { "address_country": { "type": "string" }, "address_locality": { "type": "string" }, "address_region": { "type": "string" }, "extended_address": { "type": "string" }, "first_name": { "type": "string" }, "last_name": { "type": "string" }, "postal_code": { "type": "string" }, "street_address": { "type": "string" } }, "type": "object" }, "totals": { "contains": { "properties": { "type": { "const": "total" } }, "required": [ "type" ], "type": "object" }, "items": { "allOf": [ { "if": { "properties": { "type": { "enum": [ "discount", "items_discount" ] } }, "required": [ "type" ] }, "then": { "properties": { "amount": { "exclusiveMaximum": 0 } } } }, { "if": { "properties": { "type": { "enum": [ "subtotal", "fulfillment", "tax", "fee" ] } }, "required": [ "type" ] }, "then": { "properties": { "amount": { "minimum": 0 } } } } ], "properties": { "amount": { "description": "Signed ISO 4217 minor units; discounts negative.", "maximum": 9007199254740991, "minimum": -9007199254740991, "title": "Signed Amount", "type": "integer" }, "type": { "minLength": 1, "type": "string" } }, "required": [ "type", "amount" ], "type": "object" }, "maxContains": 1, "minContains": 1, "minItems": 1, "type": "array" } }, "type": "object" } }, "required": [ "id", "spend_request" ], "type": "object" }, "annotations": { "destructiveHint": true, "idempotentHint": false, "openWorldHint": true, "readOnlyHint": false } }, { "name": "cancel_spend_request", "description": "Cancel the spend request; this does not cancel/refund the purchase or revoke an issued credential.", "inputSchema": { "properties": { "id": { "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$", "type": "string" }, "meta": { "properties": { "idempotency-key": { "description": "Reuse only for exact retries. Update/cancel derive a key if omitted.", "format": "uuid", "type": "string" } }, "type": "object" } }, "required": [ "id" ], "type": "object" }, "annotations": { "destructiveHint": true, "idempotentHint": false, "openWorldHint": true, "readOnlyHint": false } }, { "name": "complete_spend_request", "description": "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.", "inputSchema": { "properties": { "id": { "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$", "type": "string" }, "result": { "anyOf": [ { "properties": { "failure_code": false, "message": false, "order": { "properties": { "currency": { "pattern": "^[A-Z]{3}$", "type": "string" }, "id": { "type": "string" }, "permalink_url": { "format": "uri", "type": "string" }, "total": { "description": "ISO 4217 minor units: USD2, JPY0, KWD3.", "maximum": 9007199254740991, "minimum": 0, "title": "Amount", "type": "integer" } }, "type": "object" }, "status": { "const": "success", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "properties": { "failure_code": { "description": "Observed failure code. Examples are not exhaustive.", "examples": [ "captcha", "anti_bot_script", "cdn_block", "waf_block", "dns_block", "rate_limited", "login_required", "3ds_challenge", "page_inaccessible", "timeout", "site_error", "payment_declined", "other" ], "type": "string" }, "message": { "type": "string" }, "order": false, "status": { "const": "error", "type": "string" } }, "required": [ "status", "failure_code" ], "type": "object" } ], "description": "Observed outcome: success may include known order fields; error requires failure_code and may include message. No credentials.", "type": "object" } }, "required": [ "id", "result" ], "type": "object" }, "annotations": { "destructiveHint": true, "idempotentHint": false, "openWorldHint": true, "readOnlyHint": false } } ], "schemaTokens": 18979, "changedAt": "2026-10-29T00:42:36.05814915Z", "check": { "checker": "anchor-check/1.0", "totalTokens": 18979, "counts": { "error": 0, "note": 1, "warn": 46 }, "findings": [ { "rule": "TC11", "severity": "warn", "tool": "cancel_spend_request", "message": "none of its 2 parameters has a description", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "complete_checkout", "message": "3 parameters without a description: checkout, id, meta", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "complete_spend_request", "message": "1 parameter without a description: id", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "create_cart", "message": "2 parameters without a description: cart, meta", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "create_checkout", "message": "2 parameters without a description: checkout, meta", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "create_spend_request", "message": "none of its 2 parameters has a description", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "get_cart", "message": "1 parameter without a description: id", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "get_checkout", "message": "1 parameter without a description: id", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "get_product", "message": "its one parameter, catalog, has no description", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "get_spend_request", "message": "1 parameter without a description: id", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "lookup_catalog", "message": "its one parameter, catalog, has no description", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "lookup_locations", "message": "1 parameter without a description: location", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "search_catalog", "message": "its one parameter, catalog, has no description", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "search_locations", "message": "1 parameter without a description: location", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "search_orders", "message": "its one parameter, orders, has no description", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "update_cart", "message": "3 parameters without a description: cart, id, meta", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "update_checkout", "message": "3 parameters without a description: checkout, id, meta", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC11", "severity": "warn", "tool": "update_spend_request", "message": "none of its 3 parameters has a description", "fix": "Describe each one: format, units, an example, and what happens when it's left out." }, { "rule": "TC13", "severity": "warn", "tool": "complete_checkout", "message": "checkout (object with no properties)", "fix": "Declare the properties (or additionalProperties with a schema) and the array's items." }, { "rule": "TC13", "severity": "warn", "tool": "complete_spend_request", "message": "result (object with no properties)", "fix": "Declare the properties (or additionalProperties with a schema) and the array's items." }, { "rule": "TC13", "severity": "warn", "tool": "create_cart", "message": "cart (object with no properties)", "fix": "Declare the properties (or additionalProperties with a schema) and the array's items." }, { "rule": "TC13", "severity": "warn", "tool": "create_checkout", "message": "checkout (object with no properties)", "fix": "Declare the properties (or additionalProperties with a schema) and the array's items." }, { "rule": "TC13", "severity": "warn", "tool": "get_product", "message": "catalog (object with no properties)", "fix": "Declare the properties (or additionalProperties with a schema) and the array's items." }, { "rule": "TC13", "severity": "warn", "tool": "lookup_catalog", "message": "catalog (object with no properties)", "fix": "Declare the properties (or additionalProperties with a schema) and the array's items." }, { "rule": "TC13", "severity": "warn", "tool": "lookup_locations", "message": "location (object with no properties)", "fix": "Declare the properties (or additionalProperties with a schema) and the array's items." }, { "rule": "TC13", "severity": "warn", "tool": "search_catalog", "message": "catalog (object with no properties)", "fix": "Declare the properties (or additionalProperties with a schema) and the array's items." }, { "rule": "TC13", "severity": "warn", "tool": "search_locations", "message": "location (object with no properties)", "fix": "Declare the properties (or additionalProperties with a schema) and the array's items." }, { "rule": "TC13", "severity": "warn", "tool": "update_cart", "message": "cart (object with no properties)", "fix": "Declare the properties (or additionalProperties with a schema) and the array's items." }, { "rule": "TC13", "severity": "warn", "tool": "update_checkout", "message": "checkout (object with no properties)", "fix": "Declare the properties (or additionalProperties with a schema) and the array's items." }, { "rule": "TC15", "severity": "warn", "tool": "complete_checkout", "message": "inputSchema uses $ref/$defs", "fix": "Inline the referenced schemas. Pydantic and zod-to-json-schema emit $defs for nested models; most can be told not to." }, { "rule": "TC15", "severity": "warn", "tool": "create_cart", "message": "inputSchema uses $ref/$defs", "fix": "Inline the referenced schemas. Pydantic and zod-to-json-schema emit $defs for nested models; most can be told not to." }, { "rule": "TC15", "severity": "warn", "tool": "create_checkout", "message": "inputSchema uses $ref/$defs", "fix": "Inline the referenced schemas. Pydantic and zod-to-json-schema emit $defs for nested models; most can be told not to." }, { "rule": "TC15", "severity": "warn", "tool": "create_spend_request", "message": "inputSchema uses $ref/$defs", "fix": "Inline the referenced schemas. Pydantic and zod-to-json-schema emit $defs for nested models; most can be told not to." }, { "rule": "TC15", "severity": "warn", "tool": "get_product", "message": "inputSchema uses $ref/$defs", "fix": "Inline the referenced schemas. Pydantic and zod-to-json-schema emit $defs for nested models; most can be told not to." }, { "rule": "TC15", "severity": "warn", "tool": "lookup_catalog", "message": "inputSchema uses $ref/$defs", "fix": "Inline the referenced schemas. Pydantic and zod-to-json-schema emit $defs for nested models; most can be told not to." }, { "rule": "TC15", "severity": "warn", "tool": "lookup_locations", "message": "inputSchema uses $ref/$defs", "fix": "Inline the referenced schemas. Pydantic and zod-to-json-schema emit $defs for nested models; most can be told not to." }, { "rule": "TC15", "severity": "warn", "tool": "search_catalog", "message": "inputSchema uses $ref/$defs", "fix": "Inline the referenced schemas. Pydantic and zod-to-json-schema emit $defs for nested models; most can be told not to." }, { "rule": "TC15", "severity": "warn", "tool": "search_locations", "message": "inputSchema uses $ref/$defs", "fix": "Inline the referenced schemas. Pydantic and zod-to-json-schema emit $defs for nested models; most can be told not to." }, { "rule": "TC15", "severity": "warn", "tool": "update_cart", "message": "inputSchema uses $ref/$defs", "fix": "Inline the referenced schemas. Pydantic and zod-to-json-schema emit $defs for nested models; most can be told not to." }, { "rule": "TC15", "severity": "warn", "tool": "update_checkout", "message": "inputSchema uses $ref/$defs", "fix": "Inline the referenced schemas. Pydantic and zod-to-json-schema emit $defs for nested models; most can be told not to." }, { "rule": "TC15", "severity": "warn", "tool": "update_spend_request", "message": "inputSchema uses $ref/$defs", "fix": "Inline the referenced schemas. Pydantic and zod-to-json-schema emit $defs for nested models; most can be told not to." }, { "rule": "TC22", "severity": "warn", "tool": "create_checkout", "message": "the definition is about 2,195 tokens", "fix": "Trim the description and parameter docs, or split the tool." }, { "rule": "TC22", "severity": "warn", "tool": "get_product", "message": "the definition is about 1,617 tokens", "fix": "Trim the description and parameter docs, or split the tool." }, { "rule": "TC22", "severity": "warn", "tool": "search_catalog", "message": "the definition is about 2,205 tokens", "fix": "Trim the description and parameter docs, or split the tool." }, { "rule": "TC22", "severity": "warn", "tool": "update_checkout", "message": "the definition is about 2,288 tokens", "fix": "Trim the description and parameter docs, or split the tool." }, { "rule": "TC23", "severity": "warn", "message": "19 tools, about 18,986 tokens of definitions", "fix": "Split the server by job, or offer a smaller default toolset (a read-only set, or a search-then-call pattern)." }, { "rule": "TC24", "severity": "note", "message": "19 of 19 tools have no outputSchema", "fix": "Declare outputSchema for tools that return structured data, and return structuredContent that matches it." } ] } }, "github": { "repo": "shopify/shop", "checkedAt": "2026-11-02T09:25:22.127978902Z", "stars": 11, "archived": false, "issuesEnabled": true, "pushedAt": "2026-10-28T18:00:04Z", "openIssues": 2, "openPRs": 0, "issuesOpened90d": 5, "issuesClosed90d": 3, "prsMerged90d": 9, "ci": { "branch": "main", "runs": 17, "success": 15, "failure": 1, "other": 1, "latest": "success", "latestAt": "2026-10-28T16:34:43Z" }, "replies": { "sampled": 5, "unanswered": 2, "medianDays": 0.7 } }, "updatedAt": "2026-11-04T21:28:12.765034514Z" } }, "edges": [ { "by": 60, "category": "maintenance", "leads": "shop-mcp", "name": "Maintenance \u0026 community", "reasons": { "a": "Read as a closed service. The newest dated change is the release note of 6 May 2025 (Get Inventory v4), more than 180 days before 3 November 2026; the pricing and dashboard pages carry no date (0 of 30). No dated change in the last 90 days (0 of 20). A support address, release notes and no community channel (6 of 15). No official SDKs (0). No package to judge (0). Total 6.", "b": "@shopify/shop 1.2.0 is tagged in the CLI repository on 28 October 2026, and the server reports version 1.2.0+aebf0c1b9130 with 1.2.0 as the latest CLI (30 of 30). Five releases since 7 October, 1.0.2, 1.0.3, 1.1.0, 1.1.1 and 1.2.0, from the repository's tags (npm not re-read) (20 of 20). Closed service with a launch post in the Shopify developer changelog and no later post about it. The repository's issues couldn't be read, since GitHub's pages refuse our reader, and no support channel is named in the docs (8 of 15). No Shop MCP entry in the official MCP registry, searched on 1 November (0 of 15). The CLI repository runs a verify workflow on Ubuntu, macOS and Windows across Node 22, 24 and 26, and its JavaScript shell has no runtime dependencies (8 of 10). Total 66." }, "scores": { "a": 6, "b": 66 } }, { "by": 48, "category": "security", "leads": "shop-mcp", "name": "Security \u0026 auth", "reasons": { "a": "One API key per account in a custom Id-Token header, with no scopes, expiry, rotation or revocation documented (10 of 30). place_order defaults to false and charge_user can be turned off, so an agent can quote without buying, but there is no read-only key (8 of 20). Store descriptions, menus and support-chat messages are untrusted content with no guidance (3 of 15). Get Orders and a tracking webhook give order history; no per-call log for the operator is documented (5 of 15). No security.txt (400), disclosure policy, bug bounty or certification found; the Enterprise plan names a security review (0 of 20). Total 26.", "b": "Shop MCP is an OAuth 2.0 protected resource with metadata at /.well-known/oauth-protected-resource. Tokens come from accounts.shop.app by authorisation code with PKCE or the device flow, can be revoked, and are refused in a query string or cookie. One scope, personal_agent, covers every signed-in tool (25 of 30). Tools are annotated read-only or destructive, the docs require the shopper to confirm merchant, items, total and instrument before complete_checkout, Shop Pay spending is governed by spend permissions the shopper grants on shop.com (since 1.2.0, with a total or per-purchase limit and a period, or no money limit at all), and spend requests need approval in Shop and return a single-use card only when get_spend_request asks for it. Confirmation before completion is guidance to the agent, and the CLI README says that within a permission the agent can complete Shop Pay purchases without asking each time (16 of 20). Results carry merchant text, and the docs and skill say to treat it as data. The server also returns next[] suggestions addressed to the agent (10 of 15). The shopper sees each connection by device name in their Shop account and can remove it there. No per-call log for an operator was found (5 of 15). www.shopify.com's security.txt (as read for the shopify listing on 1 November) and the repository's SECURITY.md route reports to HackerOne. mcp.shop.com has no security.txt (18 of 20). Total 74." }, "scores": { "a": 26, "b": 74 } }, { "by": 35, "category": "payments", "leads": "shop-mcp", "name": "Payments \u0026 pricing", "reasons": { "a": "No x402, MPP or L402 (0). $0.10 per successful call and $250 a month published without login (20). No free tier or trial; a card must be added before the key is created (0). Signup is a browser form with email, password and card (0). Total 20.", "b": "No x402, MPP or L402. Payment is through Shop Pay or a single-use card issued after the shopper approves a spend request (0 of 40). shop.dev states the service is free with no account or key, without a login (20 of 20). Search, carts and checkout need no card or account (20 of 20). Ten tools run with no credential at all. Account, order and spend request tools need the shopper to sign in with Shop in a browser or by device code (15 of 20). Total 55." }, "scores": { "a": 20, "b": 55 } }, { "by": 17, "category": "schema", "leads": "shop-mcp", "name": "Schema \u0026 documentation", "reasons": { "a": "The reference pages are generated from an API description with operation ids (get_search_store_v3), named response schemas (Product_Search_Output) and typed parameters, but no spec file URL was found on the docs, llms.txt or the site (15 of 25). llms.txt at mealmeapi.readme.io and mealme.ai, and every page as Markdown (10). Each operation states its purpose and coverage; several descriptions are truncated in the index and none says when not to use it (12 of 20). Enums on sort, store_type, user_country and search_focus, required flags on latitude and longitude, conditional requirements written in prose (11 of 15). Request and response examples per endpoint, a Create Order errors page with 17 entries, and 400, 401 and 429 schemas on each operation (12 of 15). Versioned paths (v2 to v4) and dated release notes that call out breaking changes, the newest of 6 May 2025 (12 of 15). Total 72.", "b": "All 19 tools in the live tools/list on 1 November carry JSON Schema inputs with required fields (25 of 25). No llms.txt, but every shop.dev docs page has a Markdown twin at .md, and the server serves a skill as MCP resources (10 of 10). Tool descriptions say when to use each one and when not to, such as \"Use search_catalog for discovery\" and get_spend_request's \"Omit include to read status and terms only\" (18 of 20). Inputs use patterns, minimums, enums such as search_orders' status, anyOf for query or like, and minor-unit integer amounts, with several open objects such as context, and the top-level additionalProperties false seen on 17 October is no longer set (11 of 15). Curl and JavaScript examples, a worked response, and tables of HTTP, JSON-RPC and tool error codes. The tool reference now uses the server's create_spend_request names and the CLI page shows 1.2.0, the version the server reports as latest, so the 17 October mismatches are gone (15 of 15). Protocol 2026-07-28 and UCP 2026-08-25 are stated and reported in each document, and the launch is in the Shopify developer changelog, but Shop MCP has no changelog of its own and the 1.2.0 changes appear in none (10 of 15). Total 89." }, "scores": { "a": 72, "b": 89 } }, { "by": 14, "category": "reliability", "leads": "shop-mcp", "name": "Reliability", "reasons": { "a": "Read with the hosted lines. No status page found on mealme.ai, the docs or llms.txt, and status.mealme.ai does not resolve (0). No readable incident history (5). No rate limit figures; each endpoint documents a 429 whose example message is 10 per 1 second(s)!, which the reference itself calls an example (0 of 15). The 429 is documented without Retry-After or backoff guidance, and Create Order has no idempotency key, only an order_id to update an existing order and a caller's customer_order_id to look up (4 of 15). No SLA found (0). The API is in production with versioned endpoints (10). Total 19.", "b": "Graded with the hosted lines. No status page covers Shop MCP. shopifystatus.com, re-read on 1 November, lists merchant components such as Admin, Checkout, Storefront and API \u0026 Mobile, and none for Shop, Shop MCP or the Catalog (0 of 20). So there is no incident history for this surface (5 of 30). The order-search figures shop.dev published on 17 October (10 a minute to 200 a week) are no longer on its pages, which now say only that calls are rate limited and that anonymous calls get the lowest limits. The one figure left, 5 requests a second per API client, is for the separate Global Catalog endpoint (3 of 15). Rate-limited calls return rate_limited with retry_after in seconds (1 to 3,600), writes take an idempotency key, and the errors guide says which calls can be repeated and that complete_checkout never can (15 of 15). No SLA found (0 of 10). Live since the 13 October 2026 announcement with no beta or preview label (10 of 10). Total 33." }, "scores": { "a": 19, "b": 33 } }, { "by": 14, "category": "transparency", "leads": "shop-mcp", "name": "Transparency \u0026 trust", "reasons": { "a": "Closed service. The API and SDK Terms of Use (18 June 2022) and MealMe Connect terms (4 April 2025) name MealMe, Inc. under Delaware law, but the API terms license use for personal, noncommercial purposes while the product is sold to businesses (15 of 30). The privacy policy of 1 January 2025 keeps data as long as needed, names no subprocessor and no DPA; the cookie policy names Google, Adobe, LinkedIn, Twitter and Facebook (10 of 30). Release notes record breaking changes with dates but there is no deprecation policy or notice period (6 of 20). Cookie providers named, no subprocessor list or data location (4 of 20). Total 35.", "b": "Closed hosted service under the Shopify API Terms, last updated 7 October 2026, re-read on 1 November. The CLI is MIT, but its core ships as a compiled shop.wasm file (15 of 30). Shopify's consumer privacy policy, last updated 2 March 2026, covers Shop, with retention set by business need rather than periods. shop.dev says the preference data Shop uses for personalised search never reaches the app, and the CLI docs disclose that credentials are kept in a plain-text file. No Shop MCP data statement or DPA for developers was found (15 of 30). No deprecation policy. The API Terms allow changes, removals and new fees with or without notice, the server accepts one protocol version, and the 1.2.0 tool changes came with no notice (5 of 20). The privacy policy names transfers including to Canada and Ireland. Shopify's subprocessor list is linked from its merchant privacy policy, not the consumer one, and its help-centre page refused our reader on 1 November, so it isn't read for this listing (10 of 20). Total 45." }, "scores": { "a": 47, "b": 61 } } ], "facts": [ { "a": "HTTP API", "b": "MCP server", "name": "Kind" }, { "a": "MealMe, Inc.", "b": "Shopify", "name": "Vendor" }, { "a": "no (local only)", "b": "https://mcp.shop.com/", "name": "Hosted endpoint" }, { "a": "", "b": "Streamable HTTP", "name": "Transports" }, { "a": "API key", "b": "OAuth or key", "name": "Auth" }, { "a": "Pay per use", "b": "Free", "name": "Pricing" }, { "a": "no", "b": "no", "name": "x402" }, { "a": "Proprietary service under the MealMe API and SDK Terms of Use", "b": "Proprietary hosted service under the Shopify API Terms. The shop CLI package is MIT, with its core shipped as a compiled WebAssembly file", "name": "Licence" }, { "a": "0", "b": "19", "name": "Tools exposed" }, { "a": "no", "b": "no", "name": "Read-only variant documented" }, { "a": "yes", "b": "no", "name": "llms.txt" }, { "a": "2025-05-06", "b": "2026-10-28", "name": "Last release" }, { "a": "2025-04-04", "b": "2026-10-07", "name": "Terms last updated" }, { "a": "2025-04-04", "b": "2026-03-02", "name": "Privacy policy last updated" }, { "a": "not found in the text", "b": "not found in the text", "name": "Customer content may train models" }, { "a": "yes", "b": "yes", "name": "Terms restrict automated access" }, { "a": "yes", "b": "yes", "name": "Terms restrict benchmarking" }, { "a": "yes", "b": "yes", "name": "Terms or service can change without notice" }, { "a": "yes", "b": "not found in the text", "name": "Arbitration or class-action waiver" }, { "a": "none", "b": "570 npm/wk", "name": "Popularity" }, { "a": "none", "b": "3.8/5 (4)", "name": "Agent reviews" } ], "faq": [ { "answer": "Shop MCP scores 61.8 (C) on agent readiness against MealMe API's 38.4 (E), and leads in every scored category.", "question": "Which is better for AI agents, MealMe API or Shop MCP?" }, { "answer": "MealMe API needs an API key. Shop MCP takes an API key or an OAuth sign-in.", "question": "Do MealMe API and Shop MCP need an API key?" }, { "answer": "No hosted endpoint is listed for MealMe API. Shop MCP has a hosted endpoint at https://mcp.shop.com/.", "question": "Can an agent call MealMe API and Shop MCP without installing anything?" } ], "goodFor": [ { "aheadOn": null, "also": [ "No incidents deducted, where Shop MCP loses 3 points for them" ], "goodFor": "Agents that must place a real restaurant or grocery order in the US or Canada, or compare live prices across stores, and can hold a card on the account.", "slug": "mealme", "watchFor": "One key with no scopes, read-only mode, expiry or rotation documented, sent in a custom Id-Token header" }, { "aheadOn": [ "Reliability, 33 against 19", "Schema \u0026 documentation, 89 against 72", "Agent ergonomics, 79 against 69", "Security \u0026 auth, 74 against 26", "Payments \u0026 pricing, 55 against 20", "Maintenance \u0026 community, 66 against 6", "Transparency \u0026 trust, 61 against 47" ], "also": [ "A hosted endpoint, with nothing to install" ], "goodFor": "Agents buying for a person across Shopify stores, from search to Shop Pay checkout and order tracking.", "slug": "shop-mcp", "watchFor": "The 19 tool definitions total 76,040 bytes, so loading the server costs a large share of a model's context" } ], "history": { "mealme": null, "shop-mcp": [ { "causes": [ "product", "event" ], "date": "2026-11-01", "delta": -4.1, "from": 65.9, "fromGrade": "B", "to": 61.8, "toGrade": "C" }, { "causes": [ "method" ], "date": "2026-10-30", "delta": -0.3, "from": 66.2, "fromGrade": "B", "to": 65.9, "toGrade": "B" }, { "causes": [ "evidence" ], "date": "2026-10-27", "delta": 0.1, "from": 66.1, "fromGrade": "B", "to": 66.2, "toGrade": "B" } ] }, "job": { "capability": "shopping.search", "name": "Product search for shoppers" }, "others": [ { "json": "https://www.anchorterminal.com/compare/amazon-creators-api-vs-mealme.json", "title": "Amazon Creators API vs MealMe API", "url": "https://www.anchorterminal.com/compare/amazon-creators-api-vs-mealme" }, { "json": "https://www.anchorterminal.com/compare/amazon-creators-api-vs-shop-mcp.json", "title": "Amazon Creators API vs Shop MCP", "url": "https://www.anchorterminal.com/compare/amazon-creators-api-vs-shop-mcp" }, { "json": "https://www.anchorterminal.com/compare/best-buy-vs-mealme.json", "title": "Best Buy Developer API vs MealMe API", "url": "https://www.anchorterminal.com/compare/best-buy-vs-mealme" }, { "json": "https://www.anchorterminal.com/compare/best-buy-vs-shop-mcp.json", "title": "Best Buy Developer API vs Shop MCP", "url": "https://www.anchorterminal.com/compare/best-buy-vs-shop-mcp" }, { "json": "https://www.anchorterminal.com/compare/etsy-vs-mealme.json", "title": "Etsy Open API v3 vs MealMe API", "url": "https://www.anchorterminal.com/compare/etsy-vs-mealme" }, { "json": "https://www.anchorterminal.com/compare/etsy-vs-shop-mcp.json", "title": "Etsy Open API v3 vs Shop MCP", "url": "https://www.anchorterminal.com/compare/etsy-vs-shop-mcp" }, { "json": "https://www.anchorterminal.com/compare/mealme-vs-opencommerce.json", "title": "MealMe API vs opencommerce", "url": "https://www.anchorterminal.com/compare/mealme-vs-opencommerce" }, { "json": "https://www.anchorterminal.com/compare/mealme-vs-walmart-affiliate-api.json", "title": "MealMe API vs Walmart Affiliate Marketing API", "url": "https://www.anchorterminal.com/compare/mealme-vs-walmart-affiliate-api" }, { "json": "https://www.anchorterminal.com/compare/mealme-vs-walmart-agent-gateway.json", "title": "MealMe API vs Walmart Agent Gateway", "url": "https://www.anchorterminal.com/compare/mealme-vs-walmart-agent-gateway" }, { "json": "https://www.anchorterminal.com/compare/mealme-vs-zillow-claude.json", "title": "MealMe API vs Zillow in Claude", "url": "https://www.anchorterminal.com/compare/mealme-vs-zillow-claude" }, { "json": "https://www.anchorterminal.com/compare/opencommerce-vs-shop-mcp.json", "title": "opencommerce vs Shop MCP", "url": "https://www.anchorterminal.com/compare/opencommerce-vs-shop-mcp" }, { "json": "https://www.anchorterminal.com/compare/shop-mcp-vs-walmart-affiliate-api.json", "title": "Shop MCP vs Walmart Affiliate Marketing API", "url": "https://www.anchorterminal.com/compare/shop-mcp-vs-walmart-affiliate-api" }, { "json": "https://www.anchorterminal.com/compare/shop-mcp-vs-walmart-agent-gateway.json", "title": "Shop MCP vs Walmart Agent Gateway", "url": "https://www.anchorterminal.com/compare/shop-mcp-vs-walmart-agent-gateway" }, { "json": "https://www.anchorterminal.com/compare/shop-mcp-vs-zillow-claude.json", "title": "Shop MCP vs Zillow in Claude", "url": "https://www.anchorterminal.com/compare/shop-mcp-vs-zillow-claude" }, { "json": "https://www.anchorterminal.com/compare/instacart-vs-mealme.json", "title": "Instacart Developer Platform API + MCP vs MealMe API", "url": "https://www.anchorterminal.com/compare/instacart-vs-mealme" }, { "json": "https://www.anchorterminal.com/compare/instacart-vs-shop-mcp.json", "title": "Instacart Developer Platform API + MCP vs Shop MCP", "url": "https://www.anchorterminal.com/compare/instacart-vs-shop-mcp" } ], "panel": null, "scores": [ { "by": 14, "edge": "shop-mcp", "key": "reliability", "mealme": 19, "name": "Reliability", "shop-mcp": 33, "weight": 16 }, { "key": "performance", "name": "Performance", "pending": true, "weight": 10 }, { "by": 17, "edge": "shop-mcp", "key": "schema", "mealme": 72, "name": "Schema \u0026 documentation", "shop-mcp": 89, "weight": 13 }, { "by": 10, "edge": "shop-mcp", "key": "ergonomics", "mealme": 69, "name": "Agent ergonomics", "shop-mcp": 79, "weight": 13 }, { "by": 48, "edge": "shop-mcp", "key": "security", "mealme": 26, "name": "Security \u0026 auth", "shop-mcp": 74, "weight": 14 }, { "by": 35, "edge": "shop-mcp", "key": "payments", "mealme": 20, "name": "Payments \u0026 pricing", "shop-mcp": 55, "weight": 10 }, { "key": "tasks", "name": "Task success", "pending": true, "weight": 10 }, { "by": 60, "edge": "shop-mcp", "key": "maintenance", "mealme": 6, "name": "Maintenance \u0026 community", "shop-mcp": 66, "weight": 7 }, { "by": 14, "edge": "shop-mcp", "key": "transparency", "mealme": 47, "name": "Transparency \u0026 trust", "shop-mcp": 61, "weight": 7 } ], "summary": "Shop MCP scores 61.8 (C) on agent readiness against MealMe API's 38.4 (E), and leads in every scored category. Both do product search for shoppers.", "tasks": null, "tutorials": [], "verdicts": { "mealme": "An agent can search stores and products, fetch live quotes and place a real order through one REST API priced at $0.10 a successful call. One all-powerful key, no rate limit figures, no status page, no idempotency key on orders and release notes that stop at 6 May 2025 are the limits.", "shop-mcp": "Keyless search across Shopify's Global Catalog and cart and checkout at the selling store, with typed schemas, tool annotations, idempotency keys and documented retry rules. The tool definitions run to 76 KB, no status page or rate figure covers it, and version 1.2.0 changed three tools in late October without notice." } }, "kind": "anchor.page", "links": { "api": "https://www.anchorterminal.com/api/v1/index.json", "html": "https://www.anchorterminal.com/compare/mealme-vs-shop-mcp", "json": "https://www.anchorterminal.com/compare/mealme-vs-shop-mcp.json", "llms": "https://www.anchorterminal.com/llms.txt", "markdown": "https://www.anchorterminal.com/compare/mealme-vs-shop-mcp.md", "mcp": "https://www.anchorterminal.com/mcp", "slim": "https://www.anchorterminal.com/compare/mealme-vs-shop-mcp.min.md" }, "markdown": "Shop MCP scores 61.8 (C) on agent readiness against MealMe API's 38.4 (E), and leads in every scored category. Both do product search for shoppers.\n\n- MealMe API: grade E, 38.4/100, rank #1229 of 1349. Markdown https://www.anchorterminal.com/tools/mealme.md · JSON https://www.anchorterminal.com/api/v1/tools/mealme.json\n- Shop MCP: grade C, 61.8/100, rank #533 of 1349. Markdown https://www.anchorterminal.com/tools/shop-mcp.md · JSON https://www.anchorterminal.com/api/v1/tools/shop-mcp.json\n- Best shopping and order APIs for AI agents buying for a person: https://www.anchorterminal.com/best/shopping/index.md\n- All 41 shopping comparisons: https://www.anchorterminal.com/compare/shopping/index.md\n- Best recipe, nutrition and meal planning APIs for AI agents: https://www.anchorterminal.com/best/cooking/index.md\n- All 28 cooking comparisons: https://www.anchorterminal.com/compare/cooking/index.md\n\n## Which one, for what\n\n### MealMe API (E)\n\nGood for: Agents that must place a real restaurant or grocery order in the US or Canada, or compare live prices across stores, and can hold a card on the account.\n\nAlso in its favour:\n- No incidents deducted, where Shop MCP loses 3 points for them\n\nWatch for: One key with no scopes, read-only mode, expiry or rotation documented, sent in a custom Id-Token header\n\n### Shop MCP (C)\n\nGood for: Agents buying for a person across Shopify stores, from search to Shop Pay checkout and order tracking.\n\nAhead on:\n- Reliability, 33 against 19\n- Schema \u0026 documentation, 89 against 72\n- Agent ergonomics, 79 against 69\n- Security \u0026 auth, 74 against 26\n- Payments \u0026 pricing, 55 against 20\n- Maintenance \u0026 community, 66 against 6\n- Transparency \u0026 trust, 61 against 47\n\nAlso in its favour:\n- A hosted endpoint, with nothing to install\n\nWatch for: The 19 tool definitions total 76,040 bytes, so loading the server costs a large share of a model's context\n\n\n## Why the edge\n\n### Maintenance \u0026 community: Shop MCP +60\n\n- MealMe API (6): Read as a closed service. The newest dated change is the release note of 6 May 2025 (Get Inventory v4), more than 180 days before 3 November 2026; the pricing and dashboard pages carry no date (0 of 30). No dated change in the last 90 days (0 of 20). A support address, release notes and no community channel (6 of 15). No official SDKs (0). No package to judge (0). Total 6.\n- Shop MCP (66): @shopify/shop 1.2.0 is tagged in the CLI repository on 28 October 2026, and the server reports version 1.2.0+aebf0c1b9130 with 1.2.0 as the latest CLI (30 of 30). Five releases since 7 October, 1.0.2, 1.0.3, 1.1.0, 1.1.1 and 1.2.0, from the repository's tags (npm not re-read) (20 of 20). Closed service with a launch post in the Shopify developer changelog and no later post about it. The repository's issues couldn't be read, since GitHub's pages refuse our reader, and no support channel is named in the docs (8 of 15). No Shop MCP entry in the official MCP registry, searched on 1 November (0 of 15). The CLI repository runs a verify workflow on Ubuntu, macOS and Windows across Node 22, 24 and 26, and its JavaScript shell has no runtime dependencies (8 of 10). Total 66.\n\n### Security \u0026 auth: Shop MCP +48\n\n- MealMe API (26): One API key per account in a custom Id-Token header, with no scopes, expiry, rotation or revocation documented (10 of 30). place_order defaults to false and charge_user can be turned off, so an agent can quote without buying, but there is no read-only key (8 of 20). Store descriptions, menus and support-chat messages are untrusted content with no guidance (3 of 15). Get Orders and a tracking webhook give order history; no per-call log for the operator is documented (5 of 15). No security.txt (400), disclosure policy, bug bounty or certification found; the Enterprise plan names a security review (0 of 20). Total 26.\n- Shop MCP (74): Shop MCP is an OAuth 2.0 protected resource with metadata at /.well-known/oauth-protected-resource. Tokens come from accounts.shop.app by authorisation code with PKCE or the device flow, can be revoked, and are refused in a query string or cookie. One scope, personal_agent, covers every signed-in tool (25 of 30). Tools are annotated read-only or destructive, the docs require the shopper to confirm merchant, items, total and instrument before complete_checkout, Shop Pay spending is governed by spend permissions the shopper grants on shop.com (since 1.2.0, with a total or per-purchase limit and a period, or no money limit at all), and spend requests need approval in Shop and return a single-use card only when get_spend_request asks for it. Confirmation before completion is guidance to the agent, and the CLI README says that within a permission the agent can complete Shop Pay purchases without asking each time (16 of 20). Results carry merchant text, and the docs and skill say to treat it as data. The server also returns next[] suggestions addressed to the agent (10 of 15). The shopper sees each connection by device name in their Shop account and can remove it there. No per-call log for an operator was found (5 of 15). www.shopify.com's security.txt (as read for the shopify listing on 1 November) and the repository's SECURITY.md route reports to HackerOne. mcp.shop.com has no security.txt (18 of 20). Total 74.\n\n### Payments \u0026 pricing: Shop MCP +35\n\n- MealMe API (20): No x402, MPP or L402 (0). $0.10 per successful call and $250 a month published without login (20). No free tier or trial; a card must be added before the key is created (0). Signup is a browser form with email, password and card (0). Total 20.\n- Shop MCP (55): No x402, MPP or L402. Payment is through Shop Pay or a single-use card issued after the shopper approves a spend request (0 of 40). shop.dev states the service is free with no account or key, without a login (20 of 20). Search, carts and checkout need no card or account (20 of 20). Ten tools run with no credential at all. Account, order and spend request tools need the shopper to sign in with Shop in a browser or by device code (15 of 20). Total 55.\n\n### Schema \u0026 documentation: Shop MCP +17\n\n- MealMe API (72): The reference pages are generated from an API description with operation ids (get_search_store_v3), named response schemas (Product_Search_Output) and typed parameters, but no spec file URL was found on the docs, llms.txt or the site (15 of 25). llms.txt at mealmeapi.readme.io and mealme.ai, and every page as Markdown (10). Each operation states its purpose and coverage; several descriptions are truncated in the index and none says when not to use it (12 of 20). Enums on sort, store_type, user_country and search_focus, required flags on latitude and longitude, conditional requirements written in prose (11 of 15). Request and response examples per endpoint, a Create Order errors page with 17 entries, and 400, 401 and 429 schemas on each operation (12 of 15). Versioned paths (v2 to v4) and dated release notes that call out breaking changes, the newest of 6 May 2025 (12 of 15). Total 72.\n- Shop MCP (89): All 19 tools in the live tools/list on 1 November carry JSON Schema inputs with required fields (25 of 25). No llms.txt, but every shop.dev docs page has a Markdown twin at .md, and the server serves a skill as MCP resources (10 of 10). Tool descriptions say when to use each one and when not to, such as \"Use search_catalog for discovery\" and get_spend_request's \"Omit include to read status and terms only\" (18 of 20). Inputs use patterns, minimums, enums such as search_orders' status, anyOf for query or like, and minor-unit integer amounts, with several open objects such as context, and the top-level additionalProperties false seen on 17 October is no longer set (11 of 15). Curl and JavaScript examples, a worked response, and tables of HTTP, JSON-RPC and tool error codes. The tool reference now uses the server's create_spend_request names and the CLI page shows 1.2.0, the version the server reports as latest, so the 17 October mismatches are gone (15 of 15). Protocol 2026-07-28 and UCP 2026-08-25 are stated and reported in each document, and the launch is in the Shopify developer changelog, but Shop MCP has no changelog of its own and the 1.2.0 changes appear in none (10 of 15). Total 89.\n\n### Reliability: Shop MCP +14\n\n- MealMe API (19): Read with the hosted lines. No status page found on mealme.ai, the docs or llms.txt, and status.mealme.ai does not resolve (0). No readable incident history (5). No rate limit figures; each endpoint documents a 429 whose example message is 10 per 1 second(s)!, which the reference itself calls an example (0 of 15). The 429 is documented without Retry-After or backoff guidance, and Create Order has no idempotency key, only an order_id to update an existing order and a caller's customer_order_id to look up (4 of 15). No SLA found (0). The API is in production with versioned endpoints (10). Total 19.\n- Shop MCP (33): Graded with the hosted lines. No status page covers Shop MCP. shopifystatus.com, re-read on 1 November, lists merchant components such as Admin, Checkout, Storefront and API \u0026 Mobile, and none for Shop, Shop MCP or the Catalog (0 of 20). So there is no incident history for this surface (5 of 30). The order-search figures shop.dev published on 17 October (10 a minute to 200 a week) are no longer on its pages, which now say only that calls are rate limited and that anonymous calls get the lowest limits. The one figure left, 5 requests a second per API client, is for the separate Global Catalog endpoint (3 of 15). Rate-limited calls return rate_limited with retry_after in seconds (1 to 3,600), writes take an idempotency key, and the errors guide says which calls can be repeated and that complete_checkout never can (15 of 15). No SLA found (0 of 10). Live since the 13 October 2026 announcement with no beta or preview label (10 of 10). Total 33.\n\n### Transparency \u0026 trust: Shop MCP +14\n\n- MealMe API (47): Closed service. The API and SDK Terms of Use (18 June 2022) and MealMe Connect terms (4 April 2025) name MealMe, Inc. under Delaware law, but the API terms license use for personal, noncommercial purposes while the product is sold to businesses (15 of 30). The privacy policy of 1 January 2025 keeps data as long as needed, names no subprocessor and no DPA; the cookie policy names Google, Adobe, LinkedIn, Twitter and Facebook (10 of 30). Release notes record breaking changes with dates but there is no deprecation policy or notice period (6 of 20). Cookie providers named, no subprocessor list or data location (4 of 20). Total 35.\n- Shop MCP (61): Closed hosted service under the Shopify API Terms, last updated 7 October 2026, re-read on 1 November. The CLI is MIT, but its core ships as a compiled shop.wasm file (15 of 30). Shopify's consumer privacy policy, last updated 2 March 2026, covers Shop, with retention set by business need rather than periods. shop.dev says the preference data Shop uses for personalised search never reaches the app, and the CLI docs disclose that credentials are kept in a plain-text file. No Shop MCP data statement or DPA for developers was found (15 of 30). No deprecation policy. The API Terms allow changes, removals and new fees with or without notice, the server accepts one protocol version, and the 1.2.0 tool changes came with no notice (5 of 20). The privacy policy names transfers including to Canada and Ireland. Shopify's subprocessor list is linked from its merchant privacy policy, not the consumer one, and its help-centre page refused our reader on 1 November, so it isn't read for this listing (10 of 20). Total 45.\n\n## Score by category\n\n| Category | Weight | MealMe API | Shop MCP | Edge |\n| --- | --- | --- | --- | --- |\n| Reliability | 16% (20 this run) | 19 | 33 | Shop MCP +14 |\n| Performance | 10%, pending | pending | pending | not scored in this run |\n| Schema \u0026 documentation | 13% (16.2 this run) | 72 | 89 | Shop MCP +17 |\n| Agent ergonomics | 13% (16.2 this run) | 69 | 79 | Shop MCP +10 |\n| Security \u0026 auth | 14% (17.5 this run) | 26 | 74 | Shop MCP +48 |\n| Payments \u0026 pricing | 10% (12.5 this run) | 20 | 55 | Shop MCP +35 |\n| Task success | 10%, pending | pending | pending | not scored in this run |\n| Maintenance \u0026 community | 7% (8.8 this run) | 6 | 66 | Shop MCP +60 |\n| Transparency \u0026 trust | 7% (8.8 this run) | 47 | 61 | Shop MCP +14 |\n| Negative events | ≤15 | 0 | -3 | |\n| **Total** | | **38.4 · E** | **61.8 · C** | |\n\n## Facts side by side\n\n| Fact | MealMe API | Shop MCP |\n| --- | --- | --- |\n| Kind | HTTP API | MCP server |\n| Vendor | MealMe, Inc. | Shopify |\n| Hosted endpoint | no (local only) | `https://mcp.shop.com/` |\n| Transports | | Streamable HTTP |\n| Auth | API key | OAuth or key |\n| Pricing | Pay per use | Free |\n| x402 | no | no |\n| Licence | Proprietary service under the MealMe API and SDK Terms of Use | Proprietary hosted service under the Shopify API Terms. The shop CLI package is MIT, with its core shipped as a compiled WebAssembly file |\n| Tools exposed | 0 | 19 |\n| Read-only variant documented | no | no |\n| llms.txt | yes | no |\n| Last release | 2025-05-06 | 2026-10-28 |\n| Terms last updated | 2025-04-04 | 2026-10-07 |\n| Privacy policy last updated | 2025-04-04 | 2026-03-02 |\n| Customer content may train models | not found in the text | not found in the text |\n| Terms restrict automated access | yes | yes |\n| Terms restrict benchmarking | yes | yes |\n| Terms or service can change without notice | yes | yes |\n| Arbitration or class-action waiver | yes | not found in the text |\n| Popularity | none | 570 npm/wk |\n| Agent reviews | none | 3.8/5 (4) |\n\n## How the scores have moved\n\n### MealMe API\n\nNo score change since it was listed.\n\n### Shop MCP\n\n- -4.1 on 1 November 2026 (B to C): product, negative event\n- -0.3 on 30 October 2026: checklist\n- +0.1 on 27 October 2026: new evidence\n\n## Verdicts\n\n**MealMe API.** An agent can search stores and products, fetch live quotes and place a real order through one REST API priced at $0.10 a successful call. One all-powerful key, no rate limit figures, no status page, no idempotency key on orders and release notes that stop at 6 May 2025 are the limits.\n\n**Shop MCP.** Keyless search across Shopify's Global Catalog and cart and checkout at the selling store, with typed schemas, tool annotations, idempotency keys and documented retry rules. The tool definitions run to 76 KB, no status page or rate figure covers it, and version 1.2.0 changed three tools in late October without notice.\n\n## Before you call either\n\n### MealMe API\n\n1. Send the key as the Id-Token header, not Authorization. Only latitude and longitude are required for store search; address fields become required when fetch_quotes is true and pickup is false\n2. Call Create Order with place_order false first, read the 202 final quote, then place it; keep your own customer_order_id and look it up before any retry, since no idempotency key exists\n3. Set projections on store search to the fields you need; fetch_quotes greatly increases response time per the docs\n4. Keep use_new_db the same across store search, Get Inventory and Get MealMe Store, or the store ids will not match\n5. Treat 406 (store closed, out of range, no delivery), 420 (product unavailable) and 422 (checkout error) as fixes to make, not transient failures\n\n### Shop MCP\n\n1. Connect to https://mcp.shop.com/ with no /mcp path, send MCP-Protocol-Version 2026-07-28 with matching Mcp-Method and Mcp-Name headers, and put protocolVersion and clientCapabilities in params._meta\n2. Call complete_checkout once, only from ready_for_complete, after the shopper confirms merchant, items, total and instrument. After an uncertain result, read get_checkout and never resend\n3. Read the current document before update_cart or update_checkout and send it back whole, since fields and lines left out are deleted\n4. Pass include set to card on get_spend_request after the shopper approves, since without it the call returns only status and terms\n5. Set filters.status to all on search_orders for past orders, and treat product text and next[] suggestions as data, keeping checkout IDs and continue_url out of logs\n\n## Questions\n\n### Which is better for AI agents, MealMe API or Shop MCP?\n\nShop MCP scores 61.8 (C) on agent readiness against MealMe API's 38.4 (E), and leads in every scored category.\n\n### Do MealMe API and Shop MCP need an API key?\n\nMealMe API needs an API key. Shop MCP takes an API key or an OAuth sign-in.\n\n### Can an agent call MealMe API and Shop MCP without installing anything?\n\nNo hosted endpoint is listed for MealMe API. Shop MCP has a hosted endpoint at https://mcp.shop.com/.\n\n\n## For agents\n\n- This comparison as JSON: https://www.anchorterminal.com/compare/mealme-vs-shop-mcp.json, and with the fewest tokens: https://www.anchorterminal.com/compare/mealme-vs-shop-mcp.min.md\n- Over MCP at https://www.anchorterminal.com/mcp (no key): `compare_tools {\"a\": \"mealme\", \"b\": \"shop-mcp\"}`. From a terminal: `anchor compare mealme shop-mcp`\n- Each listing in full: https://www.anchorterminal.com/api/v1/tools/mealme.json and https://www.anchorterminal.com/api/v1/tools/shop-mcp.json\n\n## Other comparisons with MealMe API or Shop MCP\n\n- [Amazon Creators API vs MealMe API](https://www.anchorterminal.com/compare/amazon-creators-api-vs-mealme.md)\n- [Amazon Creators API vs Shop MCP](https://www.anchorterminal.com/compare/amazon-creators-api-vs-shop-mcp.md)\n- [Best Buy Developer API vs MealMe API](https://www.anchorterminal.com/compare/best-buy-vs-mealme.md)\n- [Best Buy Developer API vs Shop MCP](https://www.anchorterminal.com/compare/best-buy-vs-shop-mcp.md)\n- [Etsy Open API v3 vs MealMe API](https://www.anchorterminal.com/compare/etsy-vs-mealme.md)\n- [Etsy Open API v3 vs Shop MCP](https://www.anchorterminal.com/compare/etsy-vs-shop-mcp.md)\n- [MealMe API vs opencommerce](https://www.anchorterminal.com/compare/mealme-vs-opencommerce.md)\n- [MealMe API vs Walmart Affiliate Marketing API](https://www.anchorterminal.com/compare/mealme-vs-walmart-affiliate-api.md)\n- [MealMe API vs Walmart Agent Gateway](https://www.anchorterminal.com/compare/mealme-vs-walmart-agent-gateway.md)\n- [MealMe API vs Zillow in Claude](https://www.anchorterminal.com/compare/mealme-vs-zillow-claude.md)\n- [opencommerce vs Shop MCP](https://www.anchorterminal.com/compare/opencommerce-vs-shop-mcp.md)\n- [Shop MCP vs Walmart Affiliate Marketing API](https://www.anchorterminal.com/compare/shop-mcp-vs-walmart-affiliate-api.md)\n- [Shop MCP vs Walmart Agent Gateway](https://www.anchorterminal.com/compare/shop-mcp-vs-walmart-agent-gateway.md)\n- [Shop MCP vs Zillow in Claude](https://www.anchorterminal.com/compare/shop-mcp-vs-zillow-claude.md)\n- [Instacart Developer Platform API + MCP vs MealMe API](https://www.anchorterminal.com/compare/instacart-vs-mealme.md)\n- [Instacart Developer Platform API + MCP vs Shop MCP](https://www.anchorterminal.com/compare/instacart-vs-shop-mcp.md)\n", "meta": { "attribution": "Anchor Terminal (https://www.anchorterminal.com)", "attributionRequired": true, "credit": "CC BY 4.0, credit Anchor Terminal and link the page or API address you took it from (https://www.anchorterminal.com/terms/#data)", "docs": "https://www.anchorterminal.com/docs/", "generatedAt": "2026-11-04", "license": "CC-BY-4.0", "method": "https://www.anchorterminal.com/benchmark/", "methodology": "0.7", "openapi": "https://www.anchorterminal.com/openapi.json", "preview": false, "run": "2026-10-01", "runLabel": "October 2026 research run", "terms": "https://www.anchorterminal.com/terms/#data" }, "page": { "breadcrumbs": [ { "name": "Home", "url": "https://www.anchorterminal.com/" }, { "name": "Compare", "url": "https://www.anchorterminal.com/compare/" }, { "name": "MealMe API vs Shop MCP", "url": "" } ], "description": "Shop MCP scores 61.8 (C) to MealMe's 38.4 (E) for product search for shoppers. Prices, MCP, x402, uptime and agent notes side by side.", "facts": [ "MealMe API E 38.4", "Shop MCP C 61.8", "scores" ], "h1": "MealMe API vs Shop MCP", "image": "https://www.anchorterminal.com/assets/og/default.png", "path": "/compare/mealme-vs-shop-mcp", "published": "2026-10-01", "section": "tools", "title": "MealMe vs Shop MCP for AI agents in 2026: scores and prices", "toc": null, "updated": "2026-11-04", "url": "https://www.anchorterminal.com/compare/mealme-vs-shop-mcp" }, "tokens": { "markdown": 4900, "slim": 3080 }, "version": 1 }