Access TFT Match Data

Provides an MCP server for Team Fight Tactics (TFT) that exposes TFT match data through two tools: retrieving a summoner's match history, and retrieving detailed information about a specific TFT match.

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

The tft_match_history tool returns TFT match history for the current player, with optional count (number of matches to retrieve, defaults to 20) and start (pagination start index, defaults to 0) parameters. The tft_match_details tool returns detailed information about one match, given a required matchId parameter. The server runs on stdio and is built in TypeScript on the Model Context Protocol SDK.

Use it when an AI agent needs to pull a player's TFT match history or inspect the details of a specific TFT match via the Riot Games API. It only covers these two read operations - it is not a general Riot Games API client or a live-game/spectator tool.

Configuration requires a Riot Games API key (a temporary key expires in 24 hours during development; production use needs a permanent personal key from Riot's Application Portal), plus the player's Riot Game Name and Tag Line (e.g. NA1, shown after the Game Name in the Riot client). Tool inputs are match-history pagination parameters or a match ID; outputs are match history lists or per-match detail objects.

Two tools: tft_match_history (paginated match history retrieval) and tft_match_details (full detail for a single match by ID). Both require a valid Riot Games API key and Riot ID (Game Name + Tag Line) supplied at server startup.

Requires Node.js v14+ and npm or yarn. Configure it in the Claude Desktop config file (~/Library/Application Support/Claude/claude_desktop_config.json on macOS, %APPDATA%/Claude/claude_desktop_config.json on Windows) with the npx mcp-server-tft command and the API key, game name, and tag line as arguments, as shown above. For development, modify code in the src directory, run npm run build to compile, and npm start with the required parameters to test changes. The project is MIT licensed.

Players and developers who want an AI agent to pull their TFT match history or inspect specific TFT match details directly from the Riot Games API, without building a Riot API client themselves.