Clash of Clans

Take your gaming experience to the next level with this MCP server for Clash of Clans.

javascript

0

GitHub Stars

javascript

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "saunved-mcp-server-clash-of-clans": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-clash-of-clans"
      ],
      "env": {
        "CLASH_API_KEY": "<your-api-key>"
      }
    }
  }
}

You can run a Clash of Clans MCP server locally to access structured data about players, clans, wars, and capital raids through a set of ready-to-use prompts. This enables you to query game data quickly, analyze performance, and get strategic insights using a simple MCP client integration.

How to use

To use this MCP server with your MCP client, register the server as an MCP endpoint and run it when you want to fetch Clash of Clans data. You will access a range of available tools and prompts to obtain player, clan, and war information, then analyze results to guide decisions for your clan or alliance.

How to install

Prerequisites you need before installation are a current Node.js runtime and npm (Node.js package manager). Ensure both are installed and available in your system path.

Step-by-step setup and how to run the server locally:

Create a configuration file for your MCP client that registers the Clash of Clans MCP server. Use the snippet below in your project directory to register the server with an MCP client such as Claude Desktop.

{
  "mcpServers": {
    "Clash of Clans": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-clash-of-clans"
      ],
      "env": {
        "CLASH_API_KEY": "<your-api-key>"
      }
    }
  }
}

Additional notes on running

You start the server by invoking the provided command through your MCP client setup. The server relies on the CLASH_API_KEY you provide to access Clash of Clans data through the corresponding API.

Additional sections

Available tools

get-player

Obtains information for a given player tag and summarizes it.

get-clan

Obtains information for a given clan and summarizes it.

clan-war-league-info

Obtains information about the most recent CWL rounds.

clan-war-league-war

Obtains information about a specific CWL war based on the round.

get-current-war

Gets the current war info for the clan (provided it is public).

get-war-log

Gets a clan's war log (provided it is public).

get-capital-raids

Gets information regarding the clan's capital raids.