
Clash Royale
Read-only Clash Royale data for players, clans, wars and rankings via an MCP gateway
- Pricing
- Freemium
- Platforms
- API, CLI, self-hosted
- Runs
- Locally or Remotely
- Version
- 0.2.1
- Listing updated
- today
Similar MCP servers
About Clash Royale
Clash Royale is a freemium MCP server for games and play. It can run locally on your machine or as a hosted remote server.
The server wraps the official Clash Royale developer API and exposes player profiles, recent battle logs, upcoming chest cycles, clan profiles and member lists, clan war logs and current war status, tournament lookups, the full card list, and location-based leaderboards. Each tool takes a Supercell tag such as #2PP as input.
The server is a hosted gateway at pipeworx.io. Calls go through a Pipeworx endpoint that forwards them to the Clash Royale API, and the README notes that Pipeworx runs as an independent, unofficial integration. Access requires your own Clash Royale developer key, because Supercell keys are tied to an IP address. The README says to generate the key with the "Allow any IP" option so it works through the gateway.
The package also runs as a local stdio bridge through npx, and the README says it needs network access because it forwards every call to the hosted endpoint. Without a Pipeworx key, anonymous calls are capped daily, and a free account raises the cap.
Install
Run in a terminal
claude mcp add --transport http clash-royale https://gateway.pipeworx.io/clash-royale/mcpAdd to Settings → Connectors → Add custom connector
https://gateway.pipeworx.io/clash-royale/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"clash-royale": {
"url": "https://gateway.pipeworx.io/clash-royale/mcp"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"clash-royale": {
"type": "http",
"url": "https://gateway.pipeworx.io/clash-royale/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"clash-royale": {
"serverUrl": "https://gateway.pipeworx.io/clash-royale/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"clash-royale": {
"type": "http",
"url": "https://gateway.pipeworx.io/clash-royale/mcp"
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
PIPEWORX_API_KEYOptional Pipeworx API key. Without it calls are anonymous and capped daily; a free key raises the cap.
Tools this server provides (15)
Taken from the project documentation; the running server may differ.
- player
- Player profile for a tag.
- player_battles
- Recent battles for a player tag.
- player_upcoming_chests
- Upcoming chest cycle for a player tag.
- clan
- Clan profile for a clan tag.
- clan_members
- Paginated member list for a clan tag.
- clan_war_log
- War log for a clan tag.
- clan_current_war
- Current war status for a clan tag.
- clan_search
- Search clans by name, location, size and score.
- tournament
- Tournament details for a tournament tag.
- tournament_search
- Search open tournaments by name.
- cards
- Complete list of game cards.
- locations
- List of supported location IDs.
- location
- Details for a single location by ID.
- rankings_clans
- Top-ranked clans for a location ID.
- rankings_players
- Top-ranked players for a location ID.
What it does
- Player profile lookup
- Returns a player's trophies, level, arena, clan, card collection and league ranking for a given tag.
- Battle and chest data
- Lists a player's recent battles with outcomes, decks and trophy changes, plus the upcoming chest queue.
- Clan and war tracking
- Provides clan profiles, paginated member lists, past war logs and the current war status.
- Tournament search
- Looks up tournament details by tag and searches open tournaments by name.
- Card and ranking data
- Returns the full card list with costs and rarity, plus top clans and players for any location ID.
Good for
- Check a player's trophies, arena and card collection before a match
- Track a clan's war results and current war standings
- Pull recent battle logs to analyse a player's deck choices
- Find open tournaments or search clans by size and score
- Compare global or country leaderboards for clans and players
Pricing
Freemium, from $49 a month
Anonymous calls capped at 50 a day; free Pipeworx account at 200 a day; paid credits and subscriptions beyond that. Clash Royale key is free from Supercell.
Prices change. Check pipeworx.io before you buy.
Clash Royale FAQ
Do I need an API key to use it?
Yes. The README says the pack takes your own Clash Royale key, passed as _apiKey on the gateway URL. Without a Pipeworx key, anonymous calls are capped at 50 a day, and a free account raises the cap to 200.
Why does my Clash Royale key return a 403 error?
The README says Supercell keys are IP-bound and gateway egress IPs change, so the key must be generated with the "Allow any IP" option or it will be rejected.
Which tools does the endpoint list?
The README lists 15 pack tools covering players, clans, wars, tournaments, cards, locations and rankings. The endpoint also lists roughly 30 shared Pipeworx meta-tools alongside them.
Is this an official Supercell product?
No. The README describes it as an independent, unofficial integration that is not affiliated with or endorsed by the upstream provider.
Is Clash Royale free?
Clash Royale has a free plan, with paid plans for more usage or features. Paid plans start at $49 a month.
How do I add Clash Royale to Claude Code?
Run this command in your terminal: claude mcp add --transport http clash-royale https://gateway.pipeworx.io/clash-royale/mcp
What are the best alternatives to Clash Royale?
The closest alternatives to Clash Royale are Wynncraft, Roblox, Steam, Opendota and Boardgamegeek.
Where this comes from
- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.