Key details

  1. Shopify announced the shutdown October 9, 2026; old Global Catalog REST traffic ends November 2, 2026.
  2. Affected endpoints include GET /global/v2/search, GET /global/v2/p/{upid}, GET /global/v2/p/by-variant/{vid}, and POST /global/v2/lookup.
  3. All old requests fail after the cutoff, including saved catalog endpoints.
  4. Replacement is Global Catalog MCP, a UCP implementation, exposing search_catalog, lookup_catalog and get_product.
  5. Every MCP request must include meta.ucp-agent.profile pointing to the agent's UCP profile.
  6. Saved catalogs move to catalog.catalog_id rather than a saved-catalog URL.
  7. Authentication does not change: developers can continue generating bearer tokens from Dev Dashboard client credentials.

What builders should take away

  1. Search your code and logs for discover.shopifyapps.com/global and the four retired route patterns.
  2. Map old search and lookup requests to the three UCP catalog tools and update response parsers.
  3. Provide a valid meta.ucp-agent.profile URL and negotiate the needed UCP catalog capabilities.
  4. Convert saved catalog references to catalog.catalog_id and verify variant GID handling.
  5. Test before November 2 and retain rollback plans for product-discovery workflows that cannot yet use MCP.

What changed

Shopify announced on October 9 that its Global Catalog REST API, deprecated in April, will stop serving traffic on November 2, 2026. Requests to discover.shopifyapps.com/global/... will fail, including those against saved catalogs. Shopify directs developers to Global Catalog MCP, implementing Universal Commerce Protocol (UCP) catalog tools at catalog.shopify.com/api/ucp/mcp. The migration requires changing REST routes to search_catalog, lookup_catalog and get_product, sending a UCP agent profile in request metadata, and adopting the new request/response schemas.

Why it matters

Cross-store product search is a key building block for shopping agents and affiliate/discovery tools. This is a hard endpoint cutoff rather than an optional version upgrade: unchanged integrations will lose search and product-lookup capability. The move also signals a platform-level shift from bespoke REST endpoints to discoverable, agent-oriented UCP/MCP tools, while preserving existing bearer-token authentication.

Endpoint retirement is absolute

Shopify's notice explicitly lists the four affected REST routes and says requests to the old global domain stop being served. Existing saved-catalog URLs are included; this is not limited to new integrations.

Migration is a protocol and schema change

Search maps to search_catalog; product and variant lookup maps to get_product with Shopify GIDs; bulk lookup maps to lookup_catalog. Saved-catalog identity moves into catalog.catalog_id, and requests must declare an agent profile. UCP catalog schemas and tool results differ from the old REST shapes.

What stays and what changes

Bearer-token issuance through Dev Dashboard remains. But application code that assumes REST paths, direct JSON response formats or implicit agent capabilities must be adapted and tested against the MCP endpoint. Shopify provides an AI Toolkit and UCP CLI for test queries.

What to watch next

  • Whether Shopify publishes further migration examples or fixes before November 2.
  • Additional UCP/MCP capabilities, partner policies and any changes to saved-catalog semantics.
  • Adoption of UCP catalog discovery by other commerce platforms.

Still unclear

  • Shopify does not offer a grace period beyond November 2 in the October 9 notice.
  • Availability, inferred metadata and product ranking may differ between the old REST and new UCP catalog responses.

Sources

Direct reading behind this dossier.

2 sources
Global Catalog MCP
Shopify Developer Documentation primary documentation

Current UCP tool contracts, agent profile requirements, catalog IDs, inferred response fields.

Discussion

Discussion is reader-contributed. Comments are not part of the BTN dossier or its editorial evidence.

0 visible comments

Join the discussion

Keep comments useful and relevant. Reader contributions may be moderated and are not BTN editorial evidence.

Sign in to comment