mcpField
T
TFT MCP Server

TFT MCP Server

Local
github.com/GeLi2001Games & Entertainment9Updated 82w ago
Repository

About TFT MCP Server

TFT MCP Server provides Teamfight Tactics game data to MCP clients. It offers tools for retrieving a summoner’s match history and details for a specified match, using a Riot Games API key.

Key features

  1. 01Retrieve a summoner’s match history
  2. 02Get details for a specific match
  3. 03Paginate match history results

Use cases

  1. 01Reviewing recent TFT matches
  2. 02Looking up details by match ID

MCP support

The server runs over stdio and exposes tools for match history and match details to MCP clients. Accessing TFT data requires a Riot Games API key.

#tft#mcp#game-data

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "tft": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-tft"
      ]
    }
  }
}
Run commandnpx -y mcp-server-tft

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmmcp-server-tft

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

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
    • 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

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:

{
  "mcpServers": {
    "tft-mcp": {
      "command": "npx",
      "args": [
        "mcp-server-tft",
        "--apiKey",
        "<YOUR_RIOT_API_KEY>",
        "--gameName",
        "<YOUR_GAME_NAME>",
        "--tagLine",
        "<YOUR_TAG_LINE>"
      ]
    }
  }
}
  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
  2. Run npm run build to compile
  3. Run npm start with the required parameters to test changes

License

MIT

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.