
What is the Universal Commerce Protocol (UCP)? A Complete Guide
The Universal Commerce Protocol (UCP) is an open standard that enables AI agents, tools, and applications to discover and interact with online merchants programmatically. Think of it as a universal language between AI-powered commerce tools and the stores they serve.
Why UCP Exists
Today's e-commerce ecosystem is fragmented. Every platform — Shopify, WooCommerce, Magento, BigCommerce — exposes product data differently. If you're building an AI shopping assistant, a price comparison tool, or a commerce automation platform, you need to write custom integrations for each one.
UCP solves this by providing a single, standardized endpoint that any merchant can implement. One protocol, one format, universal access.
How It Works
Every UCP-enabled merchant hosts a JSON manifest at a well-known URL:
https://example.com/.well-known/ucp.json
This manifest describes the merchant's capabilities — what an AI agent can do with their store. A typical manifest looks like this:
{
"version": "1.0",
"merchant": {
"name": "Example Store",
"domain": "example.com"
},
"capabilities": [
"dev.ucp.shopping.catalog",
"dev.ucp.shopping.cart",
"dev.ucp.shopping.checkout"
],
"transports": ["mcp"]
}
The key sections are:
- Version — the UCP spec version the merchant supports
- Merchant — basic identity information
- Capabilities — what operations the merchant's API supports
- Transports — how agents can communicate (MCP, REST, embedded)
Core Capabilities
UCP defines a standard set of capabilities that merchants can implement:
| Capability | Description |
|---|---|
dev.ucp.shopping.catalog |
Search the product catalog and retrieve full product information including variants, pricing, and availability |
dev.ucp.shopping.cart |
Create, update, and manage shopping carts |
dev.ucp.shopping.checkout |
Complete purchases programmatically |
dev.ucp.shopping.order |
Track order status and shipping information |
dev.ucp.shopping.fulfillment |
Calculate shipping rates and delivery estimates |
dev.ucp.shopping.returns |
Initiate and manage product returns |
Merchants don't need to implement all capabilities — they choose which ones make sense for their business. A read-only catalog might only support dev.ucp.shopping.catalog, while a full-service store could support the entire set.
The Discovery Problem UCP Solves
Before UCP, there was no standard way for an AI agent to answer a simple question: "Can I interact with this store, and if so, how?"
With UCP, discovery is trivial:
- Fetch from any domain
- Parse the manifest to understand what's available
- Start interacting using the declared capabilities
This is similar to how tells crawlers what they can access, or how enables OAuth discovery. UCP brings the same pattern to commerce.
Who Benefits from UCP
AI Agent Developers
If you're building a shopping assistant, product recommender, or commerce automation tool, UCP gives you a single integration point that works across thousands of merchants. No more writing platform-specific adapters. Learn more about how AI agents discover merchants in practice, or jump straight to our tutorial on building an AI shopping agent.
E-Commerce Platforms
Platforms like Shopify and WooCommerce can add UCP support once, and every merchant on their platform instantly becomes discoverable by AI agents. It's a network effect — the more merchants adopt UCP, the more valuable the ecosystem becomes.
Merchants
For merchants, UCP means being discoverable by the next generation of AI-powered commerce tools. As AI shopping assistants become more prevalent, merchants without UCP endpoints risk being invisible to these tools. See which top merchants have already adopted UCP, or read our guide on how to add your business.
UCP and AI Bot Policies
UCP works alongside robots.txt and AI-specific bot policies. A merchant's UCP manifest might declare full capabilities, but their robots.txt or AI bot policies might restrict which bots can actually use them.
The UCP Registry tracks both — showing you not just what capabilities a merchant supports, but also which AI crawlers and agents they allow access to. This includes policies for:
- GPTBot (OpenAI)
- ClaudeBot (Anthropic)
- Google-Extended (Google AI)
- Applebot-Extended (Apple)
How the UCP Registry Fits In
The UCP Registry is the canonical directory of UCP implementations. We continuously crawl and verify merchant endpoints, tracking:
- Endpoint availability — is the UCP manifest accessible?
- Response times — how fast does the endpoint respond?
- Capabilities — what does the merchant support?
- Benchmark scores — how well does the implementation perform?
- Platform detection — which e-commerce platform powers the store?
Every merchant gets a permanent Registry ID (like ) and a UCP Score from 0-100 based on their implementation quality.
Getting Started
For Developers
Query the UCP Registry API to find merchants:
curl https://ucpregistry.com/api/v1/merchants?status=verified
Filter by capabilities:
curl https://ucpregistry.com/api/v1/merchants?capability=dev.ucp.shopping.checkout
Browse the full API documentation for more endpoints.
For Merchants
To get your store listed in the UCP Registry:
- Implement a UCP manifest at
/.well-known/ucp.json - Submit your domain to the registry
- We'll verify your endpoint and add you to the directory
Many e-commerce platforms are adding native UCP support. Check the Plugins directory for platform-specific implementations.
The Road Ahead
UCP is still early, but the trajectory is clear. As AI agents become the primary interface for online shopping, a standard protocol for commerce discovery isn't just nice to have — it's essential infrastructure.
The ecosystem is growing: over 3,000 merchants are already in the registry, across dozens of platforms, with new tools and plugins being built every week. Whether you're building the next AI shopping assistant or running an online store, UCP is how you connect to this future. For a deeper look at where the ecosystem is headed, read about the future of agentic commerce with UCP, A2A, and MCP, or check the latest state of the UCP ecosystem. Shopify merchants can get started in minutes with our Shopify setup guide.
The UCP Registry is the canonical source for UCP implementation data. Browse the directory, explore the API, or submit your merchant to get started.


