# Clash of Clans Analytics MCP > Clash of Clans Strategy & War Analytics MCP gives your AI agent professional-grade intelligence directly from Supercell's database. Stop guessing about clan wars or player strength. This MCP lets you instantly audit live war status, track detailed member stats (like hero levels and troop progress), check global league rankings, and analyze deep historical performance data—all without logging into a single dashboard. ## Overview - **Category:** data-analytics - **Price:** Free - **Tags:** game-data, clan-wars, player-stats, real-time-monitoring, strategic-intelligence, api-access ## Description Running a successful clan requires way more than just sending out attacks; it demands real-time data on every player. This MCP feeds your AI agent professional strategy intelligence for Clash of Clans. Instead of manually tracking war logs or hunting down current league rankings, your agent instantly audits complex metrics. You can fetch granular stats on any member, checking their Town Hall level, trophy count, and donation ratio in seconds. Whether you're coordinating a War League push or just comparing your progress to the global leaderboard, your AI client acts like a dedicated tactical advisor through natural conversation. Since Vinkius hosts this MCP, you connect once from any compatible agent—like Claude or Cursor—and get access to all of these deep game metrics instantly. ## Tools ### get_cwl_group Gets the current group status for Clan War Leagues (CWL). ### get_capital_raid_seasons Retrieves the history and data for Clan Capital raids. ### get_clan_details Gets the full profile information, including details, for a specific clan tag. ### get_clan_members Lists every member in a clan and their associated roles and stats. ### get_current_war Retrieves the live, up-to-the-second status of an ongoing clan conflict. ### get_gold_pass_season Provides information on the current Gold Pass season rewards and progress. ### get_player_profile Retrieves comprehensive, detailed statistics about any single Clash of Clans player tag. ### get_location_rankings Fetches the top-ranked players or clans for a specific location ID across different types. ### get_clan_war_log Pulls the complete war history record for any given clan tag. ### list_official_labels Lists the official tags used by clans or players (e.g., 'Builder'). ### list_trophy_leagues Retrieves a list of all available trophy league tiers in the game. ### list_locations Lists all country or regional location IDs available for ranking queries. ### list_war_leagues Provides a list of all current Clan War League (CWL) tier names. ### search_clans Searches for clans by inputting part or all of their name. ## Prompt Examples **Prompt:** ``` Analyze the current war status for clan tag '#2PP' and show the current score. ``` **Response:** ``` Retrieving live war data... Clan '#2PP' is currently in war against 'Opponent Clan'. The score is 45-42 in your favor, with 15 attacks remaining. Your destruction percentage is at 92.5%. Would you like to see which members still have attacks left? ``` **Prompt:** ``` Get the hero levels and war stars for player tag '#PUUID123'. ``` **Response:** ``` Inspecting player profile... Player '#PUUID123' has a Barbarian King at Level 85, Archer Queen at Level 90, and Grand Warden at Level 65. They have earned a total of 1,540 War Stars. Would you like to see their troop levels for specific war compositions? ``` **Prompt:** ``` Show the top 5 clans in Brazil based on current trophy rankings. ``` **Response:** ``` Running the location audit for Brazil... The top 5 clans are currently 'Clan A', 'Clan B', 'Clan C', 'Clan D', and 'Clan E'. 'Clan A' leads with over 65,000 trophies. Shall I provide the requirements to join the number one ranked clan? ``` ## Capabilities ### Assess Live War Status Get immediate updates on an ongoing clan war, including the current score and remaining attacks. ### Audit Clan Roster Details List all members of a clan, seeing their specific roles and individual performance statistics. ### Analyze War History Logs Retrieve a record of past battles for a clan to understand historical win/loss patterns. ### Profile Individual Players Fetch detailed stats for any player tag, including hero levels and total war stars earned. ### Determine Global Rankings Check the top-performing clans or players in specific geographic locations across different leagues. ## Use Cases ### Analyzing a Potential Rival A player needs to know if a rival clan is weak in one area. They ask their agent to run `get_clan_details` and then follow up with `list_official_labels`. The agent synthesizes the data, revealing that while the clan has high trophy counts, they lack members with specific 'Elite' labels. ### Managing War League Readiness A leader needs to confirm who is ready for war. They ask their agent to use `get_clan_members` and then cross-reference the results against the live status using `get_current_war`. The agent flags members whose roles are outdated or haven't participated recently. ### Understanding Global Trends A strategist wants to know the best areas for competitive play. They instruct their agent to use `list_locations` first, then run `get_location_rankings` using a specific ID and 'clans' type to find the highest-ranking regional groups. ### Planning Major Attacks A player wants maximum power for an attack. They ask their agent to use `get_player_profile` on several tags, allowing them to compare specific hero levels and determine who has the most balanced force ready for war. ## Benefits - Stop manually tracking war outcomes. Use `get_clan_war_log` to instantly pull a clan's full battle history, letting you spot long-term win/loss patterns without scrolling through old records. - Know your opponent's weaknesses before the fight. Run `get_player_profile` on any player tag to see their exact hero levels and total war stars, giving you an edge in planning. - Coordinate better during War League events. Use `get_current_war` to check the live score and remaining attacks instantly, so your agent can tell you who needs to attack next. - Stay updated on seasonal goals. The `get_gold_pass_season` tool keeps you informed about current rewards, eliminating the need to check multiple in-game announcements for progress. - Benchmark your clan against the best. Use `get_location_rankings` with a specific location ID to see who's leading the global leaderboards right now. ## How It Works The bottom line is that your AI client handles all the complex data querying; you just ask questions in plain English. 1. First, subscribe to this MCP and input your Clash of Clans API Key (JWT) into your AI client. 2. Next, tell your agent exactly what you need—for example, 'What is the current war score for clan #2PP?' 3. Finally, the agent uses the available tools to query Supercell's database and delivers the specific metrics right back to you. ## Frequently Asked Questions **How do I check live war status using get_current_war?** You ask your agent to run `get_current_war`. It immediately gives you the real-time score, remaining attacks, and destruction percentage for the ongoing clan conflict. **What does get_player_profile provide about a player?** It delivers a detailed stats sheet including their Town Hall level, total trophy count, donation ratio, and specific hero levels for optimal war planning. **Do I need to use list_locations before get_location_rankings?** Yes. You should run `list_locations` first. This gives you the exact location IDs needed to make sure your `get_location_rankings` query targets the right region or country. **Can get_clan_members help me audit a clan?** Absolutely. Running `get_clan_members` lists every member and shows their current role, letting you quickly identify if any key positions are vacant or outdated. **I want to know our league position, but we aren't in a war right now. How do I check our status using get_cwl_group?** The tool provides the current standing and group metrics for Clan War Leagues (CWL). It tells you what league your clan belongs to and how close it is to advancing or falling back. **I don't have a tag, but I know the name of a rival clan. Can I find them using search_clans?** Yes, `search_clans` lets you look up clans by name instead of requiring their unique tag. This helps you verify if the clan exists and gives basic details about its current membership. **The live war status is helpful, but I need to review historical performance. How do I get a full record using get_clan_war_log?** This function pulls your clan's entire battle history. You can analyze win/loss streaks and see detailed records of past battles that the current status doesn't show. **When I run get_clan_details, what information do I need to ensure I get accurate data?** You must pass a complete clan tag formatted with the hash symbol (#). The tool needs this specific identifier to pull the full profile and avoid retrieving generic or incorrect data. **Can my AI automatically find the remaining attacks in our current clan war?** Yes! Use the `get_current_war` tool with your clan tag. Your agent will retrieve the real-time war state, including current stars, destruction percentage, and how many attacks each team has already used. **How do I check the hero levels and troop progress for a potential new member?** Simply provide the Player Tag to the agent and ask for player info. It will run the `get_player_profile` action to retrieve the full technical breakdown of their Town Hall level, hero levels, and troop levels directly from the track. **Does the integration allow auditing the historical performance of an opponent clan?** Yes. If the target clan has a public war log, the `get_clan_war_log` tool allows your agent to fetch their last 50 wars, providing data on their win/loss ratio and common destruction percentages.