tft.com
tft.com logo

TFT

Integration for Team Fight Tactics (TFT) that provides access to TFT game data through various tools.

Created byApr 23, 2025

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](https://developer.riotgames.com/) - 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](https://developer.riotgames.com/app-type)
  • 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:
  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
  1. Run `npm run build` to compile
  1. Run `npm start` with the required parameters to test changes

License

MIT