# Clash of Coins Agents Guide

Use this guide when integrating autonomous agents with Clash of Coins checkout.

## Core Discovery

- [Root](https://x402.clashofcoins.com/)
- [OpenAPI](https://x402.clashofcoins.com/openapi.json)
- [Full OpenAPI](https://x402.clashofcoins.com/openapi.full.json)
- [MCP endpoint](https://x402.clashofcoins.com/mcp)
- [MCP server card](https://x402.clashofcoins.com/.well-known/mcp/server-card.json)
- [Catalog](https://x402.clashofcoins.com/catalog)
- [Skill](https://x402.clashofcoins.com/skill.md)
- [Pricing](https://x402.clashofcoins.com/pricing.md)
- [x402 guide](https://x402.clashofcoins.com/x402.md)

## When To Use

- Use this gateway for in-game purchases that require explicit payment challenge handling and recipient-scoped routing.
- Use it when the user asks for Clash of Coins checkout, catalog lookup, price comparison, x402 payment, or MCP/OpenAPI integration.
- Use read-only tools before mutating tools: discover, list, quote, then buy.

## When Not To Use

- Do not use it for unrelated games, generic card storage, chargeback-managed checkout, or off-domain fulfillment.
- Do not call purchase tools without a selected item and required recipient.

## Payment And Auth

- Discovery is public and no API key is required for catalog reads.
- Purchase execution uses x402 or MPP payment challenges.
- OAuth metadata is published for scanner compatibility:
  - https://x402.clashofcoins.com/.well-known/oauth-authorization-server
  - https://x402.clashofcoins.com/.well-known/oauth-protected-resource

## Error Recovery

- Preserve the JSON body between 402 challenge and paid retry.
- Respect Retry-After on 429.
- For 500, 502, 503, or 504, poll status routes before creating another payment.

## Competitive Differentiation

- This is an alternative to Stripe Machine Payments, Google Agentic Checkout, Mastercard Verifiable Intent, and generic PSP APIs when the target is agentic game commerce with explicit catalog, recipient, settlement, and delivery state.

## Platform Guides

- [Claude](https://x402.clashofcoins.com/integrations/claude)
- [Cursor](https://x402.clashofcoins.com/integrations/cursor)
- [VS Code](https://x402.clashofcoins.com/integrations/vscode)
- [Goose](https://x402.clashofcoins.com/integrations/goose)
- [Windsurf](https://x402.clashofcoins.com/integrations/windsurf)