This is a Model Context Protocol (MCP) server for Team Fight Tactics (TFT) that provides access to TFT game data through various tools.
- Get match history for a summoner
- Get detailed information about specific TFT matches
- 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
- Configure the MCP server in your Claude Desktop config file:
Location: ~/Library/Application Support/Claude/claude_desktop_config.json
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:
Get TFT match history for the current player.
Parameters:
count
(optional): Number of matches to retrieve. Defaults to 20start
(optional): Start index for pagination. Defaults to 0
Get detailed information about a specific TFT match.
Parameters:
matchId
(required): The match ID to get details for
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
MIT