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

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>"
      ]
    }
  }
}

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:

Make changes in the src directory
Run npm run build to compile
Run npm start with the required parameters to test changes

License

MIT

Features

Rate this server

Features

Rate this server