Loading…
Docs
Learn how to implement Universal Commerce Protocol (UCP) endpoints and make your products agent-ready.
Last updated: February 3, 2026
This content is based on official sources and ecosystem developments:
Universal Commerce Protocol (UCP) enables AI assistants to discover, evaluate, and purchase your products. This guide walks you through implementing UCP endpoints on your domain.
Before starting, ensure you have:
Create a .well-known/ucp endpoint that exposes your UCP capabilities:
{
"version": "1.0",
"capabilities": {
"product_catalog": {
"endpoint": "https://yourdomain.com/ucp/products",
"format": "json"
},
"checkout": {
"endpoint": "https://yourdomain.com/ucp/checkout",
"supported_methods": ["POST"]
}
}
}
Create a /ucp/products endpoint that returns your product catalog in UCP format:
{
"products": [
{
"id": "prod_123",
"name": "Running Shoes",
"description": "High-performance running shoes",
"price": {
"amount": 12999,
"currency": "USD"
},
"availability": "in_stock",
"variants": [
{
"id": "var_123_1",
"attributes": {
"size": "10",
"color": "black"
}
}
]
}
]
}
Create a /ucp/checkout endpoint that handles purchase requests:
{
"cart": {
"items": [
{
"product_id": "prod_123",
"variant_id": "var_123_1",
"quantity": 1
}
]
},
"shipping_address": {
"street": "123 Main St",
"city": "San Francisco",
"state": "CA",
"zip": "94102",
"country": "US"
}
}
.well-known DirectoryOn your web server, create a .well-known directory in your web root.
Create .well-known/ucp (or .well-known/ucp.json) with your capabilities.
Use curl or a browser to test:
curl https://yourdomain.com/.well-known/ucp
You should receive your capability JSON response.
Visit our UCP readiness checker to validate your implementation.
.well-known/ucp endpoint returns valid JSON