Clash of Clans Analytics MCP for AI. Audit War Logs and Player Strength Instantly
Works with every AI agent you already use
…and any MCP-compatible client








Connect to your AI in seconds.
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.
What your AI can do
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 immediate updates on an ongoing clan war, including the current score and remaining attacks.
List all members of a clan, seeing their specific roles and individual performance statistics.
Retrieve a record of past battles for a clan to understand historical win/loss patterns.
Fetch detailed stats for any player tag, including hero levels and total war stars earned.
Check the top-performing clans or players in specific geographic locations across different leagues.
Ask an AI about this
Waiting for input…
Clash of Clans Strategy & War Analytics (14 Tools)
Use these 14 tools to retrieve every kind of data point—from live war scores to historical raid records—to give your AI client complete game intelligence.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using Clash of Clans Strategy & War Analytics on VinkiusGet 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...
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.
Security and governance baked right in.
Pick your AI client below to get set up. Just create a Vinkius account, subscribe, and you're instantly up and running. We handle the entire backend infrastructure, delivering out-of-the-box support for HTTPS Streamable, SSE, and OAuth2—zero messy routing required.
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 5,100+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 5,100+ 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
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 connection provides 14 powerful capabilities that interface natively with Claude, ChatGPT, Cursor, and other compatible AI platforms. No middleware. No custom integration required.
Tracking Clash Clan Progress Used to Be a Spreadsheet Nightmare
Today, tracking clan progress means logging into the game, taking screenshots of war logs, manually copying player stats from one corner of the screen, and pasting them into a spreadsheet. Then you spend hours trying to figure out if the numbers are even comparable across different leagues or regions. It's tedious, high-friction work that makes planning feel like homework.
With this MCP, all that manual data collection disappears. You simply ask your agent for `get_clan_war_log` and it gives you clean, structured data immediately. Your client hands you the finished analysis; no copy-pasting involved.
Getting War History with get_clan_war_log
Before this MCP, getting a full view of war history meant scrolling through dozens of old matches until you got tired. You could only see the summary, not the granular details about who attacked whom and how many stars were involved.
Now, running `get_clan_war_log` pulls every relevant historical record into one place. It’s a complete audit trail that lets you analyze performance trends years in the making.
What your AI can actually do with this
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.
019d8425-c85c-725f-a41d-46be3bc05c6c Here's how it actually works
The bottom line is that your AI client handles all the complex data querying; you just ask questions in plain English.
First, subscribe to this MCP and input your Clash of Clans API Key (JWT) into your AI client.
Next, tell your agent exactly what you need—for example, 'What is the current war score for clan #2PP?'
Finally, the agent uses the available tools to query Supercell's database and delivers the specific metrics right back to you.
Who is this actually for?
This MCP is for serious players and leaders who treat Clash of Clans like a strategic operation. If you're tired of jumping between multiple forums or spreadsheet tabs to compile war data, this tool saves time.
You use it to automatically audit member performance and track if everyone is ready for the next War League challenge.
You rely on it to compare your technical stats (like hero levels) against top global opponents before a major tournament.
You need to pull structured data, like listing all official league tiers or mapping out historical war trends across multiple regions.
What Changes When You Connect
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.
See it in action
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.
The honest tradeoffs
Treating it like a simple search engine
Just asking 'What's good in Clash of Clans?' This gets vague results because you haven't specified what data point matters.
Be specific. Use the tools. If you want to see member roles, ask for get_clan_members. If you need battle outcomes, use get_clan_war_log.
Trying to get all league data at once
Asking the agent to 'Show me all ranking info.' The request is too broad and leads to incomplete or generic results.
Break it down. First, use list_trophy_leagues to see the tiers. Then, run get_location_rankings using the exact league you care about.
Assuming all tags are valid
Sending an invalid or non-existent player tag and expecting data.
Always verify your input. Use search_clans first to confirm the clan tag, then proceed with tools like get_clan_details.
When It Fits, When It Doesn't
Use this MCP if you need deep, granular metrics and historical data on player or clan performance. This is for strategists who care about specific numbers: war scores, hero levels, donation ratios, and league tiers. If your goal is simple, quick information—like 'What's the current news?' or 'How do I reset my password?'—this MCP isn't needed. Those tasks require general communication tools. You need this when you want to cross-reference multiple data points; for example, checking a player's get_player_profile and comparing those stats against their clan’s recent history using get_clan_war_log. Don't use it if you just need basic text generation or simple image manipulation.
Questions you might have
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.
We've already built the connector for Clash of Clans Analytics. Just plug in your AI agents and start using Vinkius.
No hosting. No infrastructure. No complex setup.
All 14 tools are live and waiting.
You're up and running in seconds.
Vinkius gives your AI agents access to the full catalog of app connectors, all fully managed, secure, and enterprise-ready. One subscription, every tool you need.
Built, hosted, and secured by Vinkius. You just connect and go.