# Brawl Stars MCP

> Brawl Stars provides real-time access to deep game analytics, letting you track player performance, map rotations, and global club rankings directly through your AI client. Get detailed stats on brawlers, analyze battle history for any tag, or manage community insights without leaving your agent interface.

## Overview
- **Category:** data-analytics
- **Price:** Free
- **Tags:** brawl-stars, supercell, game-stats, leaderboards, esports

## Description

Forget manually digging into multiple in-game dashboards or relying on scattered external websites. This MCP connects your agent to the core data of Brawl Stars. You can ask questions like, 'How did Player X perform against brawler Y last month?' and get a detailed breakdown instantly. It pulls everything together: from individual player profiles and trophy counts to analyzing the entire history of their last 25 matches. Need to manage a squad? You can check club details and view every member's status in one chat thread. Plus, it keeps you current on the meta by listing all available brawlers or telling you which maps are currently active for the event rotation. Connecting this through Vinkius means your AI client acts like a dedicated esports analyst that never sleeps.

## Tools

### get_brawler_rankings
Gets the current ranking data for individual brawlers globally or by country.

### get_brawler
Retrieves specific information about a brawler, like their primary stats.

### list_brawlers
Provides a complete list of every brawler available in the game.

### get_club_members
Lists all the players belonging to a specified club.

### get_club_rankings
Checks how well a club ranks globally or within a specific country.

### get_club
Pulls core details about a specific club, like its name and total trophies.

### get_event_rotation
Returns the list of maps and game modes currently active for events.

### get_player_battlelog
Retrieves the performance data from the last 25 battles for one player tag.

### get_player_rankings
Checks a player's current ranking status globally or in their region.

### get_player
Gets a player's current profile, stats, and trophy count.

## Prompt Examples

**Prompt:** 
```
Get the profile and stats for player tag #2P0GV9LU.
```

**Response:** 
```
I've retrieved the profile for player #2P0GV9LU. They currently have 32,450 trophies, belong to the club 'Brawl Stars Pro', and their highest trophies ever reached was 34,000. Would you like to see their most played brawlers?
```

**Prompt:** 
```
Show me the current global club rankings.
```

**Response:** 
```
Fetching global club rankings... The top 3 clubs currently are: 1. 'Nova Esports' (2.5M trophies), 2. 'Tribe Gaming' (2.4M trophies), and 3. 'SK Gaming' (2.35M trophies). Would you like to see the member list for any of these?
```

**Prompt:** 
```
What are the active maps and events right now?
```

**Response:** 
```
Checking event rotation... Currently active: Gem Grab on 'Hard Rock Mine', Solo Showdown on 'Feast or Famine', and Brawl Ball on 'Pinhole Punt'. New events will rotate in 4 hours. Should I check the upcoming maps as well?
```

## Capabilities

### Assess player history
Retrieve current statistics, trophy totals, and battle logs for any specific player tag.

### Analyze team structure
Get full details on a club, including its ranking and the member list.

### Determine current game meta
List all available brawlers or check which maps are active during the current event rotation.

### Track global standing
Query leaderboards for players, clubs, or specific brawlers across different regions.

## Use Cases

### Diagnosing a drop in performance
A coach needs to know why Player X's win rate dropped last week. They ask the agent, which uses get_player_battlelog and get_player. The AI reviews the 25 matches, noting that the player hasn't used their strongest brawler lately.

### Planning a tournament roster
A team captain needs to build a competitive squad. They use get_club_members and get_player_rankings to see which players are hitting peak form right now, ensuring the best lineup for the event.

### Understanding the current meta
A streamer wants to know what content is hot. They ask about brawler rankings and use get_brawler_rankings, getting immediate data on which characters are currently dominating the leaderboards.

## Benefits

- Review full performance histories using get_player_battlelog. Instead of sifting through dozens of screenshots, your agent analyzes the last 25 matches to pinpoint trends.
- Manage community visibility by checking club details and member lists with get_club and get_club_members. You'll know exactly who's in the squad and their current status.
- Keep up with game changes immediately. Use get_event_rotation to see what maps are active, eliminating guesswork about which modes you should be practicing for.
- Gauge competition standing by querying global leaderboards using get_player_rankings or get_club_rankings. Know exactly where your squad stands against the world.
- Get a complete picture of every character's status in one query. Use list_brawlers to see all available units and check their individual power levels with get_brawler.

## How It Works

The bottom line is that your AI agent handles all the API complexity; you just ask questions in plain English.

1. Subscribe to this MCP and provide your Brawl Stars API key.
2. Your AI client passes a natural language query (e.g., 'What are the top 3 clubs globally?') to the connector.
3. The tool executes the necessary data calls, returning structured stats that your agent reads back to you.

## Frequently Asked Questions

**Can I see a player's recent match history?**
Yes! Use the `get_player_battlelog` tool with the player's tag to retrieve the last 25 battles, including game modes, results, and trophies gained or lost.

**How do I find the best players for a specific brawler?**
Use the `get_brawler_rankings` tool. You will need to provide a country code (or 'global') and the numeric ID of the brawler, which you can find using `list_brawlers`.

**Can I check which maps are currently active in the game?**
Yes, the `get_event_rotation` tool provides real-time information on all current and upcoming map rotations across different game modes.

**What does the `get_club` tool return about a club?**
It provides core information like the club's official name, total member count, and current trophy ranking. This helps you verify basic details—like whether a club is active or how long it has been running.

**How do I use `list_brawlers` to get every available character?**
It returns a complete catalog of all brawlers currently in the game. This list includes their official name, primary role (damage/support), and rarity tier.

**Can `get_club_members` be used to view a club's full roster?**
Yes, this tool generates a direct list of every member ID within the specified club. It’s useful for auditing rosters or checking membership numbers without needing admin access.

**Beyond trophies, what data points does `get_player` provide?**
The player profile gives more than just current trophy counts; you also get the brawler levels and the highest total trophy count they've ever reached. This offers a better view of their peak performance.

**How do I limit my search when using `get_player_rankings`?**
You must specify the desired region or country code when calling this tool. Providing the scope ensures you are only comparing players within that specific geographical boundary.