# Supercell MCP

> Supercell MCP is an open-source MCP server for games and play. MCP server wrapping the Supercell API for Clash of Clans and Clash Royale player, clan. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, Self-hosted
- **Repository:** https://github.com/mrfentmen/awesome-mcps
- **MCP Registry name:** io.github.mrfentmen/supercell-mcp
- **Categories:** [games and play](https://ai-powered.com/categories/games-and-play)
- **Listing updated:** 2026-11-19

## About

The package exposes Supercell's game API to MCP clients, so an assistant can look up Clash of Clans and Clash Royale players, clans and rankings without the caller writing HTTP requests. It is published on npm as supercell-mcp and runs over stdio, with no environment variables listed in its registry entry.

The registry entry describes it only at the level of players, clans and rankings, and the README of the parent repository lists it among the MCP servers in its mcp/ subtree rather than documenting its individual tools. Specific tool names and input fields are not given in the material available here.

It suits players and clan leaders who want to pull game stats into a chat assistant, and developers who want a ready-made MCP wrapper for Supercell's public data.

## Features

- **Player lookup:** Retrieves information about Clash of Clans and Clash Royale players through the Supercell API.
- **Clan data:** Provides access to clan information for the two Supercell games.
- **Ranking access:** Exposes ranking data from the Supercell API to MCP clients.
- **Stdio transport:** Runs as a local stdio MCP server installed from npm.

## Good for

- Checking a Clash of Clans player's profile from an AI assistant
- Comparing clan standings or rankings in Clash Royale
- Feeding Supercell game stats into a larger agent workflow

## Install

### Claude Code (Terminal)

```sh
claude mcp add supercell-mcp -- npx -y supercell-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "supercell-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "supercell-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "supercell-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "supercell-mcp"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "supercell-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "supercell-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "supercell-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "supercell-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "supercell-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "supercell-mcp"
      ]
    }
  }
}
```

## FAQ

### How is the server installed?

The registry lists it as an npm package named supercell-mcp, version 1.0.0, using the stdio transport.

### Does it need any environment variables?

The registry entry lists no environment variables for this package.

### Is Supercell MCP free?

Yes. Supercell MCP is open source, so you can use and self-host it for free.

### How do I add Supercell MCP to Claude Code?

Run this command in your terminal: claude mcp add supercell-mcp -- npx -y supercell-mcp

## Where this comes from

- Description: written from the project's README and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

---
Source: https://ai-powered.com/mcp/supercell-mcp
