Mtg MCP Server

Magic: The Gathering MCP server — cards, rules, combos, and Commander intelligence

Local serverstdio

What is the Mtg MCP server?

Magic: The Gathering MCP server — cards, rules, combos, and Commander intelligence. Exposed over MCP by the mtg mcp server, that capability becomes something an assistant can invoke while it works, not something you go and do afterwards.

What it actually does

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

Its toolset

Everything the assistant can do here goes through one of these:

  • search_cards — Search cards by name, type, color, mana cost, rarity, set, format, or keyword. Full-text search across names, type lines, and oracle text
  • get_card — Get complete details for a specific card: oracle text, mana cost, type, P/T, rulings, and legality. Fuzzy name matching
  • get_rulings — Get official Wizards of the Coast rulings for a card (interactions, edge cases, clarifications)
  • check_legality — Check format legality for one or more cards (up to 50). Covers Commander, Modern, Standard, Legacy, Vintage, and more
  • search_by_mechanic — Find cards with a specific keyword or mechanic (Flying, Trample, Cascade, etc.). Optionally includes the keyword's rules definition
  • get_prices — Look up current market prices for one or more cards (up to 50). Returns USD, USD Foil, EUR, and MTGO tix prices from Scryfall
  • analyze_deck — Analyze a deck list (plain text or MTGO XML). Returns mana curve, color distribution, type breakdown, mana base analysis, and format legality check
  • lookup_rule — Look up Comprehensive Rules by section number (e.g., "702.1") or search by text. Returns rule text with subsections and parent context
  • get_glossary — Look up game terminology in the official glossary ("permanent", "spell", "stack", "priority", etc.)
  • get_keyword — Get the official rules definition for keyword abilities (Flying, Deathtouch, Equip, etc.)
  • analyze_commander — Analyze a legendary creature as a Commander: strategies, archetypes, recommended card categories for deckbuilding
  • find_combos — Find known infinite combos from Commander Spellbook. Search by card name(s) or color identity. Returns steps, prerequisites, and results

Adding it to your client

The server ships on npm as mtg-oracle, so your MCP client can launch it on demand — there is no separate build step. Add the server block to your client's configuration, restart it, and the tools register themselves.

When to reach for it

This sits in the developer tooling group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. Mtg's toolset — search_cards, get_card, get_rulings and 11 more — is a fair guide to whether it matches your workflow. It is maintained by gregario; worth a glance at recent repository activity before you build anything load-bearing on it.

We check each listing at SyncDev against the project's documentation before it goes live — if something here drifts out of date, it is a bug worth reporting.

Caveats

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • With 14 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch Mtg.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the mtg mcp server does with a few real requests.

Available tools

ToolWhat it does
search_cardsSearch cards by name, type, color, mana cost, rarity, set, format, or keyword. Full-text search across names, type lines, and oracle text.
get_cardGet complete details for a specific card: oracle text, mana cost, type, P/T, rulings, and legality. Fuzzy name matching.
get_rulingsGet official Wizards of the Coast rulings for a card (interactions, edge cases, clarifications).
check_legalityCheck format legality for one or more cards (up to 50). Covers Commander, Modern, Standard, Legacy, Vintage, and more.
search_by_mechanicFind cards with a specific keyword or mechanic (Flying, Trample, Cascade, etc.). Optionally includes the keyword's rules definition.
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.
analyze_deckAnalyze a deck list (plain text or MTGO XML). Returns mana curve, color distribution, type breakdown, mana base analysis, and format legality check.
lookup_ruleLook up Comprehensive Rules by section number (e.g., "702.1") or search by text. Returns rule text with subsections and parent context.
get_glossaryLook up game terminology in the official glossary ("permanent", "spell", "stack", "priority", etc.).
get_keywordGet the official rules definition for keyword abilities (Flying, Deathtouch, Equip, etc.).
analyze_commanderAnalyze a legendary creature as a Commander: strategies, archetypes, recommended card categories for deckbuilding.
find_combosFind known infinite combos from Commander Spellbook. Search by card name(s) or color identity. Returns steps, prerequisites, and results.
find_synergiesFind synergy categories (tokens, sacrifice, counters, etc.) and sample cards that work well with a specific card.
get_format_staplesGet staple cards and popular archetypes for any format. Optionally filter by archetype.

How to install the Mtg MCP server

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

Configuration as documented by the project. Restart the client after saving.

Example prompts to try

  • Use Mtg to search cards.
  • Use Mtg to get card.
  • Use Mtg to get rulings.

Frequently asked questions

It connects Mtg to MCP-compatible AI assistants such as Claude and Cursor, exposing 14 tools (search_cards, get_card, get_rulings, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Mtg directly.