About io.github.gregario/tft-oracle
io.github.gregario/tft-oracle is an MCP server in the RAG category: tFT champion, trait, item, and augment data for LLMs via CommunityDragon.
Install
claude mcp add io-github-gregario-tft-oracle -- npx -y tft-oraclenpx -y tft-oracleThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (8)
get_championFull champion profile with stats, traits, and ability
Parameters not published.
get_item_recipeItem recipe tree and reverse lookups
Parameters not published.
get_rolling_oddsChampion shop odds by player level
Parameters not published.
get_traitTrait detail with breakpoints and champion list
Parameters not published.
search_augmentsSearch augments by name or effect
Parameters not published.
search_championsSearch champions by name, cost, trait, or role
Parameters not published.
search_itemsSearch items by name or component
Parameters not published.
search_traitsSearch and list traits
Parameters not published.
Ask AI
Ask AI about io.github.gregario/tft-oracle
Powered by Claude · Grounded in docs
Security checks
- ✓README presentThe repository ships documentation.
5 checks have not been run yet.
README
tft-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
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.