SARAH

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 (enable and enable_shop).

Endpoints

ResourceURL
UCP profilehttps://your-store/.well-known/ucp
MCP endpointhttps://your-store/api/ucp/mcp
Agent guidehttps://your-store/agents.md
LLM indexhttps://your-store/llms.txt

On Sarah's main domain you can test with ?company=your-slug.

Tools

ToolWhat it does
search_catalogSearches published products
get_productReturns one product with variants
create_cartCreates a signed cart
get_cartRe-reads and re-prices the cart
update_cartReplaces lines and returns a new cart
cancel_cartCancels the cart
create_checkoutReturns 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