# Clash Royale Tactical Intelligence MCP for AI Agents AI Agent Connect

> Clash Royale Tactical Intelligence. This Connector connects your agent to the official Supercell database to pull battle logs, track chest rotations, and monitor clan war progress. It turns your AI into a high-level coach that handles the heavy data lifting for competitive play and clan management.

## Overview
- **Category:** data-analytics
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_LcSMxpnXXuEkBUsUqq1sSq5huppzgEVQprCLAZHw/ai-agent-connect
- **Tags:** game-data, battle-logs, chest-cycle, tactical-analysis, player-profiles, api-access

## Description

Imagine you're trying to figure out why your clan keeps losing the River Race or why your favorite deck isn't performing as well as it should. Usually, this means digging through messy logs, checking multiple screens, and trying to remember which chests are coming up next. This Connector changes that by letting your AI do the digging for you. You can ask your agent to audit a specific player's match history to see exactly what decks they're facing or check your upcoming chest rotation to plan your next big upgrade. It takes the guesswork out of the game by providing clear, actionable data. Because this is hosted on the Vinkius marketplace, you get a reliable way to plug this data into your existing workflow without worrying about the backend plumbing. You just get the insights you need to make better calls on the battlefield. Whether you're looking for a specific card's global usage or trying to see which members are lagging in your clan, this tool puts the numbers right in front of you. You can stop scrolling and start strategizing.

## Tools

### get_battle_log
Get recent match history for a player. This helps you see which decks your opponents are running and identifies trends in your recent losses.

### get_upcoming_chests
Get the next chests in a player's rotation. You can plan your progression by knowing when a rare chest is coming.

### get_clan_details
Get full profile for a Clash Royale clan. This gives you an overview of a clan's standing and stats to scout rivals.

### get_clan_members
List all members of a clan. This makes it easy to see who's active in your group and who has participated in the war.

### get_river_race_history
Get past River Race results for a clan. This shows how your clan has performed in previous wars over time.

### list_global_seasons
List all past global seasons. This helps you see how the game's meta has shifted over time.

### get_global_tournaments
Get current global tournaments. This lets you see what events are happening right now in the competitive scene.

### list_all_cards
List all available cards in the game. This provides a full list of every card in Clash Royale for your reference.

### list_locations
List all available country/location IDs. This gives you the IDs needed to query specific regions and local leaderboards.

### search_clans
Search for clans by name. This lets you find specific groups within the game to join or scout.

### get_player_profile
Get detailed profile and deck for a Clash Royale player. This lets you see a specific player's current loadout and stats.

### get_location_rankings
Get top players, clans, or war clans for a location. This helps you find the best competition in your specific region.

### get_current_river_race
Get real-time River Race status. This gives you an instant look at your clan's war progress and fame accumulation.

## Prompt Examples

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

**Response:** 
```
### Recent Battle Analysis
I've pulled your last 5 match logs. Here is the breakdown of what your opponents were running:

| Match # | Opponent Deck Type | Key Cards Used |
|---|---|---|
| 1 | Log Bait | Goblin Barrel, Princess, Knight |
| 2 | Pekka Bridge Spam | Pekka, Bandit, Battle Ram |
| 3 | Log Bait | Goblin Barrel, Princess, Knight |
| 4 | Giant Beatdown | Giant, Witch, Musketeer |
| 5 | Pekka Bridge Spam | Pekka, Bandit, Battle Ram |

**Summary:** You are facing **Log Bait** and **Pekka Bridge Spam** variations most frequently. You might want to focus on building a more robust defense against Goblin Barrel spam.
```

**Prompt:** 
```
What are the next 10 chests in my rotation?
```

**Response:** 
```
### Upcoming Chest Rotation
Here are the next 10 chests in your cycle:

1. 🪙 Silver Chest
2. 🪙 Silver Chest
3. 🪙 Gold Chest
4. 💎 **Giant Chest** (Coming in +4 slots)
5. 🪙 Silver Chest
6. 🪙 Silver Chest
7. 🪙 Gold Chest
8. 🪙 Gold Chest
9. 🪙 Silver Chest
10. 🪙 Gold Chest

**Note:** You have a **Giant Chest** coming up soon. You should save your gold for this drop!
```

**Prompt:** 
```
Show the current River Race standings and fame for my clan '#CLANTAG'.
```

**Response:** 
```
### River Race Status: #CLANTAG

*   **Current Rank:** 2nd Place
*   **Fame Points:** 8,450
*   **Status:** Trailing the leader by 500 points.

**Activity Update:**
*   **Completed Attacks:** 15 members have finished their attacks today.
*   **Pending:** 5 members have not yet participated. 

Would you like me to list the specific members who haven't attacked yet?
```

## Capabilities

### Pull recent match history
Get the exact decks and results from your most recent battles to identify trends.

### Predict chest rotations
See what's coming up next in your reward cycle to plan your resource spending.

### Audit clan members
Get a full list of everyone in your clan to track participation and activity.

### Scout player profiles
Retrieve detailed deck compositions and stats for any specific player.

### Track River Race progress
Monitor real-time fame accumulation and war status for your clan.

### Benchmark global rankings
Fetch leaderboards for players and clans across different regions and leagues.

## Use Cases

### Auditing clan participation
A clan leader wants to see who hasn't attacked. Ask your agent to list all members using get_clan_members and compare them against the current River Race status from get_current_river_race.

### Identifying opponent trends
A player wants to know why they keep losing to a specific deck. Have your agent pull the last 5 matches with get_battle_log to identify common opponent strategies and card levels.

### Planning resource spending
A player wants to know when a Giant Chest is coming. Use get_upcoming_chests to see your rotation and plan your next major card upgrades to maximize your rewards.

### Regional scouting
A scout wants to see the top clans in a specific country. Ask your agent to fetch the top clans for a specific location ID using get_location_rankings to find the best local competition.

## Benefits

- Stop guessing what decks your opponents are using by pulling their exact match history with get_battle_log.
- Plan your progression more effectively by checking your next rare drops with get_upcoming_chests.
- Manage your clan more efficiently by quickly listing everyone in your group with get_clan_members.
- Scout your competition better by pulling detailed profiles and current decks using get_player_profile.
- Track your war progress in real-time with get_current_river_race to see exactly how much fame you've earned.
- Analyze the global meta by pulling historical data from list_global_seasons and get_global_tournaments.

## How It Works

The bottom line is you get a data-driven coach that knows every detail of your Clash Royale account and the global meta.

1. Subscribe to the Clash Royale Tactical Intelligence MCP on Vinkius.
2. Connect your Supercell Developer Portal API Key to your AI client.
3. Ask your agent to analyze your clan's stats or your own match history.

## Frequently Asked Questions

**Can Clash Royale Tactical Intelligence help me see my next rewards?**
Yes, it pulls your current chest rotation so you can see exactly what rewards are coming up next. This helps you plan your gold spending and card upgrades more effectively.

**How does Clash Royale Tactical Intelligence help with clan wars?**
It provides real-time updates on River Race status and fame. It can also list all your clan members, making it easy to see who has participated in the war and who is lagging behind.

**Can I use Clash Royale Tactical Intelligence to scout other players?**
Absolutely. You can pull detailed profiles for specific players to see their current decks, win/loss stats, and other key tactical information.

**Does Clash Royale Tactical Intelligence work for my local rankings?**
Yes, it can fetch top rankings for players and clans in specific locations. This allows you to benchmark your performance against the best players in your region.

**Can I see past seasons with Clash Royale Tactical Intelligence?**
Yes, it can list all past global seasons, which is great for analyzing how the game's meta and card usage have changed over time.

**How do I get my data into my AI client with Clash Royale Tactical Intelligence?**
Once you subscribe on Vinkius, you just need to add your Supercell Developer API key. From there, your AI client can access all the game data whenever you ask.

**Can my AI automatically predict which chest I will get next in my rotation?**
Yes! Use the `get_upcoming_chests` tool with your player tag. Your agent will respond with the next 10 chests in your specific sequence, including rare variants like Mega Lightning or Legendary chests.

**How do I analyze the deck of an opponent I just lost to?**
The `get_battle_log` action retrieves your most recent matches. The agent can extract the exact card list and levels used by your opponent, helping you identify tactical counters for future encounters.

**Does the integration permit tracking real-time progress in the Clan River Race?**
Yes. The `get_current_river_race` tool provides live fame points, rankings, and active participant data for your clan's current war, allowing for precise coordination during the competitive weekend.