Tft Oracle

What gregario/tft-oracle does

The gregario/tft-oracle MCP server exposes Teamfight Tactics reference data through eight MCP tools. It covers champion searches and profiles, trait searches and details, item searches and recipe relationships, augment searches, and champion shop odds by player level.

Champion results can be queried by name, cost, trait, or role, then expanded into profiles containing stats, traits, costs, and abilities. Trait lookups provide breakpoint information and the champions associated with each trait. Item tools support searches by item or component and can return both recipe trees and reverse component relationships. Augment searches accept names or effects, while rolling-odds queries return shop probabilities for a specified player level.

How it works

The gregario/tft-oracle MCP server uses structured game data sourced from CommunityDragon, which extracts information from Riot Games' Teamfight Tactics client files. On its first run, the server downloads the available data and stores a local cache under ~/.tft-oracle/. At startup, it checks for newer patch data and refreshes the local data when CommunityDragon has published an update.

This design makes the server useful for assistants that need game facts in tool responses rather than relying on model memory. It does not require a Riot Games API key. The available data follows the current set and the patch data provided by CommunityDragon.

Setup and configuration

The package is available through npm and requires Node.js 18 or newer. A direct CLI launch uses:

npx -y tft-oracle

For Claude Desktop, add an MCP server entry with npx as the command and -y tft-oracle as its arguments:

{
  "mcpServers": {
    "tft-oracle": {
      "command": "npx",
      "args": ["-y", "tft-oracle"]
    }
  }
}

No environment variables, credentials, or paid API subscription are documented as required. Cached data is kept in the user's home directory at ~/.tft-oracle/.

Tools and capabilities

• search_champions: Find champions by name, cost, trait, or role.
• get_champion: Retrieve a champion's stats, traits, cost, and ability.
• search_traits: Search or list available traits.
• get_trait: Inspect trait breakpoints and member champions.
• search_items: Search items by name or component.
• get_item_recipe: View item construction trees and reverse component lookups.
• search_augments: Find augments by name or effect.
• get_rolling_odds: Retrieve champion shop probabilities by player level.

Limitations and notes

The data depends on CommunityDragon's extracted client files and update schedule. The project describes its data as current-set information, so consumers should account for changes introduced by new TFT patches. It is not endorsed by Riot Games, and the game names and related properties remain Riot Games trademarks. The project is licensed under MIT.

Getting started with this gregario/tft-oracle MCP server

Always refer to the official documentation for the most accurate and up-to-date information.