Universal Commerce Protocol v1.0

Is your store AI-Ready?

Enter your domain to see how AI agents interact with your store in real-time

See AI Commerce in Action

Watch how AI agents interact with Acme Electronics using UCP

The New Standard for AI Commerce

The Handshake

Discovery

A single .well-known/ucp JSON file declares your store's capabilities, endpoints, and payment methods to any AI agent.

Interop Layer

One Protocol

One protocol works across all AI assistants — Claude, ChatGPT, Gemini, and more. Implement once, reach everywhere.

Trusted Checkout

Secure

Built-in support for PayPal and Google Pay ensures secure transactions with buyer protection your customers trust.

The Handshake

Publish a .well-known/ucp JSON file at your domain root. This is how AI agents discover your store.

.well-known/ucp

1{
2  "ucp_version": "1.0",
3  "merchant": {
4    "id": "com.acme.electronics",
5    "name": "Acme Electronics",
6    "domain": "acme.com",
7    "logo": "https://acme.com/logo.png"
8  },
9  "capabilities": {
10    "catalog_search": true,
11    "product_details": true,
12    "cart_management": true,
13    "checkout": true
14  },
15  "endpoints": {
16    "catalog": "/api/ucp/catalog",
17    "products": "/api/ucp/products/{id}",
18    "cart": "/api/ucp/cart",
19    "checkout": "/api/ucp/checkout"
20  },
21  "payment_handlers": [
22    "com.google.pay.v1",
23    "com.paypal.ucp.v1"
24  ],
25  "trust_signals": {
26    "verified_merchant": true,
27    "ssl_certificate": true,
28    "refund_policy": "/policies/refunds"
29  }
30}

L2Protocol version for compatibility

L4Reverse-domain identifier for your store

L10Declare what actions agents can perform

L16REST endpoints the agent will call

L22Official payment processor identifiers

L27Build buyer confidence

The UCP Session Lifecycle

UCP isn't just a static file — it's a stateful conversation between agent and merchant.

PROPOSED

Agent has sent a purchase manifest, awaiting merchant stock/price confirmation.

NEGOTIATING

Merchant has applied discounts, shipping options; agent checking user preferences.

FINALIZED

Payment token received, cryptographic consent verified, order confirmed.

Who's Looking for Your UCP File?

Publish your handshake and become discoverable to these AI assistants. They're actively crawling for UCP-enabled merchants.

Google Gemini Shopping

Active

Google's AI shopping assistant

ChatGPT Operator

Active

OpenAI's commerce agent

Claude Commerce

Active

Anthropic's shopping assistant

Perplexity Shopping

Coming Soon

AI-powered product discovery

More AI agents are adopting UCP every week. Get listed before your competitors.

Implementation Steps

Get your store UCP-ready in four straightforward steps. Most implementations take less than a day.

Publish your handshake file

Create a JSON file at /.well-known/ucp with your merchant info, capabilities, and endpoints. This is how AI agents discover your store.

curl https://acme.com/.well-known/ucp

Implement shopping REST endpoints

Build the API endpoints declared in your handshake file. Handle catalog search, product details, cart management, and checkout flows.

POST /api/ucp/cart { product_id, quantity }

Register payment handlers

Configure PayPal and/or Google Pay as your payment processors. AI agents will route customers to trusted checkout experiences.

payment_handlers: ["com.google.pay.v1", "com.paypal.ucp.v1"]

Enable cryptographic consent

Every UCP transaction requires cryptographic proof of user consent. Configure your checkout to sign transactions and verify trust signals from AI agents.

consent_proof: { algorithm: "ES256", signature: "..." }

Get listed here