Shopify /api/ucp/mcp & agents.md Setup Guide: Fixing Stock Boilerplate for ChatGPT Shopping
1. Why Stock Shopify /agents.md Costs You Commercial Citations
When Shopify rolled out the Universal Commerce Protocol (/api/ucp/mcp), storefronts automatically began serving a machine-readable /agents.md file. While helpful for basic cart discovery, the stock template contains zero merchant-specific shipping thresholds, regional fulfillment rules, bundle pricing, or discontinued-product exclusions.
When a buyer asks ChatGPT or Perplexity a high-intent commercial question—such as whether your store offers free US shipping over $35 or sells subscription refills—AI engines skip generic boilerplate and fall back to outdated third-party blog posts or Reddit comments.
2. Linking a Verified Merchant Truth Feed on Shopify
Because Shopify manages root static paths, the cleanest 2026 pattern combines a custom templates/agents.md.liquid override (when supported by your theme routing) with a same-origin alternate Markdown discovery tag in layout/theme.liquid pointing to /pages/ai-facts wrapped in <article class="verisource-ai-facts">.
3. Tracking Sandboxed Shopify Checkout Sales from ChatGPT & Perplexity
AI-referred shoppers convert at 14.2%–15.9% compared with 1.76%–2.8% on traditional organic search. Because Shopify Checkout Extensibility executes Custom Web Pixels inside a strict sandboxed worker (Origin: null), standard referrer scripts drop attribution at checkout.
Verisource solves this by pairing a lightweight storefront <head> capture script (recording chatgpt.com, perplexity.ai, gemini.google.com, and claude.ai in localStorage) with an HMAC-authenticated Shopify Customer Events pixel that logs verified checkout_completed USD totals.
Common implementation questions
Did Shopify replace /api/mcp with /api/ucp/mcp?
Yes. Shopify transitioned legacy Storefront MCP (/api/mcp) catalog and cart actions to the Universal Commerce Protocol endpoint at /api/ucp/mcp. Verisource probes both endpoints automatically so legacy and UCP storefronts are graded accurately.
How do I check if my Shopify store serves generic /agents.md boilerplate?
Run your store domain through the free Verisource Shopify AI Readiness Checker at /tools/shopify-ai-readiness-checker. It classifies /agents.md into missing, default_boilerplate, or custom_enriched in under 5 seconds.