Tft Mcp Server

What is Tft Mcp Server about?

Tft Mcp Server offers a Model Context Protocol (MCP) interface that lets tools retrieve a player's TFT match history and detailed information about individual matches.

How to use Tft Mcp Server?

1. Install Node.js (v14+).
2. Add the MCP configuration to the Claude Desktop config file (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json, Windows: %APPDATA%/Claude/claude_desktop_config.json).
3. Include the following entry:

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

4. Run the server via the configured command; it operates over stdio.
5. Call the provided tools:
   • tft_match_history – optional count and start parameters.
   • tft_match_details – required matchId parameter.

Key Features of Tft Mcp Server

• Retrieve recent TFT match history for the authenticated summoner.
• Obtain full match details for a specific match ID.
• Configurable pagination for history queries.
• Fully written in TypeScript with a simple build (npm run build).
• MIT licensed, easy to extend.

Use Cases of Tft Mcp Server

• Integrate TFT statistics into AI assistants or chat bots.
• Build personal dashboards tracking win‑rate, champion usage, and progression.
• Enable third‑party analytics tools to consume live match data.
• Support game‑related productivity extensions in Claude Desktop or similar platforms.

FAQ from the Tft Mcp Server

Q: Do I need a Riot API key? A: Yes. Obtain a temporary key for development or apply for a permanent personal key on Riot's developer portal.

Q: Which Node.js versions are supported? A: Node.js v14 or higher.

Q: How do I update the server after changes? A: Run npm run build to compile TypeScript, then npm start with the required arguments.

Q: What is the default number of matches returned? A: 20 matches if count is omitted.

Q: Can I run the server on a remote machine? A: The server communicates via stdio, so it is intended to be launched locally by the client application.

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>"
      ]
    }
  }
}

2. 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