Back to Blog What is the Universal Commerce Protocol (UCP)? A Complete Guide

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:

  1. Fetch from any domain
  2. Parse the manifest to understand what's available
  3. 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:

  1. Implement a UCP manifest at /.well-known/ucp.json
  2. Submit your domain to the registry
  3. 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.