About tft-oracle
tft-oracle is an MCP server that provides Teamfight Tactics champion, trait, item, augment, and shop-odds data sourced from CommunityDragon. It is for assistants and players seeking structured game information, and refreshes and caches data locally as new patch data becomes available.
Key features
- 01Search champions and retrieve full profiles
- 02Look up traits and their breakpoints
- 03Search items and inspect recipe trees
- 04Search augments by name or effect
- 05Retrieve shop odds by player level
- 06Refresh game data from CommunityDragon
Use cases
- 01Check a champion's stats and abilities
- 02Review trait breakpoints and members
- 03Find an item recipe or component link
- 04Check champion shop odds by level
MCP support
Exposes eight tools to MCP clients for querying champions, traits, items, augments, and shop odds. Game data is fetched from CommunityDragon on startup and cached locally.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMEtft-oracle
Teamfight Tactics MCP server — accurate champion, trait, item, and augment data for LLMs.
Stop LLMs from hallucinating TFT data. tft-oracle gives AI assistants accurate, up-to-date game knowledge sourced from CommunityDragon.
Features
- 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
Tools
| Tool | Description |
|---|---|
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 |
Install
Claude Desktop
Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"tft-oracle": {
"command": "npx",
"args": ["-y", "tft-oracle"]
}
}
}
CLI
npx tft-oracle
Data Source
Game data is sourced from CommunityDragon, which extracts structured data from Riot Games' TFT client files. Data is fetched on first run and cached locally at ~/.tft-oracle/. It auto-updates when CommunityDragon publishes new patch data.
No Riot Games API key is required.
Legal
tft-oracle isn't endorsed by Riot Games and doesn't reflect the views or opinions of Riot Games or anyone officially involved in producing or managing Riot Games properties. Riot Games, Teamfight Tactics, and all associated properties are trademarks or registered trademarks of Riot Games, Inc.
Game data provided by CommunityDragon, created under Riot Games' "Legal Jibber Jabber" policy.
License
MIT
Comments
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.