Teamfight Tactics MCP Server - AI Game Analysis

Connect AI assistants to Teamfight Tactics data via Model Context Protocol. Let AI analyze your compositions, augment choices, placement trends & suggest optimal strategies. Access player profiles, match history, ranked stats & detailed game analysis — directly in Claude Desktop.

Why use this?

TFT is a game of decision-making under pressure. Every carousel pick, every augment choice, every level-up timing matters. But reviewing your own games is hard — you can't spot patterns across 20+ matches by memory alone.

This MCP server lets AI do the heavy lifting: it reads your match history, crunches the numbers, and gives you actionable coaching advice tailored to your rank and playstyle.

Features

• Player Profiles - Search players by Riot ID (gameName#tagLine) across all regions
• Ranked Stats - Get tier, rank, LP, win/loss ratio for Ranked TFT, Hyper Roll & Double Up
• Match History - Retrieve recent TFT matches with detailed statistics
• Composition Analysis - AI analyzes your trait synergies, unit choices & item builds
• Augment Optimization - Track which augments you win with and which ones cost you LP
• Performance Analysis - Let AI analyze your gameplay and suggest improvements
• Live Game - Check if a player is currently in a TFT match
• Player Comparison - Compare TFT stats between two players
• Data Dragon Integration - Unit, trait, item and augment names automatically resolved
• Intelligent Caching - Reduces API calls with smart TTL-based caching
• Multi-Region Support - EUW, NA, KR, BR, and all other servers

Quick Start

1. Get your Riot API Key

1. Go to Riot Developer Portal
2. Log in with your Riot Games account
3. Copy your Development API Key from the dashboard

Development keys expire every 24 hours. For permanent access, apply for a Personal key.

2. Configure the Actor

1. Go to the TFT MCP Server on Apify
2. Enter your Riot API Key in the Input tab
3. Click Save

3. Connect to Claude Desktop

1. Open Claude Desktop → Settings → Connectors
2. Click Add Custom Connector
3. Paste this URL:

https://scrapmania--teamfight-tactics-mcp-server---ai-game-analysis.apify.actor/mcp?token=YOUR_APIFY_TOKEN

Replace YOUR_APIFY_TOKEN with your Apify API token.

That's it! Claude can now access your Teamfight Tactics data.

Available Tools

Once connected, your AI assistant can use these tools:

Tool	Description
tft_get_account	Get account info by Riot ID (gameName#tagLine)
tft_get_ranked	Get TFT ranked stats (tier, rank, LP, wins/losses)
tft_get_player_profile	Get complete TFT player profile in one call
tft_get_match_history	Get list of recent TFT match IDs
tft_get_match_details	Get detailed info about a specific TFT match
tft_get_live_game	Check if a player is currently in a TFT game
tft_analyze_performance	Analyze recent TFT performance with recommendations
tft_analyze_composition	Analyze compositions, traits and item builds
tft_get_improvement_tips	Get personalized TFT improvement tips
tft_compare_players	Compare TFT stats between two players

What can AI do with your TFT data?

Post-game coaching

"I just finished a TFT session. Analyze my last 10 games — what comps am I forcing too often? Should I flex more?"

Augment optimization

"Look at my augment choices over my last 20 games. Which augments do I win with? Which ones am I picking but losing?"

Composition mastery

"What are my best compositions based on my match history? Which traits give me the highest average placement?"

Climbing strategy

"I'm stuck Platinum in TFT. Analyze my games — am I dying too early? Am I being too greedy with econ?"

Itemization advice

"Analyze my item builds in my last 15 games. Am I slamming items early enough? Which items give me my best placements?"

Economy management

"Am I managing my gold correctly? Compare my average level at key rounds vs players in my rank. Am I leveling too early or too late?"

Duo comparison (Double Up)

"Compare my TFT stats with my Double Up partner. Do we play similar comps? Who places higher on average?"

Improvement tracking

"Track my TFT progress: compare my average placement and top 4 rate this week vs last week."

Augment tier list

"Based on my last 30 games, build me a personal augment tier list. Which augments consistently give me top 4?"

Trait synergy analysis

"What trait combinations work best for me? When I play Arcana, what's my average placement vs when I play Witchcraft?"

Supported Regions

Region Code	Server
euw1	Europe West
eun1	Europe Nordic & East
na1	North America
kr	Korea
br1	Brazil
la1	Latin America North
la2	Latin America South
oc1	Oceania
tr1	Turkey
ru	Russia
jp1	Japan
ph2	Philippines
sg2	Singapore
th2	Thailand
tw2	Taiwan
vn2	Vietnam

API Key Types

Development Key (Default)

• Automatically generated when you sign in
• Expires every 24 hours
• Good for testing and personal use
• Rate limit: 20 requests / second, 100 requests / 2 minutes

Personal Key

• Does not expire
• For personal projects or small communities
• Register your product at developer.riotgames.com

Production Key

• Higher rate limits
• For public applications
• Requires product approval from Riot

Input Configuration

Field	Type	Required	Description
riotApiKey	string	Yes	Your Riot Games API key
defaultRegion	string	No	Default region (default: euw1)
defaultLanguage	string	No	Language for analysis (default: en)
cacheEnabled	boolean	No	Enable intelligent caching (default: true)

Output

The MCP server exposes Teamfight Tactics data through the Model Context Protocol, allowing any MCP-compatible AI assistant to:

• Query player information in real-time
• Analyze match statistics and composition choices
• Provide personalized coaching advice on augments, traits and items
• Track progress and identify trends over time
• Compare performance with friends or rivals

Privacy & Security

• Your Riot API key is only used to authenticate requests to Riot's API
• No player data is stored permanently
• All requests are made directly to Riot Games' official API
• This Actor complies with Riot Games API Terms of Service

Troubleshooting

"API Key Invalid" Error

• Check that your API key hasn't expired (development keys last 24h)
• Regenerate your key at developer.riotgames.com

"Player Not Found" Error

• Verify the Riot ID format: gameName#tagLine (e.g., Dishsoap#NA1)
• Check you're using the correct region
• The player may have changed their name recently

Claude Desktop Not Connecting

• Ensure you're using the full URL with /mcp path: https://scrapmania--teamfight-tactics-mcp-server---ai-game-analysis.apify.actor/mcp?token=YOUR_TOKEN
• Verify your Apify token is valid at console.apify.com
• Restart Claude Desktop after configuration changes
• The server may need a few seconds to start on first connection (cold start)

Resources

• GitHub Repository
• Riot Developer Portal
• Riot API Documentation
• Claude Desktop MCP Setup
• Apify MCP Documentation

License

This Actor is provided as-is for educational and personal use. Usage must comply with Riot Games API Terms and Conditions.

---

Built for the Teamfight Tactics community