Quick answer: The TrophyCoach MCP server serves live Clash Royale metagame data to AI agents over the Model Context Protocol at https://mcp.trophycoach.com/api/mcp. Add that endpoint to any x402-capable MCP client, call the free get_meta_overview tool to see what's available, and pay $0.005–$0.01 per call in USDC for deck meta, matchups, and cross-range comparisons. No account or API key is required.
If you are building an AI agent — a Discord bot, a coaching assistant, a research tool — and you want it to reason about the current Clash Royale metagame, you now have a direct way to get that data. The TrophyCoach MCP server exposes live meta intelligence as tools an agent can call and pay for on its own, per request, with no signup and no API key.
This guide covers what the server offers, how to connect to it, how payment works, and the full pay-and-retry loop an agent runs.
What it offers
The server exposes four tools over the Model Context Protocol. One is free; the rest are paid per call in USDC.
| Tool | Price / call | What it returns |
|---|---|---|
get_meta_overview | Free | Service catalog: trophy ranges, tools, and pricing. Call this first. |
get_deck_meta | $0.005 | Dominant decks (usage and win rates), common threat cards, and average card levels for one trophy range. |
get_matchups | $0.005 | Head-to-head deck matchup win rates between archetypes for one trophy range. |
compare_ranges | $0.01 | Cross-range meta shifts across 2–5 ranges: new and declining decks, emerging and fading threats, and card-level progression. |
Trophy ranges are: under_5000, 5000-6000, 6000-7000, 7000-8000, 8000-9000, and 9000+.
Want this kind of analysis for your own deck?
TrophyCoach reads your battle log and writes a personalized action plan against the current meta — free to start.
How payment works
Payment uses x402, an open protocol that settles per-call payments in USDC on the Base network. It works by finally putting HTTP's 402 Payment Required status code to use:
- Your agent calls a paid tool with no payment attached.
- The server responds with a 402 and a machine-readable price quote — amount, recipient, and network.
- Your agent signs a payment authorization for that exact quote.
- Your agent retries the call with the authorization attached; the server verifies it, runs the tool, and settles payment on-chain.
Three things make this practical for agents: there is no account (the payment is self-contained), it is gasless for the payer (the agent needs USDC but no gas — a facilitator submits the transaction), and it is micro-viable (settlement on Base makes a half-cent charge economically sane).
Connecting an agent
Add the endpoint to your MCP client configuration as an HTTP transport:
{ "mcpServers": { "trophycoach": { "type": "http", "url": "https://mcp.trophycoach.com/api/mcp" } } }
Any x402-capable MCP client can then list the tools and call the free overview immediately. To make paid calls, your client needs a wallet with USDC on Base.
The pay-and-retry loop
Most x402 MCP client wrappers do not pay automatically — they expose a payment-authorization tool and expect the agent (or your code) to drive a three-step loop. Here is the shape of it:
// 1. Call the paid tool with no payment -> a 402 price quote, not data const unpaid = await tools.get_deck_meta.execute({ range: "7000-8000" }); const requirements = JSON.parse(text(unpaid)).accepts[0]; // 2. Sign a payment authorization for exactly that quote const { paymentAuthorization } = await tools.generatePaymentAuthorization .execute({ paymentRequirements: requirements }); // 3. Retry WITH payment -> the data, and USDC settles on-chain const paid = await tools.get_deck_meta.execute({ range: "7000-8000", paymentAuthorization, });
A client-configured spending ceiling caps what an agent will pay per call, so it can never overspend on a single request. The free get_meta_overview tool never triggers this loop — it returns data directly.
Example: what a paid call returns
A get_deck_meta call for the 7000-8000 range returns the current dominant decks with their card lists, usage and win rates, the most common threat cards, and average card levels for that bracket — the same aggregated ladder-battle data that powers TrophyCoach's coaching guides, structured for a machine to consume.
Frequently asked questions
Do I need a TrophyCoach account? No. The whole point of x402 is that no account or API key is required — an agent with a funded wallet can call paid tools on its first request.
What does it cost? The overview tool is free. Single-range tools are $0.005 per call; the multi-range compare_ranges tool is $0.01. You pay only for calls you make.
What currency and network? USDC on Base, settled through the x402 protocol.
Can a human use it? The server is built for agents, but any MCP client works. The free overview tool is the easiest way to see what's on offer.
Next steps
Point an x402-capable MCP client at https://mcp.trophycoach.com/api/mcp, call get_meta_overview to confirm the connection, and you are ready to buy live meta data per call. For the product overview and pricing at a glance, see the TrophyCoach MCP page.