Home / MCP / TFT MCP Server

TFT MCP Server

Provides access to TFT game data via MCP: match history and match details.

typescript
Installation
Add the following to your MCP client configuration file.

Configuration

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

You can access TFT game data through this MCP server, enabling you to fetch a summoner’s match history and obtain detailed information about specific TFT matches. It lets you build tools or dashboards that rely on up-to-date TFT data while keeping integration steps clear and repeatable.

How to use

Use this MCP server with any MCP client to query TFT game data. The server exposes two endpoints you can leverage: tft_match_history to retrieve a user’s past matches, and tft_match_details to fetch in-depth information about a chosen match. Supply the required context (such as your API key, game name, and tag line) when you start the server, then run requests from your client to obtain the data you need.

How to install

Prerequisites you need before installation:

- Node.js (v14 or higher)

- npm or yarn

- Riot Games API Key (for accessing TFT data) from Riot Games Developer Portal. For development you can use a temporary key that expires in 24 hours. For production, apply for a permanent personal API key at Riot’s Application Portal

- Your Game Name and Tag Line as shown in your Riot game console (for example, NA1)

Additional sections

Configuration and running a TFT MCP server is described here. The server runs via stdio and is configured to pass the necessary parameters at startup.

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

Available tools

tft_match_history

Fetch TFT match history for the current player. Supports optional count and start parameters for pagination to retrieve a subset of matches.

tft_match_details

Retrieve detailed information about a specific TFT match by its matchId.