Pricing

Rating

Developer

Actor stats

Categories

Share

Teamfight Tactics MCP Server

Connect AI assistants to Teamfight Tactics (TFT) data via Model Context Protocol. Let AI analyze your placements, find what's costing you LP & suggest comp, econ and positioning fixes. Access player profiles, match history, ranked stats, leaderboards & live games.

No Riot API key needed, no setup, no coding. Just connect your AI assistant and start analyzing.

What is TFT MCP Server?

TFT MCP Server runs in Apify's Standby mode as a persistent server that conversational AI assistants — Claude Desktop, ChatGPT, and any MCP-compatible client — call to read and analyze any player's Teamfight Tactics data. Ask in plain language; the AI pulls your real numbers and coaches you on them.

• 🩺 Placement diagnosis that names the leak — avg placement, top-4 vs top-1 conversion, and the exact units, traits and econ habits costing you LP, from your real ranked games.
• 🧩 Comps built for your playstyle — not a generic tier list; recommendations grounded in the boards that actually place for you.
• 📜 Full match breakdowns — every 8-player lobby with placements, starred units, items, augments and traits, name-resolved (no cryptic IDs).
• 🏆 Ladder & live intel — scout Challenger/GM/Master, any tier's ladder, the Hyper Roll rated ladder, and live lobbies to spot the biggest threat mid-game.
• ⚔️ Three queues, 16 regions — ranked TFT, Hyper Roll and Double Up stats side by side, EUW to KR.
• 🔑 Zero setup, built-in Riot key — no developer account, no 24-hour key to regenerate. Connect and ask.
• 🔌 Speaks MCP + OpenAPI 3.1.0 — built for Claude Desktop, ChatGPT, and any MCP-compatible AI assistant.
• ⚡ Standby mode — sub-second responses once warm; cold start adds ~5–20s only on the very first call.

Quick Start — Connect in 2 minutes

No Riot API key needed — this Actor includes a built-in API key. No key, no developer account, no 24-hour expiry. Just connect and play!

Your connection URL is the same for every client — replace YOUR_APIFY_TOKEN with your Apify API token:

https://mrbridge--tft-mcp-server.apify.actor/mcp?token=YOUR_APIFY_TOKEN

1. Connect your AI assistant

• Claude Desktop — Settings → Connectors → Add custom connector, paste the URL above, save.
• ChatGPT (Plus / Pro / Team / Enterprise) — Settings → Connectors, enable developer mode, Add custom connector, paste the URL, save.
• Apify Universal MCP — already using mcp.apify.com? Skip the separate config and just add this server as a tool: https://mcp.apify.com?tools=mrbridge/tft-mcp-server.

2. Start asking questions

That's it! Your assistant can now access Teamfight Tactics data. Try asking:

"Look up the TFT profile of Kataamak#6015 on EUW and tell me their current rank and average placement."

Real Example: AI coaching from your match history

Here is the kind of analysis Claude produces from a real player's ranked games (Gold III, EUW) — using only this MCP server's tools, with no manual data entry.

The diagnosis (from tft_analyze_performance over 20 games):

Your problem isn't survival, it's conversion. You hit top-4 in 60% of games (strong for Gold) but only 5% top-1, with a 4.30 average placement. Two mechanical signals: you plateau at level 8 (avg 8.6) instead of pushing 9, and your damage is low (avg 94) — defensive boards that stall instead of closing.

What works vs what holds you back (units & traits cross-referenced):

Per-game findings (from tft_get_match_history + tft_get_match_details):

Game 2 — finished 5th, dead at round 31 still level 7, with 52 gold unspent and a 1★ Corki carrying items. You had the gold to level and roll; it never hit the board.

From there Claude drew the actionable plan: stop defaulting to Brawler + Cho'Gath, commit all three items to one carry, cap defensive items at two, and push level 9 instead of dying on unspent gold — then it built three full comps (core units, items, level-by-level spike, positioning) tailored to that exact playstyle.

Every number above came from the player's real match history through this MCP server. Just ask Claude to analyze any Riot ID.

Try it yourself:

"Analyze my recent TFT games and recommend 3 comps that fit my playstyle. My Riot ID is YourName#TAG on EUW."

What tools are available?

Once connected, your AI assistant can use these 19 tools.

Player & matches

Analysis & coaching

Ladders & platform

tft_get_match_timeline and tft_get_champion_mastery are exposed for compatibility but report "not available for TFT" — Riot provides no timeline or champion-mastery endpoint for Teamfight Tactics. These calls are free.

Built by MrBridge

This MCP server is built by MrBridge — see the TFT MCP server details page or the MrBridge MCP server catalog. New to the protocol? Read what MCP is and why it matters. Learn more about what we do at mr-bridge.com.

What can AI do with your TFT data?

• Post-game coaching — "I just dropped 200 LP. Analyze my last 10 games — am I repeating the same mistakes?"
• Comp optimization — "Based on my last 50 games, which comps give me the best average placement?"
• Playstyle-fit comps — "Give me 3 comps that fit how I play, with items, level-by-level spikes and positioning."
• Live scouting — "I'm in a game right now. Look up my lobby and tell me who's the biggest threat."

What does the output look like?

A sample response from the tft_get_player_profile tool (analysis tools like tft_analyze_performance return the kind of diagnosis shown in Real Example above):

Player Profile: Kataamak#6015
Region:EUW
Level:312
Ranked TFT:
Tier: Platinum IV|LP:32
Wins(Top 4):142|Losses(Bottom 4):131| Top-4Rate:52%
Recent Form(last 10 games):
Placements:2,5,1,4,7,3,4,6,2,4
 Avg Placement:3.8| Top-4:7/10

Which regions are supported?

All 16 TFT regions: euw1 (Europe West), eun1 (EUNE), na1 (North America), kr (Korea), br1 (Brazil), la1 (LAN), la2 (LAS), oc1 (Oceania), tr1 (Turkey), ru (Russia), jp1 (Japan), ph2 (Philippines), sg2 (Singapore), th2 (Thailand), tw2 (Taiwan), vn2 (Vietnam).

How do I configure the server?

The server works with zero configuration. These optional settings let you tune defaults:

Is my data safe?

Player data is never stored — every request goes straight to Riot Games' official API using the built-in key, and the Actor complies with the Riot Games API Terms of Service.

Troubleshooting

• "Player Not Found" — check the Riot ID format gameName#tagLine (e.g. Kataamak#6015), the region, and that the player hasn't recently renamed.
• Claude Desktop won't connect — use the full /mcp URL https://mrbridge--tft-mcp-server.apify.actor/mcp?token=YOUR_TOKEN, verify your Apify token, and restart Claude Desktop. The first request after idle takes ~5–20s (cold start).

How much does it cost?

TFT MCP Server uses a pay-per-event pricing model: your AI assistant's tool calls are billed under three events — Data Retrieval, Match Data, and AI Analysis — and you're charged only on successful calls. See the Pricing tab for the live price table by Apify subscription tier.

A typical session — one profile check plus a 20-game placement analysis — costs about $0.04. There are no idle costs.

What is NOT charged: failed tool calls and error responses are never billed, and the two compatibility stubs (tft_get_match_timeline, tft_get_champion_mastery) are always free.

Cost cap: you can cap spending with Apify's maximum total charge limit (ACTOR_MAX_TOTAL_CHARGE_USD). Once the cap is reached, further tool calls are rejected instead of billing past your limit.

FAQ

Do I need a Riot API key?

No. This Actor includes a built-in, dedicated API key. You can start using it immediately — no Riot developer account, no key to paste, and no 24-hour expiry to manage.

Does this work with ChatGPT?

Yes. Any MCP-compatible AI client can connect to this server. It works with Claude Desktop, ChatGPT, and other AI agents that support the Model Context Protocol.

Can I analyze other players?

Yes. You can look up any player's public data by providing their Riot ID (gameName#tagLine). No special permissions are needed for public data.

Your feedback

We're always improving this Actor. If you've got technical feedback or found a bug, please open an issue on the Actor's Issues tab.

Apify Universal MCP & other clients

Already running the Apify Universal MCP? It proxies every registered Actor — include this server on your existing Universal MCP URL instead of managing a separate config entry:

https://mcp.apify.com?tools=mrbridge/tft-mcp-server

Any other MCP-compatible client speaks to the same Streamable HTTP endpoint (/mcp) with your Apify token in the Authorization: Bearer header or ?token= query. This server is built for conversational assistants — Claude Desktop and ChatGPT are where game coaching shines.

Integrate with Zapier, Make & n8n

TFT MCP Server runs on Apify, so it plugs into automation platforms via the Actor ID MlStLtYJbY5S4HItj: the Zapier, Make and n8n Apify integrations each expose a "Run Actor" step you can wire to Discord, Slack, Google Sheets, or 5,000+ other apps. Or call the run endpoint directly:

POSThttps://api.apify.com/v2/acts/mrbridge~tft-mcp-server/runs?token=YOUR_APIFY_TOKEN

Example: Daily at 9 AM → analyze a player's ranked placements → post a Discord summary.

Use via Apify API

Call this server programmatically without an MCP client (Python users: drive apify-client's ApifyClient the same way):

import{ ApifyClient }from'apify-client';
const client =newApifyClient({token:'YOUR_APIFY_TOKEN'});
const run =await client.actor('mrbridge/tft-mcp-server').call({defaultRegion:'euw1'});
const{ items }=await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

Note: For real-time AI conversations, use the MCP connection (see Quick Start). The Apify API is best for batch jobs and automation pipelines.

Other MCP servers by mrbridge

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

Resources

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

Legal & responsible use

This Actor retrieves publicly available game data through the official Riot Games API. You are responsible for ensuring your use complies with the Riot Games API Terms of Service and applicable data-protection regulation. TFT MCP Server is not endorsed by and is not affiliated with Riot Games; Teamfight Tactics is a trademark of Riot Games, Inc.

Built with ❤️ for the Teamfight Tactics community