gregario avatar

Mtg Oracle

gregario/mtg-oracle

Connects Claude to Magic: The Gathering card data, comprehensive rules, and combo databases through 14 tools that query local SQLite storage. Ships with Scryfall card data, official Wizards rules text, and Commander Spellbook combos for offline search. You get full text card queries, mana curve analysis from deck lists, rules lookup by section number, legality checks across formats, and combo searches by color identity. The real value is the curated knowledge layer: it includes format staples, commander archetypes, and synergy categories that help LLMs reason about deck construction and card interactions instead of just returning raw oracle text. Reach for this when you need Claude to answer Magic rules questions, suggest commanders, or analyze deck composition.

GitHub stars
3
tools
14
transport
STDIO
last updated
Mar 15, 2026

Tools

14 tools

Public tool metadata for what this MCP can expose to an agent.

search_cardsSearch cards by name, type, color, mana cost, rarity, set, format, or keyword. Full-text search across names, type lines, and oracle text.

Search cards by name, type, color, mana cost, rarity, set, format, or keyword. Full-text search across names, type lines, and oracle text.

No parameter schema in public metadata yet.

get_cardGet complete details for a specific card: oracle text, mana cost, type, P/T, rulings, and legality. Fuzzy name matching.

Get complete details for a specific card: oracle text, mana cost, type, P/T, rulings, and legality. Fuzzy name matching.

No parameter schema in public metadata yet.

get_rulingsGet official Wizards of the Coast rulings for a card (interactions, edge cases, clarifications).

Get official Wizards of the Coast rulings for a card (interactions, edge cases, clarifications).

No parameter schema in public metadata yet.

check_legalityCheck format legality for one or more cards (up to 50). Covers Commander, Modern, Standard, Legacy, Vintage, and more.

Check format legality for one or more cards (up to 50). Covers Commander, Modern, Standard, Legacy, Vintage, and more.

No parameter schema in public metadata yet.

search_by_mechanicFind cards with a specific keyword or mechanic (Flying, Trample, Cascade, etc.). Optionally includes the keyword's rules definition.

Find cards with a specific keyword or mechanic (Flying, Trample, Cascade, etc.). Optionally includes the keyword's rules definition.

No parameter schema in public metadata yet.

get_pricesLook up current market prices for one or more cards (up to 50). Returns USD, USD Foil, EUR, and MTGO tix prices from Scryfall.

Look up current market prices for one or more cards (up to 50). Returns USD, USD Foil, EUR, and MTGO tix prices from Scryfall.

No parameter schema in public metadata yet.

analyze_deckAnalyze a deck list (plain text or MTGO XML). Returns mana curve, color distribution, type breakdown, mana base analysis, and format legality check.

Analyze a deck list (plain text or MTGO XML). Returns mana curve, color distribution, type breakdown, mana base analysis, and format legality check.

No parameter schema in public metadata yet.

lookup_ruleLook up Comprehensive Rules by section number (e.g., "702.1") or search by text. Returns rule text with subsections and parent context.

Look up Comprehensive Rules by section number (e.g., "702.1") or search by text. Returns rule text with subsections and parent context.

No parameter schema in public metadata yet.

get_glossaryLook up game terminology in the official glossary ("permanent", "spell", "stack", "priority", etc.).

Look up game terminology in the official glossary ("permanent", "spell", "stack", "priority", etc.).

No parameter schema in public metadata yet.

get_keywordGet the official rules definition for keyword abilities (Flying, Deathtouch, Equip, etc.).

Get the official rules definition for keyword abilities (Flying, Deathtouch, Equip, etc.).

No parameter schema in public metadata yet.

analyze_commanderAnalyze a legendary creature as a Commander: strategies, archetypes, recommended card categories for deckbuilding.

Analyze a legendary creature as a Commander: strategies, archetypes, recommended card categories for deckbuilding.

No parameter schema in public metadata yet.

find_combosFind known infinite combos from Commander Spellbook. Search by card name(s) or color identity. Returns steps, prerequisites, and results.

Find known infinite combos from Commander Spellbook. Search by card name(s) or color identity. Returns steps, prerequisites, and results.

No parameter schema in public metadata yet.

find_synergiesFind synergy categories (tokens, sacrifice, counters, etc.) and sample cards that work well with a specific card.

Find synergy categories (tokens, sacrifice, counters, etc.) and sample cards that work well with a specific card.

No parameter schema in public metadata yet.

get_format_staplesGet staple cards and popular archetypes for any format. Optionally filter by archetype.

Get staple cards and popular archetypes for any format. Optionally filter by archetype.

No parameter schema in public metadata yet.

Sponsors

Readme

mtg-oracle

npm version npm downloads License: MIT Node.js MCP gregario/mtg-oracle MCP server

Magic: The Gathering MCP server. Card search, rules lookup, deck analysis, and Commander intelligence.

Provides 14 tools for AI assistants to answer questions about Magic cards, game rules, combos, synergies, and format meta via the Model Context Protocol.


View the full README on GitHub

Details

Repository
github.com/gregario/mtg-oracle
Package
mtg-oracle
Transport
STDIO
Registry
MCP registry, active

More from gregario