---
title: "AI agent checkout (UCP/MCP)"
description: "How AI agents can search products, build a cart and hand the purchase to your store checkout."
keywords: ["agents", "ai", "mcp", "ucp", "chatgpt", "online store", "api"]
lastUpdated: "2026-11-17"
---

# AI agent checkout (UCP/MCP)

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 (`enable` and `enable_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

```bash
curl -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.

## Next steps

- [Checkout and online payments](/docs/shop/checkout)
- [Online order management](/docs/shop/orders)
