Brawl Stars

Provides real-time Brawl Stars data to MCP-compatible AI assistants through an STDIO-based MCP server.

javascript

1

GitHub Stars

javascript

Language

3 months ago

First Indexed

3 weeks 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": {
    "lrxdarkdevil-brawl-stars-mcp": {
      "command": "npx",
      "args": [
        "brawl-stars-mcp",
        "--token",
        "YOUR_API_TOKEN_HERE"
      ]
    }
  }
}

You can use this MCP server to access real-time Brawl Stars data from your AI assistants or LLMs. It wraps the Brawl Stars API and exposes a set of endpoints and tools so you can fetch player profiles, brawler details, clubs, events, maps, and more in a structured, MCP-friendly way.

How to use

Your AI assistant can query a range of data about players, clubs, brawlers, events, maps, and game modes through a Model Context Protocol (MCP) server. You interact with the server by configuring your MCP client to connect to the provided stdio command. Once connected, you can request information such as a player’s profile, recent battles, or club members, and you can fetch current and upcoming events or map data.

How to install

Prerequisites you need on your machine before installing the MCP server:

Node.js 18.0.0 or higher
A Brawl Stars API token from the Brawl Stars Developer Portal

Step-by-step installation from source or package

Install the MCP server globally (recommended for quick setup) with npm:

npm install -g brawl-stars-mcp

If you prefer to install from source (clone, install dependencies, then build):

git clone https://github.com/LRxDarkDevil/Brawl-Stars-MCP.git
cd Brawl-Stars-MCP
npm install
npm run build

Run and start using the MCP server

After installation, start the server using the standard MCP command configuration provided for client integrations. You will typically run the package via npx with your API token as a parameter.

Example start command you can use in your MCP client configuration is shown in the dedicated configuration snippet.

Configuration for MCP clients

Configure your MCP client to connect to the Brawl Stars MCP server using the following stdio configuration. This example uses npx to run the MCP server and passes your API token at runtime.

{
  "mcpServers": {
    "brawlstars": {
      "command": "npx",
      "args": ["brawl-stars-mcp", "--token", "YOUR_API_TOKEN_HERE"]
    }
  }
}

Available tools

get_player

Get player information by tag including profile and statistics.

get_player_battlelog

Retrieve a player's recent battles and outcomes.

get_brawler

Fetch information about a specific brawler by ID.

get_brawlers

List all available brawlers with their stats and details.

get_club

Get club information by tag.

get_club_members

Retrieve the member list for a specific club.

get_events

Obtain current and upcoming events in the game.

get_maps

Access available maps and rotation information.

get_game_modes

Query information about different game modes.