Checkout Directory Skill

You can discover merchants that support agentic commerce protocols using the checkout.directory API.

When to Use This Skill

Use this skill when:

A user wants to buy something online
You need to find merchants in a specific category
You need to check if a merchant supports UCP/ACP
You need a merchant's API endpoints to complete a purchase

API Endpoints

Base URL: https://checkout.directory

List/Search Merchants

GET /api/merchants
GET /api/merchants?q={search_term}
GET /api/merchants?category={category}
GET /api/merchants?protocol={ucp|acp}

Response:

[
  {
    "domain": "allbirds.com",
    "name": "Allbirds",
    "category": "Footwear",
    "protocols": ["ucp"],
    "endpoints": {
      "ucp": "https://allbirds.com/.well-known/ucp"
    }
  }
]

Get Merchant Details

GET /api/merchants/{domain}

Returns a single merchant object.

Get Merchant Manifest

GET /api/merchants/{domain}/manifest

Returns the full UCP/ACP manifest from the merchant's endpoint. Use this to discover:

Available capabilities (checkout, fulfillment, etc.)
MCP endpoint for programmatic interaction
Payment handlers supported

Example Workflow

User: "I want to buy running shoes"

Agent steps:

Search for footwear merchants:

GET https://checkout.directory/api/merchants?category=footwear

Pick a relevant merchant (e.g., Allbirds)

Get their manifest:

GET https://checkout.directory/api/merchants/allbirds.com/manifest

Use the MCP endpoint from the manifest to:
- Search products
- Add to cart
- Complete checkout

Protocols

UCP (Universal Checkout Protocol)

Merchants with UCP support expose endpoints at /.well-known/ucp with capabilities for:

Product search and browsing
Cart management
Checkout flow
Fulfillment tracking

ACP (Agent Commerce Protocol)

Coming soon. Will enable more advanced agent-merchant interactions.

Tips

Always check the protocols array to confirm what a merchant supports
Use the manifest's capabilities to understand what actions are available
The MCP endpoint in the manifest is what you use for actual transactions
Respect rate limits: don't poll the API excessively