io.github.ebrunet001/mcp-server-tft

Official

by MrBridgeHQ · TypeScript

Teamfight Tactics AI coaching: composition analysis, augment optimization & improvement tips

This MCP server provides Teamfight Tactics (TFT) data and AI-powered coaching for Claude Desktop, Claude Code, and other MCP-compatible AI assistants. Its goal is composition analysis, augment optimization, and improvement tips based on TFT gameplay information.

🛠️ Key Features

Teamfight Tactics AI coaching
Composition analysis
Augment optimization
Improvement tips
Built for MCP-compatible AI assistants

🚀 Use Cases

Analyze TFT compositions for recommendations
Optimize TFT augments during planning
Generate improvement tips for gameplay decisions
Support Claude Desktop / Claude Code with TFT coaching

⚡ Developer Benefits

Uses the Model Context Protocol (MCP)
Integrates with MCP-compatible AI assistants
Includes references to Apify actor content for TFT analysis

⚠️ Limitations

Documentation excerpt does not list specific MCP tools, tool count, or method details.

Topics

apifymcpmcp-servermodel-context-protocolai-coachingclaude-desktopgamingriot-gamesteamfight-tactics

README.md3 KBView on GitHub

Teamfight Tactics MCP Server - AI Game Analysis

TFT data & AI-powered coaching for Claude Desktop, Claude Code & MCP-compatible AI assistants.

What does it do?

Teamfight Tactics MCP Server connects AI assistants to TFT data via the Riot Games API. 10 tools for player profiles, ranked stats, match history, composition analysis, augment optimization, live game detection - plus AI-powered performance coaching.

TFT is a game of decision-making under pressure. This server lets AI do the heavy lifting: it reads your match history, analyzes your comps, and gives you actionable coaching advice tailored to your rank and playstyle.

Available Tools

Tool	Description
`tft_get_account`	Get account info by Riot ID
`tft_get_ranked`	Get ranked stats (tier, rank, LP, wins/losses)
`tft_get_player_profile`	Get complete player profile in one call
`tft_get_match_history`	Get recent match history
`tft_get_match_details`	Get detailed match info (comps, augments, items)
`tft_get_live_game`	Check if a player is currently in a TFT match
`tft_analyze_performance`	Analyze recent performance with recommendations
`tft_analyze_composition`	Analyze trait synergies, unit choices & item builds
`tft_get_improvement_tips`	Get personalized improvement tips
`tft_compare_players`	Compare TFT stats between two players

Key Features

Composition Analysis: AI examines trait synergies, unit choices, item builds, augment selections
Augment Optimization: Track which augments you win with and which cost you LP
Data Dragon Integration: Unit, trait, item, and augment names automatically resolved
Intelligent Caching: Smart TTL-based caching to reduce API calls
16 Regions: EUW, NA, KR, BR, LA, OC, TR, RU, JP, PH, SG, TH, TW, VN, and more

Quick Start

Get your Apify API Token
Add a custom MCP connector:

code

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

Ask Claude: "Analyze my last 10 TFT games, I'm YourName#EUW"

Pricing

Pay-per-event on Apify. $5 free credits/month included.

License

MIT

Install

Remote endpoint

SSE

Hosted server - connect over the network, no local install.

url

https://mrbridge--teamfight-tactics-mcp-server---ai-game-analysis.apify.actor/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "mcp-server-tft": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mrbridge--teamfight-tactics-mcp-server---ai-game-analysis.apify.actor/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.