nekuda-ai/checkout-directory

Overview

This skill helps discover merchants that support agentic commerce protocols (UCP, ACP) via the checkout.directory API. It exposes searchable merchant listings, protocol support flags, and merchant manifests used for programmatic checkout. Use it to verify protocol support, obtain MCP endpoints, and power agent-driven purchases.

How this skill works

The skill queries checkout.directory endpoints to list or search merchants by name, category, or protocol. For a selected merchant it fetches the merchant manifest which contains protocol capabilities, MCP endpoints, and payment handlers. Agents then use the MCP endpoint and manifest capabilities to perform product search, cart actions, and complete checkout programmatically.

When to use it

• User wants to buy products online via an agent
• Find merchants in a specific category (e.g., footwear, electronics)
• Confirm if a merchant supports UCP or ACP
• Obtain merchant MCP/API endpoints for automated checkout
• Discover what checkout and fulfillment capabilities a merchant exposes

Best practices

• Filter results by the merchant's protocols array before assuming support
• Retrieve the merchant manifest to inspect available capabilities and payment handlers
• Respect rate limits and avoid excessive polling of the API
• Prefer MCP endpoints from the manifest for transactional actions
• Validate domain and endpoint URLs before initiating programmatic checkout

Example use cases

• Search footwear merchants and pick one that exposes UCP for agent checkout
• Check a merchant's manifest to see if cart management and fulfillment tracking are supported
• Extract an MCP endpoint to programmatically search products and add items to cart
• Confirm payment handlers supported by a merchant before initiating payment flow
• Filter merchants by protocol=ucp to ensure agentable checkout flows