Skip to content
MCP server

Clash Royale

Read-only Clash Royale data for players, clans, wars and rankings via an MCP gateway

Install
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/mcp

Add to Settings → Connectors → Add custom connector

https://gateway.pipeworx.io/clash-royale/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "clash-royale": {
      "url": "https://gateway.pipeworx.io/clash-royale/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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.

How AIPoweredBot checks servers