{
  "data": {
    "a": {
      "slug": "shop-mcp",
      "name": "Shop MCP",
      "vendor": "Shopify",
      "vendorUrl": "https://shop.dev/",
      "company": "shopify.com",
      "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": 65.3,
        "grade": "B",
        "agentReady": false,
        "rank": 540,
        "ranked": true,
        "rankOf": 1557,
        "categoryRank": 2,
        "methodology": "1.0",
        "run": "2026-10-01",
        "scores": {
          "ergonomics": 79,
          "maintenance": 66,
          "payments": 83,
          "reliability": 33,
          "schema": 89,
          "security": 74,
          "transparency": 61
        },
        "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": "B",
            "methodology": "1.0",
            "run": "2026-10-01",
            "runLabel": "October 2026 research run",
            "score": 65.3
          }
        ],
        "editorialScores": {
          "ergonomics": 79,
          "maintenance": 66,
          "payments": 83,
          "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-13",
          "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"
      },
      "sameCompany": [
        "shopify"
      ],
      "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-18T23:13:50.277563499Z",
          "lastOk": true,
          "lastStatus": 200,
          "lastMs": 220,
          "lastNote": "answered, but not with an initialize result",
          "authRequired": false,
          "uptime24h": 100,
          "uptime30d": 100,
          "p50ms24h": 156,
          "p95ms24h": 386,
          "samples24h": 241,
          "samples30d": 7842,
          "days": [
            {
              "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": 246,
              "ok": 246
            },
            {
              "date": "2026-11-05",
              "probes": 185,
              "ok": 185
            },
            {
              "date": "2026-11-06",
              "probes": 241,
              "ok": 241
            },
            {
              "date": "2026-11-07",
              "probes": 243,
              "ok": 243
            },
            {
              "date": "2026-11-08",
              "probes": 243,
              "ok": 243
            },
            {
              "date": "2026-11-09",
              "probes": 243,
              "ok": 243
            },
            {
              "date": "2026-11-10",
              "probes": 244,
              "ok": 244
            },
            {
              "date": "2026-11-11",
              "probes": 244,
              "ok": 244
            },
            {
              "date": "2026-11-12",
              "probes": 245,
              "ok": 245
            },
            {
              "date": "2026-11-13",
              "probes": 238,
              "ok": 238
            },
            {
              "date": "2026-11-14",
              "probes": 244,
              "ok": 244
            },
            {
              "date": "2026-11-15",
              "probes": 243,
              "ok": 243
            },
            {
              "date": "2026-11-16",
              "probes": 243,
              "ok": 243
            },
            {
              "date": "2026-11-17",
              "probes": 242,
              "ok": 242
            },
            {
              "date": "2026-11-18",
              "probes": 233,
              "ok": 233
            }
          ],
          "since": "2026-10-17T00:00:00Z"
        },
        "versions": [
          {
            "registry": "github",
            "name": "Shopify/shop",
            "version": "v1.3.0",
            "released": "2026-11-10",
            "seenAt": "2026-11-18T18:28:34.625760871Z"
          },
          {
            "registry": "npm",
            "name": "@shopify/shop",
            "version": "1.3.0",
            "seenAt": "2026-11-18T18:28:33.384308874Z"
          }
        ],
        "githubStars": 20,
        "npmWeekly": 385,
        "securityTxt": {
          "url": "https://shop.com/.well-known/security.txt",
          "state": "unknown",
          "checkedAt": "2026-11-18T16:30:33.399976289Z"
        },
        "domain": {
          "domain": "shop.com",
          "registered": "1994-06-02",
          "source": "https://rdap.verisign.com/com/v1/domain/shop.com",
          "checkedAt": "2026-11-15T15:20:05.01908779Z"
        },
        "pages": [
          {
            "url": "https://shopify.dev/changelog",
            "kind": "changelog",
            "status": 200,
            "checkedAt": "2026-11-18T21:53:56.383613179Z",
            "changedAt": "2026-11-18T21:53:56.383613179Z",
            "fingerprint": "3c06bdb19312"
          },
          {
            "url": "https://www.shopify.com/legal/privacy/consumers",
            "kind": "privacy",
            "status": 200,
            "checkedAt": "2026-11-18T22:09:20.52888129Z",
            "changedAt": "2026-11-10T16:46:13.597833775Z",
            "fingerprint": "aaf9597bcf3b"
          },
          {
            "url": "https://www.shopify.com/legal/api-terms",
            "kind": "terms",
            "status": 200,
            "checkedAt": "2026-11-18T22:09:16.184242634Z",
            "changedAt": "2026-11-10T16:46:09.050947866Z",
            "fingerprint": "a443a7f2903c"
          }
        ],
        "mcpTools": {
          "url": "https://mcp.shop.com/",
          "checkedAt": "2026-11-18T04:28:35.970694785Z",
          "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": "get_order",
              "description": "Read one order or package tracked by the signed-in buyer's Shop account. Use the unchanged id from search_orders.orders or search_orders.shipments; unknown purchase facts are omitted. Requires sign-in.",
              "inputSchema": {
                "properties": {
                  "id": {
                    "description": "Shop order or package ID from search_orders, pass it unchanged.",
                    "maxLength": 128,
                    "minLength": 1,
                    "type": "string"
                  }
                },
                "required": [
                  "id"
                ],
                "type": "object"
              },
              "annotations": {
                "destructiveHint": false,
                "idempotentHint": true,
                "openWorldHint": true,
                "readOnlyHint": true
              }
            },
            {
              "name": "search_catalog",
              "description": "Find and compare offers by query/like. For an item found elsewhere without a usable ID or URL, search by brand and product name for a possible match, not proof of the same listing. 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 missing 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"
                                      },
                                      "media": {
                                        "description": "Require product media by type; each entry is one type and entries combine with AND. Unrecognized types are ignored and reported in messages[].",
                                        "items": {
                                          "properties": {
                                            "type": {
                                              "description": "image, video, external_video or model_3d.",
                                              "type": "string"
                                            }
                                          },
                                          "required": [
                                            "type"
                                          ],
                                          "type": "object"
                                        },
                                        "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": 1,
                            "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": "Look for matching offers using product/variant IDs, GTINs, UPCs, or public product URLs, including items found elsewhere. Match returned variant inputs to each identifier (exact versus featured); confirm seller and selected options before treating it as the same offer. A miss does not prove the original item unavailable. Use search_catalog for discovery or possible matches without a usable identifier; get_product only for missing facts. Preserve IDs/URLs; 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, including items found elsewhere resolved through lookup_catalog. 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": "ask_business",
              "description": "Ask shop a free-form question about its policies, services or facts it has published — returns, shipping thresholds, warranties, support hours — and get a plain-text answer. Read-only: nothing is created, changed or bought. Use catalog tools for what a product is or costs, location tools for stores, and the checkout or order for an order. One shop per call; include every detail in the question (no memory between calls).",
              "inputSchema": {
                "$defs": {
                  "d0": {
                    "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/d1"
                                },
                                "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/d1"
                                        }
                                      ],
                                      "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"
                      },
                      "conversation": {
                        "description": "Continue a conversation the shop returned by sending its id back; omit to start fresh. Shops may not support continuation, so put everything the question needs in query.",
                        "properties": {
                          "expires_at": {
                            "description": "When the shop may forget the conversation; informational.",
                            "format": "date-time",
                            "type": "string"
                          },
                          "id": {
                            "description": "The id the shop returned.",
                            "type": "string"
                          }
                        },
                        "required": [
                          "id"
                        ],
                        "type": "object"
                      },
                      "ids": {
                        "description": "IDs of the shop's resources the question is about: a variant id from catalog results, a collection, or a cart id as the cart returned it. They ground the answer in those products; an ID the shop did not use is named in messages[].",
                        "items": {
                          "type": "string"
                        },
                        "type": "array"
                      },
                      "query": {
                        "description": "The question, in the user's words, with every detail it depends on (which product, which country, which order).",
                        "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/d1"
                            }
                          ]
                        },
                        "title": "Signals",
                        "type": "object"
                      }
                    },
                    "required": [
                      "query"
                    ],
                    "type": "object"
                  },
                  "d1": {
                    "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": {
                  "ask": {
                    "$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": [
                  "ask",
                  "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": 20289,
          "changedAt": "2026-11-10T02:31:17.130311649Z",
          "check": {
            "checker": "anchor-check/1.0",
            "totalTokens": 20289,
            "counts": {
              "error": 0,
              "note": 1,
              "warn": 50
            },
            "findings": [
              {
                "rule": "TC11",
                "severity": "warn",
                "tool": "ask_business",
                "message": "1 parameter without a description: ask",
                "fix": "Describe each one: format, units, an example, and what happens when it's left out."
              },
              {
                "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": "ask_business",
                "message": "ask (object with no properties)",
                "fix": "Declare the properties (or additionalProperties with a schema) and the array's items."
              },
              {
                "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": "ask_business",
                "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": "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,633 tokens",
                "fix": "Trim the description and parameter docs, or split the tool."
              },
              {
                "rule": "TC22",
                "severity": "warn",
                "tool": "lookup_catalog",
                "message": "the definition is about 1,512 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,327 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": "21 tools, about 20,297 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": "21 of 21 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-16T13:01:45.593684891Z",
          "stars": 19,
          "archived": false,
          "issuesEnabled": true,
          "pushedAt": "2026-11-10T22:04:51Z",
          "openIssues": 1,
          "openPRs": 0,
          "issuesOpened90d": 4,
          "issuesClosed90d": 3,
          "prsMerged90d": 10,
          "ci": {
            "branch": "main",
            "runs": 20,
            "success": 17,
            "failure": 2,
            "other": 1,
            "latest": "success",
            "latestAt": "2026-11-10T22:05:16Z"
          },
          "replies": {
            "sampled": 4,
            "unanswered": 0,
            "medianDays": 4.9
          }
        },
        "updatedAt": "2026-11-18T23:13:50.277563499Z"
      },
      "streak": {
        "days": 32,
        "from": "2026-10-17",
        "sinceWatching": true,
        "best": 32
      }
    },
    "answer": "Zinc scores 69.9 (B) on agent readiness against Shop MCP's 65.3 (B), and leads in 5 of 7 scored categories. Shop MCP leads on security \u0026 auth.",
    "b": {
      "slug": "zinc",
      "name": "Zinc",
      "vendor": "Zinc",
      "vendorUrl": "https://www.zinc.com",
      "company": "zinc.com",
      "kind": "http-api",
      "category": "shopping",
      "summary": "Zinc is an API for buying from online retailers such as Amazon, Walmart and Target, covering product search, orders, tracking and returns. Agents can pay per order by x402, MPP or Link without an account.",
      "url": "https://www.anchorterminal.com/tools/zinc",
      "markdownUrl": "https://www.anchorterminal.com/tools/zinc.md",
      "slimMarkdownUrl": "https://www.anchorterminal.com/tools/zinc.min.md",
      "jsonUrl": "https://www.anchorterminal.com/api/v1/tools/zinc.json",
      "dns": "zinc.grade.anchorterminal.com",
      "repo": "https://github.com/zincio/skills",
      "license": "Proprietary service, agent skills MIT",
      "transports": [
        "streamable-http"
      ],
      "remoteUrl": "https://mcp.zinc.com/mcp",
      "packages": [
        {
          "registry": "npm",
          "name": "zinc"
        }
      ],
      "auth": "mixed",
      "authNotes": "Bearer API key (`zn_test_` sandbox, `zn_live_` live). `POST /sandbox/keys` mints a sandbox key with no authentication. A live key for an agent comes from a device-code flow a person approves in a browser. `/agent/*` routes need no key and take payment by x402 or MPP, returning an `X-Api-Key` to follow the order. The MCP connector needs no account to buy.",
      "pricing": "usage",
      "pricingNotes": "$1 per successful order plus the item cost, and $0.01 per data call. Add $0.25 for tracking links and emails, and $0.10 per item over 10. Failed orders aren't billed. Sandbox free with no card, and a $5 starter credit on the first approved live key. Wallet top-ups carry card, ACH or wire fees. Volume pricing from 1,000 orders a month.",
      "priceSummary": "$1 / tx",
      "where": "hosted",
      "x402": {
        "level": "partial",
        "evidence": "`POST /agent/orders` answers 402 with one challenge per rail, x402 v2 in `PAYMENT-REQUIRED` (USDC on Base and Solana, sponsored settlement), and MPP in `WWW-Authenticate` for Tempo and for Link Shared Payment Tokens. The amount is `max_price` plus the $1 fee, and the unused part is refunded. The `/agent/*` data endpoints use the same flow at $0.01 a call on Tempo and x402 only. Other routes need an API key (https://www.zinc.com/docs/v2/agentic-purchases.md, checked 2026-11-18). Not probed.",
        "endpoints": [
          {
            "url": "https://api.zinc.com/agent/orders",
            "priceUsd": null,
            "network": "eip155:8453"
          }
        ]
      },
      "toolCount": 8,
      "popularity": {
        "githubStars": null,
        "npmWeekly": null,
        "pypiWeekly": null,
        "asOf": "2026-11-18"
      },
      "docsUrl": "https://www.zinc.com/docs",
      "llmsTxt": "https://www.zinc.com/llms.txt",
      "openapi": "https://api.zinc.com/openapi.json",
      "registryName": "com.zinc.www/mcp",
      "capabilities": [
        "shopping.search",
        "shopping.orders",
        "shopping.returns",
        "shopping.prices",
        "payments.x402",
        "payments.protocol"
      ],
      "tags": [
        "hosted",
        "usage",
        "x402",
        "mpp",
        "stablecoin",
        "no-card",
        "sandbox",
        "mcp",
        "remote-mcp",
        "mcp-registry",
        "llms-txt",
        "openapi",
        "typescript"
      ],
      "lastRelease": "2026-11-13",
      "graded": true,
      "anchor": {
        "graded": true,
        "score": 69.9,
        "grade": "B",
        "agentReady": false,
        "rank": 320,
        "ranked": true,
        "rankOf": 1557,
        "categoryRank": 1,
        "methodology": "1.0",
        "run": "2026-10-01",
        "scores": {
          "ergonomics": 86,
          "maintenance": 83,
          "payments": 98,
          "reliability": 55,
          "schema": 92,
          "security": 57,
          "transparency": 60
        },
        "assessment": {
          "confidence": "medium",
          "date": "2026-11-18"
        },
        "negative": 0,
        "warnings": [
          {
            "kind": "operator-unidentified",
            "name": "Operator not identified",
            "text": "Zinc's terms name Zinc Technologies Inc. under California law, with no place of registration, registration number or address. OpenCorporates and SEC EDGAR refused our reader (403), so no register entry was found.",
            "deduct": 0,
            "capGrade": "B",
            "since": "2026-11-18",
            "sources": [
              "https://www.zinc.com/legal/terms",
              "https://www.zinc.com/legal/privacy"
            ]
          }
        ],
        "verdict": "An agent can mint a sandbox key with no signup and pay for real orders by x402, MPP or Link with no account, at $1 an order plus the item, with idempotency keys and a public OpenAPI file. Orders run on Zinc's own retailer accounts by default, and no security programme or numeric rate limits were found.",
        "bestFor": "Agents that need to buy physical goods from US retailers for a person, with machine payment and no account.",
        "strengths": [
          "`POST /agent/orders` takes payment in the request by x402 (USDC on Base or Solana), MPP on Tempo or Link, with no account or key",
          "`POST /sandbox/keys` mints a test key with no authentication, and a person approves a live key by device code in a browser",
          "Public OpenAPI 3.1 file (53 operations), llms.txt, llms-full.txt and Markdown copies of every docs page",
          "$1 per successful order and $0.01 per data call, published without login. Failed orders aren't billed and the unspent `max_price` is refunded",
          "Idempotency keys on orders and wallet top-ups, and a 409 with the existing order's id on a duplicate"
        ],
        "weaknesses": [
          "By default orders run on retailer accounts Zinc runs, and its docs index lists a guide to Amazon's anti-bot pages and one on proxies \"for account protection\"",
          "No security.txt, disclosure policy, bug bounty or certification found",
          "No numeric request rate limits published, apart from 5 sandbox keys per IP address a day",
          "The status page shows 99.1 per cent uptime for ordering and 99.57 per cent for the API over 90 days, with no incident write-ups",
          "Metered data endpoints answer 402 with a bare `detail` string instead of the documented error envelope"
        ],
        "agentNotes": [
          "Call `GET /retailers/check` with the product URL and country before ordering, since unsupported retailers and countries fail predictably",
          "Set `max_price` and an `idempotency_key` on every order. If a retry returns 409, read the existing order id from `error.details.order_id`",
          "If your HTTP client merges `WWW-Authenticate` headers, add `?method=x402`, `?method=tempo` or `?method=stripe` to get one payment challenge",
          "Store the `X-Api-Key` returned with a paid agent order. It is the only way to follow that order without paying again",
          "Persist a sandbox key across runs. It expires after 7 days without use, and minting is limited to 5 a day per IP address"
        ],
        "metrics": {
          "kind": "remote",
          "measured": false
        },
        "reviewCount": 0,
        "avgRating": 0,
        "history": [
          {
            "basis": "public evidence",
            "confidence": "medium",
            "grade": "B",
            "methodology": "1.0",
            "run": "2026-10-01",
            "runLabel": "October 2026 research run",
            "score": 69.9
          }
        ],
        "editorialScores": {
          "ergonomics": 86,
          "maintenance": 83,
          "payments": 98,
          "reliability": 55,
          "schema": 92,
          "security": 57,
          "transparency": 46
        },
        "provenanceScore": 73,
        "checked": {
          "categories": {
            "ergonomics": "2026-11-18",
            "maintenance": "2026-11-18",
            "payments": "2026-11-18",
            "reliability": "2026-11-18",
            "schema": "2026-11-18",
            "security": "2026-11-18",
            "transparency": "2026-11-18"
          },
          "last": "2026-11-18",
          "lastMoved": "2026-11-18",
          "oldest": "2026-11-18",
          "stale": false,
          "staleAfterDays": 90
        }
      },
      "connect": {
        "install": "npm i zinc",
        "http": "curl -X POST https://api.zinc.com/sandbox/keys",
        "claudeCode": "claude mcp add zinc --transport http https://mcp.zinc.com/mcp",
        "config": {
          "mcpServers": {
            "zinc": {
              "url": "https://mcp.zinc.com/mcp"
            }
          }
        },
        "x402": "https://api.zinc.com/agent/orders?method=x402"
      },
      "letme": {
        "capability": "https://letme.dev/shopping.search",
        "tool": "https://letme.dev/zinc"
      },
      "area": "everyday",
      "unitPrices": [
        {
          "item": "Successful order (Zinc fee, item cost extra)",
          "unit": "tx",
          "usd": 1,
          "note": "Failed orders aren't billed"
        },
        {
          "item": "Product data call",
          "unit": "call",
          "usd": 0.01,
          "note": "Search, product details and `offers`, on agent and keyed endpoints"
        },
        {
          "item": "Tracking links and emails add-on",
          "unit": "tx",
          "usd": 0.25,
          "note": "Per order"
        },
        {
          "item": "Extra item over 10 in one order",
          "unit": "tx",
          "usd": 0.1,
          "note": "Per item"
        }
      ],
      "provenance": {
        "legalEntity": "Zinc Technologies Inc.",
        "domain": "zinc.com",
        "domainRegistered": "",
        "domainNote": "Not looked up in this run.",
        "endpointOnVendorDomain": true,
        "terms": "https://www.zinc.com/legal/terms",
        "privacy": "https://www.zinc.com/legal/privacy",
        "statusPage": "https://www.zinc.com/status",
        "changelog": "https://www.zinc.com/docs/changelog",
        "securityTxt": "none",
        "checked": "2026-11-18",
        "notes": [
          "The terms (updated 12 October 2026) are with Zinc Technologies Inc., under California law with courts in Los Angeles County. No place of registration, registration number or address appears on the pages read.",
          "www.zinc.com's robots.txt allows all agents and carries Content-Signal ai-train=no, search=yes, ai-input=yes. api.zinc.com's robots.txt answered 404.",
          "www.zinc.com/.well-known/security.txt answered 404 on 18 November 2026.",
          "The terms forbid using the service to violate a retailer's terms \"in a way that harms Zinc or that Retailer\" and say purchases are subject to each retailer's terms."
        ],
        "score": 73
      },
      "pageJsonUrl": "https://www.anchorterminal.com/tools/zinc.json",
      "live": {
        "slug": "zinc",
        "probe": {
          "target": "https://mcp.zinc.com/mcp",
          "method": "get",
          "lastAt": "2026-11-18T23:14:03.67996308Z",
          "lastOk": true,
          "lastStatus": 204,
          "lastMs": 288,
          "authRequired": false,
          "uptime24h": 100,
          "uptime30d": 100,
          "p50ms24h": 473,
          "p95ms24h": 902,
          "samples24h": 16,
          "samples30d": 16,
          "days": [
            {
              "date": "2026-11-18",
              "probes": 16,
              "ok": 16
            }
          ],
          "since": "2026-11-18T21:38:42.096706069Z"
        },
        "vendorStatus": {
          "page": "https://www.zinc.com/status",
          "indicator": "unknown",
          "summary": "no machine-readable status found",
          "checkedAt": "2026-11-18T21:41:08.844643791Z"
        },
        "versions": [
          {
            "registry": "mcp-registry",
            "name": "com.zinc.www/mcp",
            "version": "1.0.0",
            "seenAt": "2026-11-18T22:45:57.054523297Z"
          }
        ],
        "updatedAt": "2026-11-18T23:14:03.67996308Z"
      },
      "streak": {
        "days": 0,
        "from": "2026-11-18",
        "sinceWatching": true,
        "best": 0
      }
    },
    "edges": [
      {
        "by": 22,
        "category": "reliability",
        "leads": "zinc",
        "name": "Reliability",
        "reasons": {
          "a": "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.",
          "b": "Zinc's own status page (www.zinc.com/status) shows five components (Ordering, Tracking, Product Data, API, Dashboard) with 90-day uptime bars (20). On 18 November 2026 it showed 99.1 per cent uptime for Ordering and 99.57 per cent for the API over 90 days, both recovered from a degradation that day. The page has no incident write-ups, and 99.1 per cent over 90 days is about 19 hours, so at least one major interruption is implied (10 of 30). No numeric request rate limits found, apart from 5 sandbox key mints per IP address a day (5 of 15). 429 carries `rate_limit_exceeded` with guidance to back off and retry, responses carry RateLimit and RateLimit-Policy headers (changelog, August 2026), and orders and top-ups take idempotency keys (15). No SLA found (0). Orders are generally available. Cross-retailer search and the Zinc 2.0 announcement carry a beta label (5 of 10). 20 + 10 + 5 + 15 + 0 + 5 = 55."
        },
        "scores": {
          "a": 33,
          "b": 55
        }
      },
      {
        "by": 17,
        "category": "security",
        "leads": "shop-mcp",
        "name": "Security \u0026 auth",
        "reasons": {
          "a": "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.",
          "b": "Bearer API keys, `zn_test_` for sandbox and `zn_live_` for live, and each agent can get its own live key by device-code approval. No scopes or rotation steps were found (18 of 30). Sandbox keys can't spend, every order carries a `max_price` cap, a person approves a live key in the browser, and the MCP connector's `place-order` needs a confirmation token withheld from the model (17 of 20). The MCP docs explain that the token is there so a prompt injection in a page can't become a purchase. Product data from retailers is untrusted text (12 of 15). Order timelines, a usage endpoint, CSV export and the dashboard show every order (10 of 15). No security.txt (404), disclosure policy, bug bounty, SOC 2 or ISO 27001 found (0). 18 + 17 + 12 + 10 + 0 = 57."
        },
        "scores": {
          "a": 74,
          "b": 57
        }
      },
      {
        "by": 17,
        "category": "maintenance",
        "leads": "zinc",
        "name": "Maintenance \u0026 community",
        "reasons": {
          "a": "@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.",
          "b": "The changelog's latest entry is dated 13 November 2026, and the npm SDK's latest version is 2026.10.30 (30). Weekly dated changelog entries, 13 since 20 August 2026 (20). A public weekly changelog and a support address (support@zinc.com) that the contact page says gets a person. GitHub issue response wasn't checked (10 of 25). The MCP connector is in the official MCP registry as `com.zinc.www/mcp`, published 28 October 2026 under Zinc's domain namespace, and the npm SDK is current (15). The npm SDK is generated from the live spec and published with provenance attestations (8 of 10). 30 + 20 + 10 + 15 + 8 = 83."
        },
        "scores": {
          "a": 66,
          "b": 83
        }
      },
      {
        "by": 15,
        "category": "payments",
        "leads": "zinc",
        "name": "Payments \u0026 pricing",
        "reasons": {
          "a": "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. Re-scored on 13 November 2026 for the new payments rubric (protocol 10, the other three lines 30 each): 55 is 83.",
          "b": "x402 (v2, USDC on Base and Solana) and MPP (Tempo, and Link with a Shared Payment Token) on `POST /agent/orders` and the `/agent/*` data endpoints. Returns, cases, managed accounts and webhooks need an API key (8 of 10). $1 per successful order plus the item, $0.25 for tracking links and emails, $0.10 per item over 10, and $0.01 per data call, published without login (30). A sandbox needs no account or card, and a device-approved live key comes with a $5 starter credit (30). An agent can pay per order with no account, or mint a sandbox key with one unauthenticated call (30). 8 + 30 + 30 + 30 = 98."
        },
        "scores": {
          "a": 83,
          "b": 98
        }
      },
      {
        "by": 7,
        "category": "ergonomics",
        "leads": "zinc",
        "name": "Agent ergonomics",
        "reasons": {
          "a": "19 tools sits in the 11 to 30 band (15), but the definitions total 76,040 bytes (65,541 on 17 October), with update_checkout, search_catalog and create_checkout each over 9 KB, and there are no toolsets or read-only subsets. Five less than the band for size, a departure from the checklist (10 of 25). Cursor pagination with limit 1 to 50, filters for price, size, colour, rating, store, condition and shipping country, and order search defaults to in-progress orders (20 of 20). Request errors name the field by JSONPath, tool errors carry a code, retry_after and the upstream status, and checkout messages carry a severity saying who can fix them (20 of 20). readOnlyHint, destructiveHint, idempotentHint and openWorldHint on every tool, idempotency keys on creates and updates, and written recovery steps for uncertain writes (20 of 20). Search needs only catalog.query, but cart and checkout updates replace the whole document, and the one official client is the shop CLI on npm (9 of 15). Total 79.",
          "b": "Search returns up to 20 results, best first, and data and order calls are separate routes, so responses stay small. No field selection found (20 of 25). List and export endpoints take filters, and orders can be listed, exported and followed by webhook (18 of 20). Errors carry a stable `code`, a message and `details`, including `details.fund_with` on `insufficient_funds` and RFC 8628 hints in the device flow (20). Idempotency keys on orders, agent orders and top-ups, a 409 that names the existing order, and an MCP spending tool that needs a confirmation token only a person's click produces. MCP annotations weren't read (18 of 20). Few required fields, and an official npm SDK (`zinc`, CalVer from the live spec). No second official SDK was confirmed (10 of 15). 20 + 18 + 20 + 18 + 10 = 86."
        },
        "scores": {
          "a": 79,
          "b": 86
        }
      }
    ],
    "facts": [
      {
        "a": "MCP server",
        "b": "HTTP API",
        "name": "Kind"
      },
      {
        "a": "Shopify",
        "b": "Zinc",
        "name": "Vendor"
      },
      {
        "a": "https://mcp.shop.com/",
        "b": "https://mcp.zinc.com/mcp",
        "name": "Hosted endpoint"
      },
      {
        "a": "Streamable HTTP",
        "b": "Streamable HTTP",
        "name": "Transports"
      },
      {
        "a": "OAuth or key",
        "b": "OAuth or key",
        "name": "Auth"
      },
      {
        "a": "Free",
        "b": "Pay per use",
        "name": "Pricing"
      },
      {
        "a": "no",
        "b": "on some endpoints",
        "name": "x402"
      },
      {
        "a": "Proprietary hosted service under the Shopify API Terms. The shop CLI package is MIT, with its core shipped as a compiled WebAssembly file",
        "b": "Proprietary service, agent skills MIT",
        "name": "Licence"
      },
      {
        "a": "19",
        "b": "8",
        "name": "Tools exposed"
      },
      {
        "a": "no",
        "b": "no",
        "name": "Read-only variant documented"
      },
      {
        "a": "no",
        "b": "yes",
        "name": "llms.txt"
      },
      {
        "a": "not listed",
        "b": "com.zinc.www/mcp",
        "name": "MCP registry"
      },
      {
        "a": "2026-10-28",
        "b": "2026-11-13",
        "name": "Last release"
      },
      {
        "a": "2026-10-07",
        "b": "2026-10-12",
        "name": "Terms last updated"
      },
      {
        "a": "2026-03-02",
        "b": "2026-10-06",
        "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": "not found in the text",
        "name": "Terms restrict automated access"
      },
      {
        "a": "yes",
        "b": "yes",
        "name": "Terms restrict benchmarking"
      },
      {
        "a": "yes",
        "b": "not found in the text",
        "name": "Terms or service can change without notice"
      },
      {
        "a": "not found in the text",
        "b": "yes",
        "name": "Arbitration or class-action waiver"
      },
      {
        "a": "570 npm/wk",
        "b": "none",
        "name": "Popularity"
      },
      {
        "a": "3.8/5 (4)",
        "b": "none",
        "name": "Agent reviews"
      }
    ],
    "faq": [
      {
        "answer": "Zinc scores 69.9 (B) on agent readiness against Shop MCP's 65.3 (B), and leads in 5 of 7 scored categories. Shop MCP leads on security \u0026 auth.",
        "question": "Which is better for AI agents, Shop MCP or Zinc?"
      },
      {
        "answer": "Both take an API key or an OAuth sign-in.",
        "question": "Do Shop MCP and Zinc need an API key?"
      },
      {
        "answer": "Yes. Shop MCP has a hosted endpoint at https://mcp.shop.com/ and Zinc at https://mcp.zinc.com/mcp.",
        "question": "Can an agent call Shop MCP and Zinc without installing anything?"
      }
    ],
    "goodFor": [
      {
        "aheadOn": [
          "Security \u0026 auth, 74 against 57"
        ],
        "also": null,
        "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"
      },
      {
        "aheadOn": [
          "Reliability, 55 against 33",
          "Agent ergonomics, 86 against 79",
          "Payments \u0026 pricing, 98 against 83",
          "Maintenance \u0026 community, 83 against 66"
        ],
        "also": [
          "Free to start without a card",
          "No incidents deducted, where Shop MCP loses 3 points for them"
        ],
        "goodFor": "Agents that need to buy physical goods from US retailers for a person, with machine payment and no account.",
        "slug": "zinc",
        "watchFor": "By default orders run on retailer accounts Zinc runs, and its docs index lists a guide to Amazon's anti-bot pages and one on proxies \"for account protection\""
      }
    ],
    "history": {
      "shop-mcp": [
        {
          "causes": [
            "method"
          ],
          "date": "2026-11-13",
          "delta": 3.5,
          "from": 61.8,
          "fromGrade": "C",
          "to": 65.3,
          "toGrade": "B"
        },
        {
          "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"
        }
      ],
      "zinc": null
    },
    "job": {
      "capability": "shopping.search",
      "name": "Product search for shoppers"
    },
    "others": [
      {
        "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/amazon-creators-api-vs-zinc.json",
        "title": "Amazon Creators API vs Zinc",
        "url": "https://www.anchorterminal.com/compare/amazon-creators-api-vs-zinc"
      },
      {
        "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/best-buy-vs-zinc.json",
        "title": "Best Buy Developer API vs Zinc",
        "url": "https://www.anchorterminal.com/compare/best-buy-vs-zinc"
      },
      {
        "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/etsy-vs-zinc.json",
        "title": "Etsy Open API v3 vs Zinc",
        "url": "https://www.anchorterminal.com/compare/etsy-vs-zinc"
      },
      {
        "json": "https://www.anchorterminal.com/compare/mealme-vs-shop-mcp.json",
        "title": "MealMe API vs Shop MCP",
        "url": "https://www.anchorterminal.com/compare/mealme-vs-shop-mcp"
      },
      {
        "json": "https://www.anchorterminal.com/compare/mealme-vs-zinc.json",
        "title": "MealMe API vs Zinc",
        "url": "https://www.anchorterminal.com/compare/mealme-vs-zinc"
      },
      {
        "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/opencommerce-vs-zinc.json",
        "title": "opencommerce vs Zinc",
        "url": "https://www.anchorterminal.com/compare/opencommerce-vs-zinc"
      },
      {
        "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/walmart-affiliate-api-vs-zinc.json",
        "title": "Walmart Affiliate Marketing API vs Zinc",
        "url": "https://www.anchorterminal.com/compare/walmart-affiliate-api-vs-zinc"
      },
      {
        "json": "https://www.anchorterminal.com/compare/zillow-claude-vs-zinc.json",
        "title": "Zillow in Claude vs Zinc",
        "url": "https://www.anchorterminal.com/compare/zillow-claude-vs-zinc"
      },
      {
        "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"
      },
      {
        "json": "https://www.anchorterminal.com/compare/walmart-agent-gateway-vs-zinc.json",
        "title": "Walmart Agent Gateway vs Zinc",
        "url": "https://www.anchorterminal.com/compare/walmart-agent-gateway-vs-zinc"
      }
    ],
    "panel": null,
    "scores": [
      {
        "by": 22,
        "edge": "zinc",
        "key": "reliability",
        "name": "Reliability",
        "shop-mcp": 33,
        "weight": 16,
        "zinc": 55
      },
      {
        "key": "performance",
        "name": "Performance",
        "pending": true,
        "weight": 10
      },
      {
        "by": 3,
        "edge": "zinc",
        "key": "schema",
        "name": "Schema \u0026 documentation",
        "shop-mcp": 89,
        "weight": 13,
        "zinc": 92
      },
      {
        "by": 7,
        "edge": "zinc",
        "key": "ergonomics",
        "name": "Agent ergonomics",
        "shop-mcp": 79,
        "weight": 13,
        "zinc": 86
      },
      {
        "by": 17,
        "edge": "shop-mcp",
        "key": "security",
        "name": "Security \u0026 auth",
        "shop-mcp": 74,
        "weight": 14,
        "zinc": 57
      },
      {
        "by": 15,
        "edge": "zinc",
        "key": "payments",
        "name": "Payments \u0026 pricing",
        "shop-mcp": 83,
        "weight": 10,
        "zinc": 98
      },
      {
        "key": "tasks",
        "name": "Task success",
        "pending": true,
        "weight": 10
      },
      {
        "by": 17,
        "edge": "zinc",
        "key": "maintenance",
        "name": "Maintenance \u0026 community",
        "shop-mcp": 66,
        "weight": 7,
        "zinc": 83
      },
      {
        "by": 1,
        "edge": "shop-mcp",
        "key": "transparency",
        "name": "Transparency \u0026 trust",
        "shop-mcp": 61,
        "weight": 7,
        "zinc": 60
      }
    ],
    "summary": "Zinc scores 69.9 (B) on agent readiness against Shop MCP's 65.3 (B), and leads in 5 of 7 scored categories. Shop MCP leads on security \u0026 auth. Both do product search for shoppers.",
    "tasks": null,
    "tutorials": [],
    "verdicts": {
      "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.",
      "zinc": "An agent can mint a sandbox key with no signup and pay for real orders by x402, MPP or Link with no account, at $1 an order plus the item, with idempotency keys and a public OpenAPI file. Orders run on Zinc's own retailer accounts by default, and no security programme or numeric rate limits were found."
    }
  },
  "kind": "anchor.page",
  "links": {
    "api": "https://www.anchorterminal.com/api/v1/index.json",
    "html": "https://www.anchorterminal.com/compare/shop-mcp-vs-zinc",
    "json": "https://www.anchorterminal.com/compare/shop-mcp-vs-zinc.json",
    "llms": "https://www.anchorterminal.com/llms.txt",
    "markdown": "https://www.anchorterminal.com/compare/shop-mcp-vs-zinc.md",
    "mcp": "https://www.anchorterminal.com/mcp",
    "slim": "https://www.anchorterminal.com/compare/shop-mcp-vs-zinc.min.md"
  },
  "markdown": "Zinc scores 69.9 (B) on agent readiness against Shop MCP's 65.3 (B), and leads in 5 of 7 scored categories. Shop MCP leads on security \u0026 auth. Both do product search for shoppers.\n\n- Shop MCP: grade B, 65.3/100, rank #540 of 1557. Markdown https://www.anchorterminal.com/tools/shop-mcp.md · JSON https://www.anchorterminal.com/api/v1/tools/shop-mcp.json\n- Zinc: grade B, 69.9/100, rank #320 of 1557. Markdown https://www.anchorterminal.com/tools/zinc.md · JSON https://www.anchorterminal.com/api/v1/tools/zinc.json\n- Best shopping and order APIs for AI agents buying for a person: https://www.anchorterminal.com/best/shopping/index.md\n- All 50 shopping comparisons: https://www.anchorterminal.com/compare/shopping/index.md\n\n## Which one, for what\n\n### Shop MCP (B)\n\nGood for: Agents buying for a person across Shopify stores, from search to Shop Pay checkout and order tracking.\n\nAhead on:\n- Security \u0026 auth, 74 against 57\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### Zinc (B)\n\nGood for: Agents that need to buy physical goods from US retailers for a person, with machine payment and no account.\n\nAhead on:\n- Reliability, 55 against 33\n- Agent ergonomics, 86 against 79\n- Payments \u0026 pricing, 98 against 83\n- Maintenance \u0026 community, 83 against 66\n\nAlso in its favour:\n- Free to start without a card\n- No incidents deducted, where Shop MCP loses 3 points for them\n\nWatch for: By default orders run on retailer accounts Zinc runs, and its docs index lists a guide to Amazon's anti-bot pages and one on proxies \"for account protection\"\n\n\n## Why the edge\n\n### Reliability: Zinc +22\n\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- Zinc (55): Zinc's own status page (www.zinc.com/status) shows five components (Ordering, Tracking, Product Data, API, Dashboard) with 90-day uptime bars (20). On 18 November 2026 it showed 99.1 per cent uptime for Ordering and 99.57 per cent for the API over 90 days, both recovered from a degradation that day. The page has no incident write-ups, and 99.1 per cent over 90 days is about 19 hours, so at least one major interruption is implied (10 of 30). No numeric request rate limits found, apart from 5 sandbox key mints per IP address a day (5 of 15). 429 carries `rate_limit_exceeded` with guidance to back off and retry, responses carry RateLimit and RateLimit-Policy headers (changelog, August 2026), and orders and top-ups take idempotency keys (15). No SLA found (0). Orders are generally available. Cross-retailer search and the Zinc 2.0 announcement carry a beta label (5 of 10). 20 + 10 + 5 + 15 + 0 + 5 = 55.\n\n### Security \u0026 auth: Shop MCP +17\n\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- Zinc (57): Bearer API keys, `zn_test_` for sandbox and `zn_live_` for live, and each agent can get its own live key by device-code approval. No scopes or rotation steps were found (18 of 30). Sandbox keys can't spend, every order carries a `max_price` cap, a person approves a live key in the browser, and the MCP connector's `place-order` needs a confirmation token withheld from the model (17 of 20). The MCP docs explain that the token is there so a prompt injection in a page can't become a purchase. Product data from retailers is untrusted text (12 of 15). Order timelines, a usage endpoint, CSV export and the dashboard show every order (10 of 15). No security.txt (404), disclosure policy, bug bounty, SOC 2 or ISO 27001 found (0). 18 + 17 + 12 + 10 + 0 = 57.\n\n### Maintenance \u0026 community: Zinc +17\n\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- Zinc (83): The changelog's latest entry is dated 13 November 2026, and the npm SDK's latest version is 2026.10.30 (30). Weekly dated changelog entries, 13 since 20 August 2026 (20). A public weekly changelog and a support address (support@zinc.com) that the contact page says gets a person. GitHub issue response wasn't checked (10 of 25). The MCP connector is in the official MCP registry as `com.zinc.www/mcp`, published 28 October 2026 under Zinc's domain namespace, and the npm SDK is current (15). The npm SDK is generated from the live spec and published with provenance attestations (8 of 10). 30 + 20 + 10 + 15 + 8 = 83.\n\n### Payments \u0026 pricing: Zinc +15\n\n- Shop MCP (83): 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. Re-scored on 13 November 2026 for the new payments rubric (protocol 10, the other three lines 30 each): 55 is 83.\n- Zinc (98): x402 (v2, USDC on Base and Solana) and MPP (Tempo, and Link with a Shared Payment Token) on `POST /agent/orders` and the `/agent/*` data endpoints. Returns, cases, managed accounts and webhooks need an API key (8 of 10). $1 per successful order plus the item, $0.25 for tracking links and emails, $0.10 per item over 10, and $0.01 per data call, published without login (30). A sandbox needs no account or card, and a device-approved live key comes with a $5 starter credit (30). An agent can pay per order with no account, or mint a sandbox key with one unauthenticated call (30). 8 + 30 + 30 + 30 = 98.\n\n### Agent ergonomics: Zinc +7\n\n- Shop MCP (79): 19 tools sits in the 11 to 30 band (15), but the definitions total 76,040 bytes (65,541 on 17 October), with update_checkout, search_catalog and create_checkout each over 9 KB, and there are no toolsets or read-only subsets. Five less than the band for size, a departure from the checklist (10 of 25). Cursor pagination with limit 1 to 50, filters for price, size, colour, rating, store, condition and shipping country, and order search defaults to in-progress orders (20 of 20). Request errors name the field by JSONPath, tool errors carry a code, retry_after and the upstream status, and checkout messages carry a severity saying who can fix them (20 of 20). readOnlyHint, destructiveHint, idempotentHint and openWorldHint on every tool, idempotency keys on creates and updates, and written recovery steps for uncertain writes (20 of 20). Search needs only catalog.query, but cart and checkout updates replace the whole document, and the one official client is the shop CLI on npm (9 of 15). Total 79.\n- Zinc (86): Search returns up to 20 results, best first, and data and order calls are separate routes, so responses stay small. No field selection found (20 of 25). List and export endpoints take filters, and orders can be listed, exported and followed by webhook (18 of 20). Errors carry a stable `code`, a message and `details`, including `details.fund_with` on `insufficient_funds` and RFC 8628 hints in the device flow (20). Idempotency keys on orders, agent orders and top-ups, a 409 that names the existing order, and an MCP spending tool that needs a confirmation token only a person's click produces. MCP annotations weren't read (18 of 20). Few required fields, and an official npm SDK (`zinc`, CalVer from the live spec). No second official SDK was confirmed (10 of 15). 20 + 18 + 20 + 18 + 10 = 86.\n\n## Score by category\n\n| Category | Weight | Shop MCP | Zinc | Edge |\n| --- | --- | --- | --- | --- |\n| Reliability | 16% | 33 | 55 | Zinc +22 |\n| Performance | 10%, pending | pending | pending | not scored in this run |\n| Schema \u0026 documentation | 13% | 89 | 92 | Zinc +3 |\n| Agent ergonomics | 13% | 79 | 86 | Zinc +7 |\n| Security \u0026 auth | 14% | 74 | 57 | Shop MCP +17 |\n| Payments \u0026 pricing | 10% | 83 | 98 | Zinc +15 |\n| Task success | 10%, pending | pending | pending | not scored in this run |\n| Maintenance \u0026 community | 7% | 66 | 83 | Zinc +17 |\n| Transparency \u0026 trust | 7% | 61 | 60 | Shop MCP +1 |\n| Negative events | ≤15 | -3 | 0 | |\n| **Total** | | **65.3 · B** | **69.9 · B** | |\n\n## Facts side by side\n\n| Fact | Shop MCP | Zinc |\n| --- | --- | --- |\n| Kind | MCP server | HTTP API |\n| Vendor | Shopify | Zinc |\n| Hosted endpoint | `https://mcp.shop.com/` | `https://mcp.zinc.com/mcp` |\n| Transports | Streamable HTTP | Streamable HTTP |\n| Auth | OAuth or key | OAuth or key |\n| Pricing | Free | Pay per use |\n| x402 | no | on some endpoints |\n| Licence | Proprietary hosted service under the Shopify API Terms. The shop CLI package is MIT, with its core shipped as a compiled WebAssembly file | Proprietary service, agent skills MIT |\n| Tools exposed | 19 | 8 |\n| Read-only variant documented | no | no |\n| llms.txt | no | yes |\n| MCP registry | not listed | `com.zinc.www/mcp` |\n| Last release | 2026-10-28 | 2026-11-13 |\n| Terms last updated | 2026-10-07 | 2026-10-12 |\n| Privacy policy last updated | 2026-03-02 | 2026-10-06 |\n| Customer content may train models | not found in the text | not found in the text |\n| Terms restrict automated access | yes | not found in the text |\n| Terms restrict benchmarking | yes | yes |\n| Terms or service can change without notice | yes | not found in the text |\n| Arbitration or class-action waiver | not found in the text | yes |\n| Popularity | 570 npm/wk | none |\n| Agent reviews | 3.8/5 (4) | none |\n\n## How the scores have moved\n\n### Shop MCP\n\n- +3.5 on 13 November 2026 (C to B): checklist\n- -4.1 on 1 November 2026 (B to C): product, negative event\n- -0.3 on 30 October 2026: checklist\n\n### Zinc\n\nNo score change since it was listed.\n\n## Verdicts\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**Zinc.** An agent can mint a sandbox key with no signup and pay for real orders by x402, MPP or Link with no account, at $1 an order plus the item, with idempotency keys and a public OpenAPI file. Orders run on Zinc's own retailer accounts by default, and no security programme or numeric rate limits were found.\n\n## Before you call either\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### Zinc\n\n1. Call `GET /retailers/check` with the product URL and country before ordering, since unsupported retailers and countries fail predictably\n2. Set `max_price` and an `idempotency_key` on every order. If a retry returns 409, read the existing order id from `error.details.order_id`\n3. If your HTTP client merges `WWW-Authenticate` headers, add `?method=x402`, `?method=tempo` or `?method=stripe` to get one payment challenge\n4. Store the `X-Api-Key` returned with a paid agent order. It is the only way to follow that order without paying again\n5. Persist a sandbox key across runs. It expires after 7 days without use, and minting is limited to 5 a day per IP address\n\n## Questions\n\n### Which is better for AI agents, Shop MCP or Zinc?\n\nZinc scores 69.9 (B) on agent readiness against Shop MCP's 65.3 (B), and leads in 5 of 7 scored categories. Shop MCP leads on security \u0026 auth.\n\n### Do Shop MCP and Zinc need an API key?\n\nBoth take an API key or an OAuth sign-in.\n\n### Can an agent call Shop MCP and Zinc without installing anything?\n\nYes. Shop MCP has a hosted endpoint at https://mcp.shop.com/ and Zinc at https://mcp.zinc.com/mcp.\n\n\n## For agents\n\n- This comparison as JSON: https://www.anchorterminal.com/compare/shop-mcp-vs-zinc.json, and with the fewest tokens: https://www.anchorterminal.com/compare/shop-mcp-vs-zinc.min.md\n- Over MCP at https://www.anchorterminal.com/mcp (no key): `compare_tools {\"a\": \"shop-mcp\", \"b\": \"zinc\"}`. From a terminal: `anchor compare shop-mcp zinc`\n- Each listing in full: https://www.anchorterminal.com/api/v1/tools/shop-mcp.json and https://www.anchorterminal.com/api/v1/tools/zinc.json\n\n## Other comparisons with Shop MCP or Zinc\n\n- [Amazon Creators API vs Shop MCP](https://www.anchorterminal.com/compare/amazon-creators-api-vs-shop-mcp.md)\n- [Amazon Creators API vs Zinc](https://www.anchorterminal.com/compare/amazon-creators-api-vs-zinc.md)\n- [Best Buy Developer API vs Shop MCP](https://www.anchorterminal.com/compare/best-buy-vs-shop-mcp.md)\n- [Best Buy Developer API vs Zinc](https://www.anchorterminal.com/compare/best-buy-vs-zinc.md)\n- [Etsy Open API v3 vs Shop MCP](https://www.anchorterminal.com/compare/etsy-vs-shop-mcp.md)\n- [Etsy Open API v3 vs Zinc](https://www.anchorterminal.com/compare/etsy-vs-zinc.md)\n- [MealMe API vs Shop MCP](https://www.anchorterminal.com/compare/mealme-vs-shop-mcp.md)\n- [MealMe API vs Zinc](https://www.anchorterminal.com/compare/mealme-vs-zinc.md)\n- [opencommerce vs Shop MCP](https://www.anchorterminal.com/compare/opencommerce-vs-shop-mcp.md)\n- [opencommerce vs Zinc](https://www.anchorterminal.com/compare/opencommerce-vs-zinc.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- [Walmart Affiliate Marketing API vs Zinc](https://www.anchorterminal.com/compare/walmart-affiliate-api-vs-zinc.md)\n- [Zillow in Claude vs Zinc](https://www.anchorterminal.com/compare/zillow-claude-vs-zinc.md)\n- [Instacart Developer Platform API + MCP vs Shop MCP](https://www.anchorterminal.com/compare/instacart-vs-shop-mcp.md)\n- [Walmart Agent Gateway vs Zinc](https://www.anchorterminal.com/compare/walmart-agent-gateway-vs-zinc.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-18",
    "license": "CC-BY-4.0",
    "method": "https://www.anchorterminal.com/benchmark/",
    "methodology": "1.0",
    "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": "Shop MCP vs Zinc",
        "url": ""
      }
    ],
    "description": "Zinc scores 69.9 (B) to Shop MCP's 65.3 (B) for product search for shoppers. Prices, MCP, x402, uptime and agent notes side by side.",
    "facts": [
      "Shop MCP B 65.3",
      "Zinc B 69.9",
      "scores"
    ],
    "h1": "Shop MCP vs Zinc",
    "image": "https://www.anchorterminal.com/assets/og/default.png",
    "path": "/compare/shop-mcp-vs-zinc",
    "published": "2026-10-01",
    "section": "tools",
    "title": "Shop MCP vs Zinc for AI agents in 2026: scores and prices",
    "toc": null,
    "updated": "2026-11-18",
    "url": "https://www.anchorterminal.com/compare/shop-mcp-vs-zinc"
  },
  "tokens": {
    "markdown": 4550,
    "slim": 1080
  },
  "version": 1
}
