TFT MCP server

This MCP server allows you to access Team Fight Tactics (TFT) game data through Claude Desktop. It provides tools to retrieve match history and detailed match information for TFT players using the Riot Games API.

Prerequisites

• Node.js (v14 or higher)
• npm or yarn
• Riot Games API Key - Get it from Riot Games Developer Portal
  • For development: use a temporary API key (24-hour expiration)
  • For production: apply for a permanent personal API key at Riot's Application Portal
• Your Game Name from your Riot game console
• Your Name Tagline from your Riot game console (e.g., NA1)

Installation and Configuration

Configure the MCP server in your Claude Desktop config file:

MacOS Configuration

Configuration file location:

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

Windows Configuration

Configuration file location:

%APPDATA%/Claude/claude_desktop_config.json

Add the following configuration to your config file:

{
  "mcpServers": {
    "tft-mcp": {
      "command": "npx",
      "args": [
        "mcp-server-tft",
        "--apiKey",
        "<YOUR_RIOT_API_KEY>",
        "--gameName",
        "<YOUR_GAME_NAME>",
        "--tagLine",
        "<YOUR_TAG_LINE>"
      ]
    }
  }
}

Make sure to replace the placeholder values:

• <YOUR_RIOT_API_KEY> with your actual Riot API key
• <YOUR_GAME_NAME> with your Riot Game Name
• <YOUR_TAG_LINE> with your Name Tagline

Available Tools

TFT Match History Tool

Retrieves TFT match history for the current player.

Parameters:

• count (optional): Number of matches to retrieve (default: 20)
• start (optional): Start index for pagination (default: 0)

TFT Match Details Tool

Gets detailed information about a specific TFT match.

Parameters:

• matchId (required): The match ID to get details for

Once configured properly, these tools will be available for use in your Claude Desktop interface, allowing you to retrieve and analyze your TFT gameplay data.

How to add this MCP server to Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > MCP and click "Add new global MCP server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

{
    "mcpServers": {
        "cursor-rules-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "cursor-rules-mcp"
            ]
        }
    }
}

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explictly ask the agent to use the tool by mentioning the tool name and describing what the function does.