Mtg Oracle

What gregario/mtg-oracle MCP server does

The gregario/mtg-oracle MCP server exposes 14 Magic: The Gathering tools over the Model Context Protocol. It covers card discovery, card details, official rulings, format legality, rules references, deck analysis, market prices, Commander planning, known combos, card synergies, and format staples.

Card searches can use fields such as name, type, color, mana cost, rarity, set, format, and keyword, with full-text matching across names, type lines, and oracle text. Individual card lookups return details including oracle text, mana cost, types, power and toughness, rulings, and legality. Legality checks accept up to 50 cards and support formats including Commander, Modern, Standard, Legacy, and Vintage.

How it works

On its first run, the server retrieves card information from Scryfall and rules information from Academy Ruins. It stores downloaded data under ~/.mtg-oracle/ and updates that local data on later runs. The local SQLite approach supports queries without repeatedly requesting card data during normal use, although the initial data download requires network access.

Rules tools can retrieve Comprehensive Rules sections by number or text search, provide surrounding context and subsections, define glossary terms, and explain keyword abilities. The server also exposes official card rulings for interaction questions. Price lookups return USD, foil USD, EUR, and MTGO ticket values from Scryfall.

Setup and configuration

The package requires Node.js 18 or newer. Run it directly with:

npx -y mtg-oracle

It can also be installed globally with npm and started using the mtg-oracle command. For Claude Desktop, add a server entry whose command is npx and whose arguments are -y and mtg-oracle. The README also documents adding the same command through Claude Code.

No environment variables or credential configuration are documented. The first launch creates the local data directory and obtains the source datasets automatically.

Tools and capabilities

The gregario/mtg-oracle MCP server supports plain-text and MTGO XML deck input. Deck analysis reports mana curve, color distribution, card-type breakdown, mana-base information, and a format legality check.

Commander tools can evaluate a legendary creature, suggest strategy and archetype directions, identify useful card categories, find known infinite combos from Commander Spellbook, and return synergy categories with example cards. Combo searches can use card names or color identity and include steps, prerequisites, and results. Format-staple lookups can return common cards and archetypes, optionally narrowed to an archetype.

Limitations and notes

Card and price information comes from Scryfall, combo information comes from Commander Spellbook, and rules information comes from Academy Ruins. The project is unofficial fan content and is not endorsed by Wizards of the Coast or Scryfall. Price results are source data lookups rather than a stated guarantee of live market accuracy. The npm package does not bundle card data, so its first run needs to download the required datasets.