T

TFT-Match-Analyzer

community
ai

MCP server for teamfight tactics match history & match details fetching, providing user the detailed context for every match.

TFT MCP Server

This is a Model Context Protocol (MCP) server for Team Fight Tactics (TFT) that provides access to TFT game data through various tools.

Features

  • Get match history for a summoner
  • Get detailed information about specific TFT matches

Prerequisites

  • Node.js (v14 or higher)
  • npm or yarn
  • Riot Games API Key (for accessing TFT data) - Get it from Riot Games Developer Portal
    • Note: For development, you can use a temporary API key that expires in 24 hours
    • For production use, you'll need to apply for a permanent personal API key at Riot's Application Portal
  • Your Game Name, accessed from your Riot game console
  • Your Name Tagline, accessed from your Riot game console, which is usually followed/shown right after your Game Name. For example:
    NA1

Usage

  1. Configure the MCP server in your Claude Desktop config file:

MacOS

Location:
~/Library/Application Support/Claude/claude_desktop_config.json

Windows

Location:
%APPDATA%/Claude/claude_desktop_config.json
Add the following configuration:
{
  "mcpServers": {
    "tft-mcp": {
      "command": "npx",
      "args": [
        "mcp-server-tft",
        "--apiKey",
        "<YOUR_RIOT_API_KEY>",
        "--gameName",
        "<YOUR_GAME_NAME>",
        "--tagLine",
        "<YOUR_TAG_LINE>"
      ]
    }
  }
}
  1. The server will run on stdio and provide the following tools:

tft_match_history

Get TFT match history for the current player.
Parameters:
  • count
    (optional): Number of matches to retrieve. Defaults to 20
  • start
    (optional): Start index for pagination. Defaults to 0

tft_match_details

Get detailed information about a specific TFT match.
Parameters:
  • matchId
    (required): The match ID to get details for

Development

The project is written in TypeScript and uses the Model Context Protocol SDK. To modify the code:
  1. Make changes in the
    src
    directory
  2. Run
    npm run build
    to compile
  3. Run
    npm start
    with the required parameters to test changes

License

MIT

Related Servers

E

EverArt

reference

AI image generation using various models

View Details
G

Google Maps

reference

Location services, directions, and place details

View Details
AgentQL logo

AgentQL

official

Enable AI agents to get structured data from unstructured web with [AgentQL](https://www.agentql.com/).

View Details
BICScan logo

BICScan

official

Risk score / asset holdings of EVM blockchain address (EOA, CA, ENS) and even domain names.

View Details
Chronulus AI logo

Chronulus AI

official

Predict anything with Chronulus AI forecasting and prediction agents.

View Details