# Clash Royale

> Clash Royale is a freemium MCP server for games and play. Read-only Clash Royale data for players, clans, wars and rankings via an MCP gateway. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $49 a month
- **Platforms:** API, CLI, self-hosted
- **Website:** https://pipeworx.io/packs/clash-royale
- **Repository:** https://github.com/pipeworx-io/mcp-clash-royale
- **MCP Registry name:** io.github.pipeworx-io/clash-royale
- **Categories:** [games and play](https://ai-powered.com/categories/games-and-play)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http clash-royale https://gateway.pipeworx.io/clash-royale/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://gateway.pipeworx.io/clash-royale/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "clash-royale": {
      "url": "https://gateway.pipeworx.io/clash-royale/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "clash-royale": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/clash-royale/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "clash-royale": {
      "serverUrl": "https://gateway.pipeworx.io/clash-royale/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "clash-royale": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/clash-royale/mcp"
    }
  }
}
```

## Tools

- `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.

## 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.

## Alternatives

- [Wynncraft](https://ai-powered.com/mcp/wynncraft): Wynncraft is a freemium MCP server for games and play.
- [Roblox](https://ai-powered.com/mcp/roblox): Roblox is a freemium MCP server for games and play.
- [Steam](https://ai-powered.com/mcp/steam): Steam is a freemium MCP server for games and play.
- [Opendota](https://ai-powered.com/mcp/opendota): Opendota is a freemium MCP server for games and play.
- [Boardgamegeek](https://ai-powered.com/mcp/boardgamegeek): Boardgamegeek is a freemium MCP server for games and play.
- [Guild Wars 2](https://ai-powered.com/mcp/guild-wars-2): Guild Wars 2 is a freemium MCP server for games and play.
- [Warframe](https://ai-powered.com/mcp/warframe): Warframe is a freemium MCP server for games and play.
- [Pokémon TCG API](https://ai-powered.com/mcp/pokemon-tcg-api): Pokémon TCG API is an MCP server for games and play.

---
Source: https://ai-powered.com/mcp/clash-royale
