v2026-04-08

Universal Commerce
Protocol

Your AI agent wants to buy something. UCP gives it a way to find merchants, search products, and check out. Through clean APIs, not screen scraping or browser puppeteering. Just a protocol.

Agent Flow shows raw API request/response for each protocol step.
Shop Demo shows a chat-style shopping experience powered by UCP.

What UCP Enables
🤖

Agent Commerce

AI agents discover merchant capabilities and complete purchases programmatically. No browser needed.

🔌

Universal Integration

One protocol, any merchant. Like how email works across providers, UCP works across commerce platforms.

🔍

Capability Discovery

Agents discover what a merchant supports via a single /.well-known/ucp endpoint.

The Agent Checkout Flow

When an AI agent wants to make a purchase, it follows this protocol:

1
Discovery
GET /.well-known/ucp
Agent fetches the merchant's discovery profile: capabilities, payment handlers, and endpoints.
2
Catalog Search
POST /api/catalog/search
Agent searches products by text, category, or price range.
3
Cart → Checkout
POST /cart → POST /checkout-sessions
Create a cart, then convert to checkout. Merchant returns pricing, fulfillment options, and payment instruments.
4
Configure & Complete
PUT /checkout-sessions/:id → POST .../complete
Select fulfillment, apply discounts, provide buyer info, submit payment.
5
Order
GET /orders/:id
Retrieve order confirmation with tracking number and full details.
🔍

Catalog

dev.ucp.catalog
Search and lookup products.

🛒

Cart

dev.ucp.cart
Create, update, delete carts.

💳

Checkout

dev.ucp.shopping.checkout
Create → Update → Complete lifecycle.

🚚

Fulfillment

checkout.fulfillment
Shipping options + store pickup.

🏷️

Discounts

checkout.discount
SAVE10 · FREESHIP · FLAT20

📦

Orders

dev.ucp.shopping.order
Retrieve and list orders.

◆ UCP Agent Flow

Step 1: Discovery

Fetch the merchant's UCP profile to discover capabilities.

Request GET
/.well-known/ucp
Response - 
Click "Execute →" to run this step
What happens here
The agent sends a GET request to /.well-known/ucp. The merchant responds with capabilities, payment handlers, and API endpoints.

◆ UCP Shop Demo

UCP

UCP Shop

Online
0 items