Tft Oracle

io.github.gregarioPublished by GitHub account gregariov0.1.0Updated Oct 24, 2026

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

VerifiedSTDIODesktop onlyKnowledge & Memory Data & Analytics

Server details

Identifier: io.github.gregario/tft-oracle
Transport: STDIO
Runtime: Desktop only
Trust: Verified
Published: Sep 16, 2026

Security note

MCP servers receive tool arguments from a conversation and may perform external actions. Review what a server can do before you enable it, and give it only the access it needs.

The registry verified the GitHub account gregario for this listing. That does not show the account is the product's maker.

SourceWeft's checks cover whether the listing is complete and the endpoint answered; they do not review the server's code or what its tools do.

Add a badge to your README

Show readers this MCP server is listed on SourceWeft. The badge links to this page.

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.github.gregario%2Ftft-oracle.svg)](https://sourceweft.com/mcp/io.github.gregario%2Ftft-oracle?utm_source=readme&utm_medium=badge)

Overview

AI-generated overview

Local MCP server giving assistants accurate Teamfight Tactics champion, trait, item, augment and shop-odds data sourced from CommunityDragon.

What you can do: Search champions by name, cost, trait or role, and read full profiles with stats, traits and abilities
Search traits and read breakpoint thresholds, scaling values and champion membership
Search items and resolve recipe trees, stat effects and reverse component lookups
Search augments by name or effect
Look up champion shop odds by player level
When to use it: Useful when an assistant answers Teamfight Tactics questions and should cite current-set data instead of guessing champion stats, trait breakpoints, item recipes or augment effects.
Requirements: Runs as a local process, typically launched with npx from the npm package tft-oracle; Node.js is needed. No Riot Games API key, environment variables or headers are required. Network access is needed to fetch data from CommunityDragon on first run and on updates; data is cached locally under the user's home directory.

Before you install

Data is fetched from the third-party CommunityDragon source and cached locally, so it reflects that source rather than official Riot documentation. The server is not endorsed by Riot Games. It is read-only lookup data with no declared credentials or write actions.

Installation

In SourceWeft

Open Tft Oracle in the dashboard and add it to a workspace.
Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

tft-oracle

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

[npm version] [npm downloads] [Node.js 18+] [MCP Compatible] [MIT License] [Sponsor] [tft-oracle MCP server]

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):

json

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

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

CLI

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

Source: README.md at commit 741a285

Tools

SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

v0.1.0LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

Reached in the last 30 days25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
DescriptionRequired15 pts
Logo10 pts
Documentation15 pts
License10 pts