Step-by-step guides for implementing the Universal Commerce Protocol. From your first discovery profile to building production-ready commerce agents.
New to UCP? Work through these in order. By the end you will have a working UCP discovery profile and a functional checkout flow.
Create a /.well-known/ucp discovery profile for your store. Learn the structure, required fields, and how to declare capabilities.
Expose your catalog to AI agents. Set up the catalog search endpoint, understand the global catalog vs per-merchant scoping.
Read tutorial →Implement the cart API: add line items, apply localization, estimate totals across multiple conversation turns.
Read tutorial →Convert a cart to a checkout session. Handle buyer info, fulfillment methods, payment instruments, and the completion flow.
Read tutorial →Handle post-purchase: order webhooks, fulfillment events, tracking, returns, and refunds.
Read tutorial →When and how to escalate to a human. Implement continue_url, handle 3DS, address selection, and agent branding.
UCP implementations vary by platform. Shopify has native support. Everything else needs an adapter or the UCP Proxy:
| Platform | UCP Support | Approach | Guide |
|---|---|---|---|
| Shopify | Native | Built-in via Agentic Storefronts. No additional setup needed. | Read → |
| WooCommerce | Via proxy | Deploy the UCP Proxy with WooCommerce adapter | Read → |
| Magento | Via module | Community modules (e.g. angeo/module-ucp) or custom adapter | Read → |
| Wix | Via proxy | UCP Proxy with Wix adapter. OAuth setup and browser handoff flow. | Read → |
| BigCommerce | Via proxy | UCP Proxy with custom adapter against BigCommerce API | Read → |
| Custom platform | Build your own | Implement the UCP spec directly. Use the OpenAPI schemas as your contract. | Read → |
If you are building an AI agent that shops on behalf of users, these tutorials cover the agent side of UCP:
Shopify's ucp-cli gives any agent the ability to search products, build carts, and complete checkouts against any UCP merchant.
Expose your store's UCP capabilities as an MCP server. Compatible with Claude, Cursor, and any MCP-compatible agent framework.
Read guide →Use Agent-to-Agent Protocol to delegate shopping sub-tasks between agents. Handle credential handoff and authorization scope.
Read guide →Powering a commerce agent needs fast inference. gateway.fast provides OpenAI-compatible access to the fastest agentic models at cost + 10%.
Visit gateway.fast →Want to see UCP in action right now? Here is a quick curl to check if a merchant supports UCP:
# Check if a store has a UCP discovery profile
curl -s https://shop.example.com/.well-known/ucp | jq .ucp.version
# Expected response:
"2026-04-08"
# List the merchant's capabilities
curl -s https://shop.example.com/.well-known/ucp | jq .ucp.capabilities | keys
# Check available transports
curl -s https://shop.example.com/.well-known/ucp | \
jq '.ucp.services["dev.ucp.shopping"][] | .transport'The official spec includes an interactive playground at ucp.dev/playground where you can experiment with different agent roles and protocol flows.