What is the Universal Commerce Protocol (UCP)?

The Universal Commerce Protocol (UCP) is an open standard that lets AI agents and stores talk to each other to find products, build carts and check out. Each side publishes a profile that says what it supports, and the two use the parts they both support.

Updated

How does UCP work?

UCP has two sides (UCP specification overview, read October 29, 2026):

  • Businesses (stores) publish a profile at /.well-known/ucp. It is a JSON file that lists the UCP version, the services and capabilities the business supports, and its payment handlers. It can also carry signing keys.
  • Platforms (the apps and agents that shop for a buyer) publish a profile of their own and include its URL in every request.

When a platform makes a request, the business compares the two profiles and keeps the capabilities both sides support, at the highest version both support. If there is no overlap, it returns an error such as version_unsupported or capabilities_incompatible.

There is no central sign-up. The spec calls this "permissionless onboarding": any platform with a discoverable profile can interact with any business "without prior registration". A business can still keep its own list of approved platforms and set its own access rules.

The spec also names a third role, the payment credential provider, which issues payment tokens. The platform gets a token from the provider and passes it to the business, and the spec says platforms should not touch raw financial credentials.

What are UCP capabilities?

A capability is a named part of the protocol that a business or platform can support. Names use reverse-domain form, such as dev.ucp.shopping.checkout, so no central registry of names is needed (UCP specification overview, read October 29, 2026).

CapabilityNameWhat it does
Catalogdev.ucp.shopping.catalog.search, dev.ucp.shopping.catalog.lookupSearch for products with free text and filters, or fetch specific products and variants by ID (Catalog spec)
Cartdev.ucp.shopping.cartBuild a cart with one or more items
Checkoutdev.ucp.shopping.checkoutRun a checkout session that works out pricing, taxes and cart logic
Orderdev.ucp.shopping.orderSend order updates, such as status, shipment tracking and returns
Identity linkingdev.ucp.common.identity_linkingLink a buyer's account at a store to an agent with OAuth 2.0, so the agent acts with permission and without sharing passwords

Extensions add to a capability. The spec names fulfillment (added to checkout), discount (added to checkout and cart) and AP2 mandates, an optional extension for cryptographic payment authorization. An extension is dropped when its parent capability isn't in use.

The UCP site describes these as covering the purchase from discovery to after the sale, and says an agent can either hand a cart off to the store's website or check out in place (ucp.dev, read October 29, 2026).

How do agents connect to UCP?

Each service in a business's profile names a transport. The spec defines four (UCP specification overview, read October 29, 2026):

  • REST, the core transport: an HTTP API described with OpenAPI. The platform puts a link to its profile in the UCP-Agent request header.
  • MCP (Model Context Protocol): UCP operations offered as tools an AI model can call, described with OpenRPC. The platform puts a link to its profile in a meta object in the tool call's arguments.
  • A2A (Agent2Agent): described with an Agent Card.
  • Embedded: also described with OpenRPC.

A business chooses which transports to offer, and a platform connects over one the business lists. The capabilities are the same whichever transport carries them.

How is UCP different from ACP?

The Agentic Commerce Protocol (ACP) is another open standard for agent shopping. Its README calls it "an interaction model and open standard for connecting buyers, their AI agents, and businesses". OpenAI and Stripe are its founding maintainers, it is licensed Apache 2.0, and it is in beta (ACP on GitHub, read October 29, 2026).

What they share. Both are open, both cover checkout, and both keep the store as the seller: UCP says merchants stay the Merchant of Record (ucp.dev), and ACP says agents let users buy "without being the merchant of record".

How each describes itself:

UCPACP
DiscoveryStores publish a profile at /.well-known/ucp; any platform with a profile can connect without prior registrationThe README doesn't describe a discovery file
ScopeCatalog, cart, checkout, order and identity linking, plus extensionsCheckout and delegated payment; its 2026-04-17 release adds cart, feed, orders, authentication and MCP
Specs and transportsREST, MCP, A2A and embeddedHTTP APIs specified in OpenAPI and JSON Schema; MCP in the 2026-04-17 release
PaymentsPayment handlers: the platform gets a token from a payment provider and passes it to the businessA separate Delegate Payment spec for passing payment tokens

Nothing in either spec stops a store from supporting both. For how UCP and ACP sit alongside AP2, MCP, the Personal Agent Protocol and the card networks' programs, see Agentic commerce protocols explained.

Why does UCP matter for gifting?

A gift is bought by one person for another, usually shipped to a different address and often needed by a set date. UCP's parts map onto those steps:

  • Catalog search finds the gift at the store.
  • A checkout session works out the real price, with tax and shipping, before anyone approves the spend.
  • The fulfillment extension carries the shipping details.
  • Order updates report status and shipment tracking, so the sender knows when the gift arrives.

Because stores publish what they support and agents connect without prior registration, a gifting agent can shop many stores through one standard instead of a custom integration for each. The store stays the seller, so the gift is a normal order from that store. See what is agentic gifting.

Gratos supports UCP.

Questions

What is the /.well-known/ucp file?

It is a store's UCP profile: a JSON file that lists the UCP version, the services and capabilities the store supports, and its payment handlers (UCP specification overview).

Does an agent need to register with a store to use UCP?

No. The spec describes "permissionless onboarding": any platform with a discoverable profile can interact with any business without prior registration. A store can still keep its own list of approved platforms.

How are UCP versions named?

By date. The specification examples read October 29, 2026 use version 2026-08-25, and the spec says businesses should list the older versions they still support.

Does UCP move card numbers between agents and stores?

The spec says platforms should not touch raw financial credentials. A platform gets a payment token from a payment credential provider and passes that token to the business.

Is UCP the same as MCP?

No. MCP is a general protocol for offering tools to AI models. UCP is a commerce standard, and MCP is one of the transports it can run over, along with REST, A2A and embedded.