AgentCheckout

Let AI Do the Shopping for You

Copy this prompt into Claude, ChatGPT, or your favorite AI assistant.

I want to shop online using AgentCheckout. Connect to the AgentCheckout MCP server at https://api-production-8d20.up.railway.app/api/mcp and help me find the best products across all stores. Search catalogs, show me images and prices, check for discounts, and help me pick the best deals.

API Endpoints

All API endpoints are free to use. A flat 1% commission applies only when an agent completes a purchase.

Search Products

POST

Full-text search across a store’s product catalog. Returns matching products with variants, images, and pricing.

POST /apps/shopagent/api/products/search

Get Product Details

GET

Fetch full details for a product by its handle. Includes all variants, availability, and pricing.

GET /apps/shopagent/api/products/:handle

Discovery

AgentCheckout stores broadcast capabilities via well-known URLs. Your agent discovers stores without prior configuration — like search engines discover robots.txt.

# Discover a store's capabilities curl https://store.myshopify.com/apps/shopagent/shopagent.json # Read LLM-friendly shopping instructions curl https://store.myshopify.com/apps/shopagent/llms.txt # Browse the global directory curl https://api-production-8d20.up.railway.app/api/directory

Authentication

Transactional endpoints require a Bearer token. Stores provide an API key on plugin install. Discovery endpoints are public.

Authorization: Bearer sk_agent_xxxxxxxxxxxxx

MCP Server

For agents supporting the Model Context Protocol, a full MCP server exposes shopping tools directly. Any MCP-compatible agent can connect and shop all stores on the network.

Endpoint: https://api-production-8d20.up.railway.app/api/mcp Tools: list_stores Discover all stores on the network search_products Search a store's catalog get_product_details Full product info by ID search_discounts Find active discount codes get_checkout_status Check checkout state Agent payments coming soon.

Connect Your Agent

To connect an AI agent to the AgentCheckout network, add this MCP server configuration. Once connected, the agent can discover and shop any store on the network automatically.

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{ "mcpServers": { "shopagent": { "command": "npx", "args": ["-y", "mcp-remote", "https://api-production-8d20.up.railway.app/api/mcp"] } } }

Claude Code

Add to your project's .mcp.json:

{ "mcpServers": { "shopagent": { "type": "url", "url": "https://api-production-8d20.up.railway.app/api/mcp" } } }

Any MCP Client

Point your MCP client at:

https://api-production-8d20.up.railway.app/api/mcp

Or ask your AI agent: "Connect to the AgentCheckout MCP server at https://api-production-8d20.up.railway.app/api/mcp so I can shop online."

Pricing

All API access is free. A flat 1% commission is applied only when an agent completes a purchase. No subscriptions, no per-call fees, no minimums.

Documentation