Tft Mcp Server

What is Tft Mcp Server about?

Tft Mcp Server enables retrieval of a player's TFT match history and detailed data for individual matches through MCP tools, allowing developers and end‑users to incorporate live game data into their workflows.

How to use Tft Mcp Server?

1. Install Node.js (v14+).
2. Add the MCP server configuration to the Claude Desktop claude_desktop_config.json file (MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json; Windows: %APPDATA%/Claude/claude_desktop_config.json).
3. Use the following JSON snippet in the config file:

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

4. Start Claude Desktop; the server runs on stdio and exposes two tools:
   • tft_match_history – retrieve a list of recent matches (count, start optional).
   • tft_match_details – fetch detailed data for a specific match (matchId required).
5. Call the tools from Claude or any MCP‑compatible client.

Key features of Tft Mcp Server

• Fetch recent TFT match history for the configured summoner.
• Retrieve comprehensive match details, including player placement, units, and statistics.
• Configurable pagination and result limits.
• Simple command‑line execution via npx without global installation.
• TypeScript codebase, easy to extend or customize.

Use cases of Tft Mcp Server

• Building analytics dashboards for personal or community TFT performance tracking.
• Integrating live match data into AI assistants (e.g., Claude) for strategy suggestions.
• Automating match‑based content generation, such as summaries or highlights.
• Developing third‑party tools or bots that need up‑to‑date TFT match information.

FAQ from the Tft Mcp Server

Q: Do I need a Riot API key? A: Yes. Obtain a temporary key for testing or apply for a permanent personal key via Riot's Developer Portal.

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

Q: Can I run the server locally without Claude? A: Yes. Execute the configured npx command directly in a terminal with the required arguments.

Q: How do I change the number of matches returned? A: Use the count parameter in the tft_match_history tool; defaults to 20.

Q: Is the project open source? A: Yes, licensed under the MIT license.

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