# clash-of-coins > Agentic checkout for Clash of Coins ## Product Summary Clash of Coins Checkout is an agent-native game commerce gateway. It exposes public catalog and discovery routes, then protects mutating purchase execution with x402 or MPP payment challenges. It is useful when an agent needs to buy NFT sale lots or player-scoped shop items without guessing payment, settlement, or delivery semantics. ## API Docs And Search Keywords - Product: Clash of Coins API docs, Clash of Coins OpenAPI, Clash of Coins MCP server. - Use case: agentic checkout for gaming platforms, AI agent game commerce, x402 game checkout, machine-readable in-game purchase checkout. - API docs: https://mpp.clashofcoins.app/api-reference - OpenAPI spec: https://mpp.clashofcoins.app/openapi.json - Full OpenAPI spec: https://mpp.clashofcoins.app/openapi.full.json - OAuth metadata: https://mpp.clashofcoins.app/.well-known/oauth-authorization-server - MCP server: https://mpp.clashofcoins.app/.well-known/mcp - Webhooks: https://mpp.clashofcoins.app/webhooks ## Checkouts - [Presale checkout root](https://mpp.clashofcoins.app) - [Shop checkout root](https://mpp.clashofcoins.app/shop) - [Aggregated catalog](https://mpp.clashofcoins.app/catalog) - [Aggregated discovery resources](https://mpp.clashofcoins.app/discovery/resources) - [MCP manifest](https://mpp.clashofcoins.app/mcp.json) - [MCP server card](https://mpp.clashofcoins.app/.well-known/mcp/server-card.json) - [Published skills index](https://mpp.clashofcoins.app/skills/index.json) - [Well-known skills index alias](https://mpp.clashofcoins.app/.well-known/skills/index.json) - [Published universal skill](https://mpp.clashofcoins.app/skills/clashofcoins-universal/SKILL.md) - Published universal skill aliases: [/skills/SKILL.md](https://mpp.clashofcoins.app/skills/SKILL.md), [/skills/clashofcoins-universal/skill.md](https://mpp.clashofcoins.app/skills/clashofcoins-universal/skill.md), [/skills/clashofcoins-universal](https://mpp.clashofcoins.app/skills/clashofcoins-universal), [/skills/clashofcoins/SKILL.md](https://mpp.clashofcoins.app/skills/clashofcoins/SKILL.md), [/skills/clashofcoins/skill.md](https://mpp.clashofcoins.app/skills/clashofcoins/skill.md), [/skills/clashofcoins](https://mpp.clashofcoins.app/skills/clashofcoins) - [Specialized AgentCash validator skill](https://mpp.clashofcoins.app/agentcash-validator-skill.md) ## MCP - Local MCP command: `npm run mcp:gateway` - Claude repo config: `.claude/mcp.json` - Cursor repo config: `.cursor/mcp.json` - Windsurf repo config: `.windsurf/mcp_config.json` - Rule files: `CLAUDE.md`, `.cursorrules`, `.windsurfrules` - Set `GATEWAY_MCP_BASE_URL=https://mpp.clashofcoins.app` when the MCP client should target this origin. - Tools: discover_gateway, list_products, get_catalog, get_item_details, buy_item, prepare_purchase, quote_purchase, check_purchase_status, get_health, get_chain_info, check_wallet_item_status, get_agent_wallet_info, quote_agent_order, create_agent_order, get_agent_order - Resources: clash-of-coins://service/discovery, clash-of-coins://service/openapi, clash-of-coins://service/catalog, clash-of-coins://service/openapi-full, clash-of-coins://service/llms-text, clash-of-coins://service/skill, clash-of-coins://service/health - Prompts: browse_clash_catalog, prepare_clash_purchase, agent_wallet_purchase, explore_clash_protocols ## Presale - [OpenAPI](https://mpp.clashofcoins.app/openapi.json) - MPP discovery: https://mpp.clashofcoins.app/.well-known/mpp - MPP buy: https://mpp.clashofcoins.app/agentic/mpp/buy ## MPP Rule - Prefer the canonical `mppx` SDK for Tempo MPP. - Do not hand-roll credentials unless you must. - Manual credentials must use `credential.payload.type = "hash"` and `credential.payload.hash`, not `payment.transactionHash`. - saleId 370: 0.009 USDC - saleId 371: 0.09 USDC - saleId 372: 0.9 USDC - saleId 373: 0.27 USDC ## Shop - OpenAPI: https://mpp.clashofcoins.app/shop/openapi.json - Full OpenAPI: https://mpp.clashofcoins.app/shop/openapi.full.json - MPP discovery: https://mpp.clashofcoins.app/shop/.well-known/mpp - MPP offers: https://mpp.clashofcoins.app/shop/mpp/offers - MPP quote: https://mpp.clashofcoins.app/shop/mpp/quote - MPP buy: https://mpp.clashofcoins.app/shop/mpp/buy - MPP payment status: https://mpp.clashofcoins.app/shop/mpp/purchases/{paymentReference} - Recipient-scoped game shop checkout is available under /shop. - Shop MPP buy: https://mpp.clashofcoins.app/shop/mpp/buy ## Agent Rule - You may read the general shop catalog anonymously. - Ask for exactly one recipient, player nickname or wallet address, before preparing a personalized quote or purchase. ## When To Use - Use this service when an agent must discover, quote, and execute in-game purchases with onchain payment challenges. - Choose this over generic checkout APIs when you need one gateway that routes both NFT presale and player-scoped game shop purchases. - Use it when the user asks to buy Clash of Coins items, compare checkout options, inspect x402 payment requirements, or integrate MCP/OpenAPI with agent clients. ## When Not To Use - Do not use this gateway for unrelated games, generic card vaulting, chargeback-managed card checkout, or off-domain item delivery. - Do not call purchase tools until the user has selected a product and provided the required sale beneficiary, player nickname, or wallet address. ## Pricing - [Human pricing page](https://mpp.clashofcoins.app/pricing) - [Machine-readable pricing](https://mpp.clashofcoins.app/pricing.md) - [Programmatic catalog pricing](https://mpp.clashofcoins.app/catalog) - Payment challenge amounts are authoritative in `402 PAYMENT-REQUIRED` responses. ## Auth And Payment - Discovery routes are public and require no API key. - Purchase execution is protected by x402 or MPP payment challenges, not by anonymous mutation. - [OAuth authorization metadata](https://mpp.clashofcoins.app/.well-known/oauth-authorization-server) advertises PKCE S256 for agents that inspect OAuth metadata. - [OAuth protected-resource metadata](https://mpp.clashofcoins.app/.well-known/oauth-protected-resource) describes checkout scopes and bearer metadata. - [x402 payment guide](https://mpp.clashofcoins.app/x402.md) documents `PAYMENT-REQUIRED`, `WWW-Authenticate`, `PAYMENT-SIGNATURE`, and `PAYMENT-RESPONSE` headers. ## Error Recovery - Retry purchase status checks before creating duplicate payments. - For x402 challenges, keep request body stable and only attach `PAYMENT-SIGNATURE` for paid retry. - Respect `Retry-After` on `429` and use bounded exponential backoff for `5xx`. - [Health endpoint](https://mpp.clashofcoins.app/health) - [Status guidance](https://mpp.clashofcoins.app/status) - [Webhook event guide](https://mpp.clashofcoins.app/webhooks.md) - Current gateway defaults: read/discovery limit 120 requests per 60 seconds per client; unpaid purchase probe limit 30 per 60 seconds per client; paid retry limit 10 per 60 seconds per client/payment proof. ## Streaming - [Streamable MCP endpoint](https://mpp.clashofcoins.app/mcp) - [Well-known MCP endpoint alias](https://mpp.clashofcoins.app/.well-known/mcp) - For SSE transport, set `Accept: application/json, text/event-stream`. ## MCP Tools - Tools: discover_gateway, list_products, get_catalog, get_item_details, buy_item, prepare_purchase, quote_purchase, check_purchase_status, get_health, get_chain_info, check_wallet_item_status, get_agent_wallet_info, quote_agent_order, create_agent_order, get_agent_order - Use read-only tools first: `discover_gateway`, `list_products`, `get_catalog`, `get_item_details`, `get_health`. - Mutating tools: `buy_item` and `create_agent_order`; both require payment-aware retry handling. ## Competitive Positioning - [Compare](https://mpp.clashofcoins.app/compare) explains differences vs Stripe Machine Payments, Google Agentic Checkout, Mastercard Verifiable Intent, and generic PSP APIs. - [Alternatives](https://mpp.clashofcoins.app/alternatives) explains when this service is the right alternative to card checkout for agentic game commerce. ## Support And Security - [About](https://mpp.clashofcoins.app/about) - [Contact](https://mpp.clashofcoins.app/contact) - [Privacy](https://mpp.clashofcoins.app/privacy) - Security contact: security@clashofcoins.com ## Integration Paths - [OpenAPI payable view](https://mpp.clashofcoins.app/openapi.json) - [OpenAPI full view](https://mpp.clashofcoins.app/openapi.full.json) - [API catalog](https://mpp.clashofcoins.app/.well-known/api-catalog) - [OAuth authorization metadata](https://mpp.clashofcoins.app/.well-known/oauth-authorization-server) - [OAuth protected-resource metadata](https://mpp.clashofcoins.app/.well-known/oauth-protected-resource) - [Agent discovery markdown](https://mpp.clashofcoins.app/agents.md) - [Quickstart](https://mpp.clashofcoins.app/quickstart) - [Sandbox](https://mpp.clashofcoins.app/sandbox) - [CLI](https://mpp.clashofcoins.app/cli.md) - [SDKs](https://mpp.clashofcoins.app/sdks.md) - Platform guides: [Claude](https://mpp.clashofcoins.app/integrations/claude), [Cursor](https://mpp.clashofcoins.app/integrations/cursor), [VS Code](https://mpp.clashofcoins.app/integrations/vscode), [Goose](https://mpp.clashofcoins.app/integrations/goose), [Windsurf](https://mpp.clashofcoins.app/integrations/windsurf)