# Clash Royale Tactical Intelligence MCP for AI Agents MCP

> Clash Royale Tactical Intelligence provides your AI client with professional-grade access to Supercell's official database. You can analyze detailed player battle logs, predict future chest rotations for optimized rewards, and monitor real-time clan war progress. This MCP gives you deep insights into deck compositions and global rankings, turning raw game data into actionable strategy.

## Overview
- **Category:** data-analytics
- **Price:** Free
- **Tags:** game-data, battle-logs, chest-cycle, tactical-analysis, player-profiles, api-access

## Description

This connector equips your AI client with tactical intelligence for Clash Royale players and strategists. Instead of manually checking multiple leaderboards or cross-referencing old match reports, your agent instantly pulls comprehensive data directly from the source. You can ask about a player's recent history to identify common opponent decks, check how far out you are on your chest cycle to plan optimal resource spending, or audit your entire clan's progress in River Race. It acts like having a dedicated coach who reviews every match for you, all through natural conversation. Once connected via Vinkius, your AI client can use this MCP alongside thousands of others to build complex strategies across multiple games and services.

## Tools

### get_battle_log
Retrieves a comprehensive record of a player's recent match performance.

### get_upcoming_chests
Lists the sequence and type of chests you will receive in your current reward cycle.

### get_clan_details
Provides a complete profile summary for any specific Clash Royale clan.

### get_clan_members
Outputs a list of all active members belonging to a specified clan.

### get_player_profile
Pulls detailed stats, including the current deck and general profile information for one player.

### get_location_rankings
Finds top players, clans, or war groups based on a specific geographic location ID.

### get_current_river_race
Displays the real-time status and current standings of ongoing Clan Wars.

### get_river_race_history
Retrieves past results and performance metrics for a clan's previous Clan War attempts.

### list_global_seasons
Lists all historical global seasons that have taken place in the game.

### get_global_tournaments
Fetches details about any currently active or upcoming global tournaments.

### list_all_cards
Provides a complete catalog of every available card in the game's database.

### list_locations
Generates a list of all country or location IDs you can query data against.

### search_clans
Finds existing clans based on partial or full name searches.

## Prompt Examples

**Prompt:** 
```
Analyze my last 5 battles and show the decks my opponents used.
```

**Response:** 
```
**Battle Log Analysis: Last 5 Matches**

*   Match 1 Opponent Deck: Miner Control (Win Condition: Miner)
*   Match 2 Opponent Deck: Golem Beatdown (Win Condition: Golem)
*   Match 3 Opponent Deck: Log Bait Spam (Win Condition: Goblin Barrel)
*   Match 4 Opponent Deck: Skeleton Army Push (Win Condition: Skarmy)
*   Match 5 Opponent Deck: Miner Control (Win Condition: Miner)

**Observation:** Your opponents are favoring low-cost, high-impact win conditions. Focus on cards that counter Goblin Barrel and Golem push.
```

**Prompt:** 
```
What's happening with the clan war right now?
```

**Response:** 
```
**Clan War Status Report (Current)**

*   **Rank:** 2nd Place Global
*   **Fame Points:** 8,450 / 10,000
*   **Leader Gap:** Trailing the leader by 500 points.
*   **Activity Today:** 15/30 members have attacked. **ACTION NEEDED**: The list of unparticipating members is attached for immediate coordination.
```

**Prompt:** 
```
When do I get my next big reward chest?
```

**Response:** 
```
**Upcoming Chest Rotation (Next 20 Slots)**

The current cycle shows a steady stream of Silver and Gold chests. Key rewards include:

*   **+4 Slots:** Giant Chest (High Value)
*   **+15 Slots:** Magical Chest (Very High Value)
*   **+22 Slots:** Legendary Chest (Top Priority)
```

## Capabilities

### Analyze full battle history
Retrieve detailed logs of a player's recent matches, including crowns won and the opponent decks used.

### Predict reward cycles
Check your next set of chests in rotation to optimize when you play for maximum rewards.

### Audit clan performance
Get full details on a clan's status, list all members, and track real-time progress during Clan Wars.

### Benchmark global rankings
Fetch official leaderboards and player metrics across different regions or leagues worldwide.

## Use Cases

### Reviewing an opponent's meta deck
A competitive player asks their agent to review the last 10 matches. The agent runs `get_battle_log` and reports that the opponent relies heavily on 'Graveyard Spam', allowing the user to prepare a specific counter-deck.

### Planning for rewards milestones
A player asks, 'When do I get my next big chest?' The agent checks the reward cycle using `get_upcoming_chests` and advises them that a Giant Chest is coming in 12 days, so they should focus on other goals until then.

### Managing large clan participation
The Clan Leader needs to know who hasn't attacked during the war. They use `get_clan_members` and cross-reference it with current war data via `get_current_river_race`, getting a targeted list of inactive members.

### Finding high-ranking opponents
A player wants to challenge top talent. They use the location ranking tool, specifying 'International' and 'Players', instantly retrieving the IDs and profiles of the top 10 players globally for a duel.

## Benefits

- Identify opponent weaknesses quickly. Using `get_battle_log` lets your agent analyze multiple matches to spot recurring deck archetypes, giving you a strategic edge.
- Optimize rewards instead of guessing. Check the future reward stream using `get_upcoming_chests` so you know exactly when a Giant or Magical Chest drops next.
- Coordinate clan efforts efficiently. You can audit who has played and who hasn't by listing members via `get_clan_members`, keeping your team in sync during crucial Clan Wars.
- Benchmark against the best globally. The `get_location_rankings` tool lets you compare your clan’s standing directly against top players in other regions.
- Track war progress instantly. Never miss a critical update; `get_current_river_race` gives you real-time fame scores and ranking data for immediate decision-making.

## How It Works

The bottom line is that once connected, your AI client treats this MCP like a dedicated tactical database, allowing you to query complex gaming stats without writing any code.

1. Subscribe to this MCP on Vinkius.
2. Enter your Clash Royale API Key from the developer portal into your chosen AI client (Claude, Cursor, etc.).
3. Tell your agent what you need—for example, 'What did my opponent use in my last five battles?' and get instant data.

## Frequently Asked Questions

**How can Clash Royale Tactical Intelligence help me find the best opponents?**
This MCP lets you query global rankings by specific locations or leagues. You can use it to fetch profiles of high-ranking players, giving you a list of top targets for practice duels.

**Does Clash Royale Tactical Intelligence track my clan's overall health?**
Yes, it provides real-time Clan War status and allows you to audit member participation. You can see exactly who needs to act to help boost your fame score and keep the team coordinated.

**Can I use this MCP to predict card availability?**
While it can't predict future game updates, it provides a complete catalog of all current cards in the game using `list_all_cards`, helping you audit global card usage and strategies.

**Is Clash Royale Tactical Intelligence better than checking forums for war status?**
Absolutely. Instead of relying on anecdotal reports, this MCP pulls verifiable, real-time data directly from the game's official stats, giving you precise fame scores and participation metrics.

**How do I use Clash Royale Tactical Intelligence for my own strategy?**
You just ask your agent. Tell it to analyze your last five battles. It will process the logs and report back on common opponent decks, helping you identify specific weaknesses in your current build.