# Clash of Clans War Analytics MCP for AI Agents AI Agent Connect > Clash of Clans Strategy & War Analytics MCP gives your AI agent direct access to the Supercell database. Stop manually checking war logs or scrolling through player profiles. It lets you audit clan war performance, track real-time destruction stats, and analyze hero levels instantly. It's the right way to turn raw game data into a tactical advantage for your clan and make your leadership decisions faster. ## Overview - **Category:** data-analytics - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_8GpF9IxPTzwRgQRqtns31pPVH5MYugBoHIr2XJHG/ai-agent-connect - **Tags:** game-data, clan-wars, player-stats, real-time-monitoring, strategic-intelligence, api-access ## Description Clash of Clans Strategy & War Analytics MCP lets you stop switching between the game app, a web browser, and a spreadsheet just to figure out who is winning a war or which players need better gear. This Connector changes that by letting your AI agent handle the heavy lifting. Instead of digging through logs, you can just ask your agent to summarize the current war status or find the strongest players in a specific region. You will get a clear picture of your clan's performance without the manual data entry. It makes the game feel more like a strategy operation and less like a chore. You can find this and other tools in the Vinkius catalog to keep your data organized. It fits right into your existing setup, making it easy to pull in the data you actually need when you need it. You can ask for troop levels, hero counts, and trophy rankings in a single prompt. This means you can spend less time looking at numbers and more time actually leading your clan to victory. It turns your AI into a dedicated researcher that knows the state of the game as well as you do. You can look up specific player tags to see their entire history or search for new clans to join. Everything stays in one place so you never have to hunt for information again. ## Tools ### get_player_profile Get detailed stats for any specific player. You can check hero levels and trophy counts in one go. ### get_clan_war_log Retrieve the full war history for a clan. This lets you analyze past win and loss streaks. ### list_official_labels List official clan or player labels and tags. This helps you find specific categories of players. ### list_trophy_leagues See all available trophy league tiers. It gives you a clear view of the ranking structure. ### list_locations Get a list of all available country and location IDs. Use these IDs to filter your ranking searches. ### list_war_leagues List all available Clan War League tiers. This helps you understand the different competition levels. ### search_clans Search for clans by their name. It's the fastest way to find a specific community. ### get_cwl_group Get the current status of a Clan War League group. It helps you see where your clan stands in the league. ### get_capital_raid_seasons View the history of Clan Capital raids. You can use this to see past performance trends. ### get_clan_details Pull a full profile for a clan using its unique tag. This is great for scouting new potential allies. ### get_current_war See the live status of an ongoing clan war. It shows you the current score and remaining attacks. ### get_gold_pass_season Check the current Gold Pass season rewards. It keeps you updated on what's currently available. ### get_location_rankings Find top players or clans in a specific location. Use locationId 32000006 for international rankings. ### get_clan_members List all members of a clan along with their roles and stats. Use this to audit your roster quickly. ## Prompt Examples **Prompt:** ``` Who are the top 5 clans in Brazil right now? ``` **Response:** ``` ### Top 5 Clans in Brazil Based on current trophy rankings, here are the top 5 clans in the region: | Rank | Clan Name | Trophies | | :--- | :--- | :--- | | 1 | Clan A | 65,000+ | | 2 | Clan B | 63,400 | | 3 | Clan C | 62,100 | | 4 | Clan D | 60,900 | | 5 | Clan E | 59,800 | Would you like to see the requirements to join the top-ranked clan? ``` **Prompt:** ``` Check the war for clan #2PP and tell me the score. ``` **Response:** ``` ### Clan #2PP War Status Clan **#2PP** is currently in a war against **Opponent Clan**. * **Current Score:** 45 - 42 (In your favor) * **Remaining Attacks:** 15 * **Average Destruction:** 92.5% Would you like to see which members still have attacks left? ``` **Prompt:** ``` What are the hero levels for player #PUUID123? ``` **Response:** ``` ### Player Profile: #PUUID123 I've inspected the profile for player **#PUUID123**. Here are their current hero levels: * **Barbarian King:** Level 85 * **Archer Queen:** Level 90 * **Grand Warden:** Level 65 They have also earned a total of **1,540 War Stars**. Would you like to see their troop levels for specific war compositions? ``` ## Capabilities ### Audit live war scores Get real-time updates on current war scores and destruction percentages. ### Scout opponent hero levels Fetch detailed hero and troop stats for any player tag. ### Search for top-tier clans Find specific clans by name to scout for recruitment or alliances. ### Monitor seasonal rewards Check the latest Gold Pass rewards and league information. ### Track historical war logs Analyze past win and loss streaks to identify performance trends. ## Use Cases ### Planning a targeted attack A leader asks the agent to scout a specific player's hero levels to plan an attack using get_player_profile. ### Auditing inactive clan members A co-leader wants to see which members haven't participated in the last few wars using get_clan_members. ### Finding a new competitive clan A player wants to see the top clans in Brazil to find a new home using get_location_rankings. ### Checking current season rewards A player wants to see what rewards are currently available in the Gold Pass using get_gold_pass_season. ## Benefits - Stop manual log checking: Use get_current_war to see scores instantly without opening the game. This saves you from having to keep a manual tally of stars and destruction percentages during every war. - Better scouting: Use get_player_profile to see hero levels and troop stats before you start a war. You can quickly assess the threat level of enemy members without having to guess their progress. - Faster roster audits: Use get_clan_members to see who is active and what their roles are in seconds. This helps you identify inactive members and ensure your clan is properly organized for upcoming events. - Regional insights: Use get_location_rankings to see how your clan stacks up against the best in the world. You can monitor the competition and find out which clans are leading the pack in your own country. - Historical analysis: Use get_clan_war_log to find patterns in your wins and losses over time. It helps you understand which strategies work best and where your team needs to improve their coordination. ## How It Works The bottom line is you get a live tactical dashboard for your clan's performance through a simple chat interface. 1. Subscribe to the Connector on Vinkius. 2. Paste your Supercell Developer API Key into your AI client. 3. Ask your agent to check war scores or scout players. ## Frequently Asked Questions **Can I use the Clash of Clans Strategy & War Analytics MCP to see live war scores?** Yes, it pulls real-time data from the game so you can see the current score, remaining attacks, and destruction percentages in a single chat. **How do I scout other players with the Clash of Clans Strategy & War Analytics MCP?** You can ask your agent to fetch the profile for any specific player tag. It will return their hero levels, trophy counts, and other key stats instantly. **Does the Clash of Clans Strategy & War Analytics MCP work for global rankings?** Yes, it can pull location rankings for different regions. You can find out which clans or players are leading the pack in your own country or globally. **Can I use the Clash of Clans Strategy & War Analytics MCP to manage my clan members?** It allows you to list all members of a clan along with their roles and stats. This is perfect for auditing your roster and checking who is active. **Is the Clash of Clans Strategy & War Analytics MCP good for planning war attacks?** It is excellent for planning because it lets you scout enemy hero levels and troop progress before you start, giving you a clear tactical advantage. **How do I get my API key for the Clash of Clans Strategy & War Analytics MCP?** You can obtain your API Key (JWT) from the official Supercell Developer Portal. Once you have it, you can paste it into your AI client to get started. **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.