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.

Rated 5.0/5 on Apify Store — trusted by TFT players for AI-powered coaching.

No API key, no configuration, works with any AI assistant. Connect and start analyzing your TFT gameplay.

Why use TFT MCP Server?

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.

What can TFT MCP Server do?

• 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 — Connect in 2 minutes

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://mrbridge--teamfight-tactics-mcp-server---ai-game-analysis.apify.actor/mcp?token=YOUR_APIFY_TOKEN

Replace YOUR_APIFY_TOKEN with your Apify API token.

4. Grant permanent permissions (recommended)

By default, Claude Desktop asks for approval every time an MCP tool is called. To allow all TFT tools permanently:

In Claude Code, run /permissions and add mcp__TFT__* to the Allow list.

In Claude Desktop, click "Always allow" when prompted for the first tool call.

The prefix mcp__TFT__ matches the MCP server name. If you used a different name (e.g., tft), adjust the pattern accordingly (mcp__tft__*).

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

What tools are available?

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?"

What does the output look like?

Here's a sample response from the tft_get_player_profile tool:

Player Profile: Dishsoap#NA1

Region: NA1
Level: 247

Ranked TFT:
  Tier: Challenger | LP: 1,247
  Wins: 89 | Losses: 62 | Win Rate: 58.9%
  Top 4 Rate: 78.1%

Recent Match (3 hours ago):
  Placement: 1st | Game Length: 32m
  Composition: 4 Arcana / 2 Chrono / 2 Scholar
  Units: Ahri★★★, Xerath★★, Twisted Fate★★★, Zoe★★, Lux★★, Bard★★, Zilean★★, Ryze★★
  Augments: Arcana Heart, Jeweled Lotus, Axiom Arc

And from tft_analyze_performance:

Performance Analysis: Dishsoap#NA1 (last 20 games)

Average Placement: 3.2
Top 4 Rate: 80%
Win Rate: 30%

Best Compositions:
  1. Arcana — Avg: 2.1 (7 games)
  2. Witchcraft — Avg: 3.4 (5 games)
  3. Chrono — Avg: 3.8 (4 games)

Best Augments:
  1. Jeweled Lotus — Avg: 1.8 (4 games)
  2. Arcana Heart — Avg: 2.3 (6 games)

Recommendation: You perform best with Arcana comps. Consider flexing into
Witchcraft as a backup when Arcana is contested.

Which regions are supported?

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

Do I need a Riot API key?

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

How do I configure the server?

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)

What data format does it return?

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

How much does it cost?

Tier	Cost	What you get
Per call	$0.003-$0.025	Simple reads cost less, AI analysis costs more
Free tier	$5 free credits/month	~200-1,600 tool calls for free every month
Starter plan	$49/month	~2,000-16,000 tool calls/month

This MCP server uses Apify's pay-per-event pricing. You only pay when your AI assistant uses a tool — no idle costs. Start with $5 free credits.

Estimates based on event pricing only. Actual costs may include minimal platform compute fees. The free $5 credit covers both.

Operation	Price	Examples
Read	$0.005	get_account, get_ranked
Action	$0.01	get_match_history, get_match_details, get_live_game
AI	$0.025	analyze_performance, analyze_composition, compare_players

Example costs:

• Quick rank check (1 read): ~$0.005
• Match history review (1 read + 3 actions): ~$0.035
• Full performance analysis with AI (2 reads + 2 actions + 2 AI): ~$0.08
• Detailed coaching session (4 reads + 5 actions + 3 AI): ~$0.15

Is my data safe?

• 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://mrbridge--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)

Other MCP servers by mrbridge

Server	Category	Tools	Best for
ESPN MCP Server	Sports	12 tools	Live scores, standings & stats for 25+ leagues
LoL MCP Server	Gaming	25 tools	League of Legends AI coaching & live data
Latest News MCP	News	14 tools	Real-time news from 27 free APIs
Todoist AI Assistant	Productivity	16 actions	Smart task management & AI prioritization

All servers use pay-per-event pricing. $5 free credits/month included.

Changelog

• v1.0 (2026-03-20) — SEO-optimized headings, anti-friction messaging, cross-sell table, input schema sections

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