AI agent checkout (UCP/MCP)
How AI agents can search products, build a cart and hand the purchase to your store checkout.
Last updated: 2026-11-17
Your online store exposes an endpoint so AI agents (ChatGPT, Claude, Cursor or others) can search products, build a cart and hand the buyer to the real checkout.
Nothing changes in checkout or payments: the agent never charges the buyer and never receives card data. The buyer finishes the purchase in your store.
Requirements
- The online store must be active.
- Products must be published (
enableandenable_shop).
Endpoints
| Resource | URL |
|---|---|
| UCP profile | https://your-store/.well-known/ucp |
| MCP endpoint | https://your-store/api/ucp/mcp |
| Agent guide | https://your-store/agents.md |
| LLM index | https://your-store/llms.txt |
On Sarah's main domain you can test with ?company=your-slug.
Tools
| Tool | What it does |
|---|---|
search_catalog | Searches published products |
get_product | Returns one product with variants |
create_cart | Creates a signed cart |
get_cart | Re-reads and re-prices the cart |
update_cart | Replaces lines and returns a new cart |
cancel_cart | Cancels the cart |
create_checkout | Returns the link where the buyer pays |
Example
bashcurl -X POST "https://your-store/api/ucp/mcp" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_catalog","arguments":{"query":"coffee","limit":5}}}'
Limits
- Cart prices are estimates: promotions, shipping and taxes are confirmed at checkout.
- Carts expire after 7 days.
- Reported stock is physical; pending reservations are validated at charge time.
- The agent cannot read orders or complete payments.