Tft MCP Server

TFT champion, trait, item, and augment data for LLMs via CommunityDragon

Local serverstdio

What is the Tft MCP server?

TFT champion, trait, item, and augment data for LLMs via CommunityDragon. Exposed over MCP by the tft mcp server, that capability becomes something an assistant can invoke while it works, not something you go and do afterwards.

What it actually does

Teamfight Tactics MCP server — accurate champion, trait, item, and augment data for LLMs.

  • Champions — — Full stats, traits, abilities, and costs for all champions in the current set
  • Traits — — Breakpoint thresholds, scaling values, and champion membership
  • Items — — Complete recipe tree, stat effects, and component relationships
  • Augments — — Descriptions and effects
  • Rolling Odds — — Shop probability tables by player level
  • Auto-updates — — Data refreshes from CommunityDragon on each server start

Its toolset

Everything the assistant can do here goes through one of these:

  • search_champions — Search champions by name, cost, trait, or role
  • get_champion — Full champion profile with stats, traits, and ability
  • search_traits — Search and list traits
  • get_trait — Trait detail with breakpoints and champion list
  • search_items — Search items by name or component
  • get_item_recipe — Item recipe tree and reverse lookups
  • search_augments — Search augments by name or effect
  • get_rolling_odds — Champion shop odds by player level

Adding it to your client

tft-oracle on npm is all you need. Most clients run it directly, so configuration is a few lines and a restart.

When to reach for it

Plenty of developer tooling servers cover similar ground. The differences that matter in practice are scope of access and how much setup stands between you and a working tool call. Tft's toolset — search_champions, get_champion, search_traits and 5 more — is a fair guide to whether it matches your workflow. It is maintained by gregario; worth a glance at recent repository activity before you build anything load-bearing on it.

SyncDev reviews every entry in this directory against the project's own documentation before publishing, and revisits them as servers change.

Caveats

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the tft mcp server does with a few real requests.

Available tools

ToolWhat it does
search_championsSearch champions by name, cost, trait, or role
get_championFull champion profile with stats, traits, and ability
search_traitsSearch and list traits
get_traitTrait detail with breakpoints and champion list
search_itemsSearch items by name or component
get_item_recipeItem recipe tree and reverse lookups
search_augmentsSearch augments by name or effect
get_rolling_oddsChampion shop odds by player level

How to install the Tft MCP server

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

Configuration as documented by the project. Restart the client after saving.

Example prompts to try

  • Use Tft to search champions.
  • Use Tft to get champion.
  • Use Tft to search traits.

Frequently asked questions

It connects Tft to MCP-compatible AI assistants such as Claude and Cursor, exposing 8 tools (search_champions, get_champion, search_traits, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Tft directly.