Clash of Clans Analytics MCP. Audit war logs, check player stats, and track league progress.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
Clash of Clans Strategy & War Analytics. This server gives your AI agent deep, real-time access to the official Supercell database.
Track clan war logs, audit member stats, and monitor live war status, all through natural conversation. Use it to analyze player progression, find top-tier clans, and manage War League strategies without leaving your chat client.
What your AI agents can do
Get capital raid seasons
Retrieves the historical records for Clan Capital raids.
Get clan details
Gets the full profile information for a specified Clash of Clans clan using its tag.
Get clan members
Lists every member of a clan, showing their role and current stats.
Checks the current status of an active clan war, providing scores, remaining attacks, and destruction percentages.
Retrieves full details about a clan, lists all members with their roles and stats, and reviews past war activity.
Fetches detailed stats for any player tag, including hero levels, trophy counts, and progress metrics.
Gets information on current Gold Pass seasons, Clan Capital raid history, and general location rankings.
Searches for clans by name or lists official tags and available league tiers.
Ask AI about this MCP
Supported MCP Clients
Gemini Waiting for input…
019d8425get capital raid seasons
Retrieves the historical records for Clan Capital raids.
019d8425get clan details
Gets the full profile information for a specified Clash of Clans clan using its tag.
019d8425get clan members
Lists every member of a clan, showing their role and current stats.
019d8425get clan war log
Pulls a complete history of a clan's war activities.
019d8425get current war
Gets the live, moment-by-moment status of an ongoing clan war.
019d8425get cwl group
Retrieves the current status and group details for Clan War League participation.
019d8425get gold pass season
Gets the information for the current Gold Pass season.
019d8425get location rankings
Gets the top players or clans for a specific geographical location.
019d8425get player profile
Fetches detailed statistics for a specific Clash of Clans player tag.
019d8425list locations
Lists all country or location IDs available for querying rankings.
019d8425list official labels
Lists all official clan or player tags available in the game.
019d8425list trophy leagues
Lists every available tier in the trophy ranking system.
019d8425list war leagues
Lists every available tier in the Clan War League system.
019d8425search clans
Searches for clans by providing a specific name.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Clash of Clans Strategy & War Analytics, then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,700+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
What you can do with this MCP connector
You're gonna get deep, real-time stats for Clash of Clans. This server connects your AI client straight to the official Supercell database. Your agent turns raw game data into actionable intel, letting you analyze clan strategy and war progress just by talking to it.
Auditing Clans and War Logs
- You can get a clan's full profile details using its tag (
get_clan_details). - It lists every member in the clan, showing their roles and current stats (
get_clan_members). - You can pull a complete history of the clan's war activities (
get_clan_war_log). - It tells you the live status of an ongoing clan war, including scores, remaining attacks, and destruction percentages (
get_current_war). - You can check the current status and group details for Clan War League participation (
get_cwl_group). - It lets you search for clans by name (
search_clans) and lists all official clan or player tags available in the game (list_official_labels).
Checking Player Stats
- You can fetch detailed statistics for any specific player tag, including hero levels, trophy counts, and progress metrics (
get_player_profile).
Tracking Leagues and Raids
- You can get info on the current Gold Pass season (
get_gold_pass_season). - You can retrieve historical records for Clan Capital raids (
get_capital_raid_seasons). - It gives you top players or clans for a specific geographical location (
get_location_rankings), and you can list all available location IDs for this query (list_locations). - You can list every available tier in the trophy ranking system (
list_trophy_leagues) and every available tier in the Clan War League system (list_war_leagues).
Finding Clues
- You can search for clans by name (
search_clans).
How Clash of Clans Analytics MCP Works
- 1 Subscribe to the server and input your Clash of Clans API Key (JWT) from the Developer Portal.
- 2 Ask your AI client a question, like 'Check the war status for #2PP.'
- 3 The agent runs the necessary tools (e.g.,
get_current_war) and returns a conversational summary of the data.
The bottom line is you talk to your agent, and it handles the complex data calls behind the scenes.
Who Is Clash of Clans Analytics MCP For?
This is for the clan leader who needs to run a full strategic audit of their roster before a war. It's for the competitive player who needs to benchmark their heroes against the global top tier. If you spend time manually checking multiple websites for war stats, this saves you hours.
Automates auditing member performance, tracking war participation, and coordinating strategy based on real-time data.
Compares personal stats—like hero levels and total war stars—against global leaderboards and top-ranked opponents.
Gathers structured data on league tiers, raid histories, and player tags to build external reports or educational content.
What Changes When You Connect
- See the full roster and roles instantly. Use
get_clan_membersto list every member of a clan, checking who is active, who is a co-leader, and what their current stats are. - Know the war status at a glance.
get_current_warprovides live metrics on ongoing wars, including the current score and remaining attacks for the clan. - Deep dive into history. Run
get_clan_war_logto pull a full record of a clan's war history, letting you spot trends in wins and losses. - Benchmark player power.
get_player_profilepulls comprehensive stats for any player tag, covering hero levels, troop progress, and total war stars. - Understand league context. Use
list_trophy_leaguesorlist_war_leaguesto see all available tiers, giving you context for current rankings. - Check seasonal progress.
get_capital_raid_seasonstracks raid history, whileget_gold_pass_seasonkeeps you updated on current seasonal rewards.
Real-World Use Cases
The War Preparation Audit
A clan leader needs to know if their team is ready for a major war. They ask their agent to run get_clan_members and get_clan_war_log. The agent compiles a report showing who is missing attacks, who hasn't participated recently, and what the team's overall win/loss streak is. The leader can then assign specific roles to fix weaknesses before the war starts.
Benchmarking a Rival Clan
You suspect a rival clan is stronger than they look. You ask your agent to use search_clans to find the clan, then run get_clan_details and get_location_rankings. The agent gives you the clan's official profile, its current ranking in the area, and a summary of its top players, letting you plan a counter-strategy.
Tracking Personal Progress
You want to know exactly how far along you are in the current league cycle. You ask your agent to use get_player_profile and get_gold_pass_season. The agent provides your current hero levels, your total war stars, and what rewards you're close to earning, making your goals concrete.
Debugging League Issues
The clan is complaining about confusing league boundaries. You ask your agent to run list_trophy_leagues and list_war_leagues. The agent returns a list of all possible tiers, immediately clarifying the boundaries for everyone and confirming the current status using get_cwl_group.
The Tradeoffs
Treating data points as standalone lookups
Just running get_player_profile for three players and get_clan_details separately. You get four separate JSON dumps—a massive mess that doesn't answer the question: 'Are these players ready for war?'
→
Instead, ask your agent a single question: 'Analyze the readiness of these three players for a war.' The agent knows it needs to combine get_player_profile with get_clan_members to give a single, cohesive answer.
Forgetting to check the war context
Relying only on get_clan_details to plan a war. You see the clan name and trophy count, but you don't know if they are currently fighting or if their members are rested.
→
Always start by running get_current_war to see if the clan is actively fighting. Then, run get_clan_members to check the roster's current activity level. This prevents basing strategy on outdated data.
Overlooking league boundaries
Assuming a clan's status based on just their current trophy count. You don't know if the league they are in is the highest available or if they are nearing a promotion threshold.
→
First, run list_trophy_leagues to understand the full spectrum of available tiers. Then, use get_clan_details to verify their current placement. This confirms the scope of their competitive standing.
When It Fits, When It Doesn't
Use this server if you need to build a full picture of a clan's operational health. You need to know the why behind the data: Why did the clan lose the war? Because the war log (get_clan_war_log) shows a pattern of low-star attacks, and the current roster (get_clan_members) shows many members are below the required Town Hall level. Don't use it if you only need one piece of data, like just the current war status. For a single lookup, use a specialized tool like get_player_profile directly. If you need to know what leagues exist, use list_trophy_leagues; don't try to deduce it from a single clan's current score.
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Clash of Clans. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 14 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Available Capabilities
Manually tracking war stats is a headache.
Right now, checking a clan's readiness means hopping between the game, opening external spreadsheet trackers, and manually copying member names and war scores. You're constantly piecing together data from different tabs, and if one metric is old, your entire plan is garbage.
With this MCP server, you just ask your agent. It runs `get_clan_members` and `get_clan_war_log` and gives you a single, structured report. You get the full tactical picture, instantly.
War & Clan Metrics MCP Server: Get the full picture.
Manual checks for league boundaries involve opening multiple developer wikis, cross-referencing trophy caps, and figuring out which league tiers are even possible. It's a frustrating, non-linear process.
Now, your agent calls `list_trophy_leagues` and `list_war_leagues`. It spits out every available tier. You stop guessing and start planning.
Common Questions About Clash of Clans Analytics MCP
How do I use get_clan_details to find a clan's general status? +
You give the tool the clan tag and it returns the full profile. This includes the clan's name, member count, and whether they are active. It's the starting point for any audit.
Can I use get_current_war to see the live status of a war? +
Yes. You provide the relevant clan tag, and the tool returns the real-time score, remaining attacks, and destruction metrics for the ongoing battle.
What is the difference between get_clan_members and get_player_profile? +
get_clan_members lists everyone in the clan. get_player_profile gives deep stats for one specific player, like hero levels or trophy history, regardless of their clan.
How do I check a clan's historical performance? +
Run get_clan_war_log to get a detailed history of past war engagements. This shows how the clan performed over time, helping you identify consistent strengths or weaknesses.
Can I find the top clans in a region using get_location_rankings? +
Yes. You specify the location ID and whether you want clan or player rankings. The tool then retrieves the top-ranked entities for that region.
How do I use get_clan_war_log to analyze historical win/loss streaks? +
It retrieves a comprehensive record of past war battles. This log shows every battle date, outcome, and the specific opponent clan involved, letting you track long-term trends.
What is the purpose of get_player_profile when checking a player's overall status? +
It fetches a full statistical breakdown of a player. You get their Town Hall level, total trophy count, and donation ratio, which are key metrics for assessing skill.
How do I check for available leagues or location IDs using list_trophy_leagues or list_locations? +
These tools provide reference data for the system. Use list_trophy_leagues to see all available trophy tiers, and list_locations to get valid country/region identifiers.
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.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
FRED Series — U.S. Economic Time Series
Search and retrieve data from 816,000+ official U.S. economic time series: GDP, inflation, unemployment, interest rates, money supply — with built-in transformations, frequency aggregation, and vintage analysis.
Ambee Soil
Access real-time soil data via Ambee — monitor soil moisture, temperature, and properties globally for precision agriculture from any AI agent.
MIT DBLP
Search millions of computer science publications, find author profiles, and explore academic citation networks across conferences.
You might also like
Open Exchange Rates
Access real-time and historical currency exchange rates for 200+ currencies. Convert values, track time series, and analyze OHLC data directly from your AI agent.
HypeAuditor
Analyze influencers and retrieve reports via HypeAuditor API.
Froged
Manage customer success, track events, and handle omnichannel support via AI agents with Froged.