mtg-oracle
mtg-oracle is a Magic: The Gathering MCP server offering 14 tools for AI assistants (like Claude Desktop) to answer MTG questions using local SQLite databases sourced from Scryfall, Commander Spellbook, and official rules data.
Card Search & Information
Search cards by name, type, color, mana cost, rarity, set, format legality, or keyword
Get complete card details (oracle text, mana cost, type, power/toughness, rulings, legality) with fuzzy name matching
Fetch official Wizards of the Coast rulings covering interactions and edge cases
Check format legality for up to 50 cards across Commander, Modern, Standard, Legacy, Vintage, and more
Find cards with a specific keyword/mechanic (e.g., Flying, Cascade) with optional rules definitions
Look up current market prices (USD, USD Foil, EUR, MTGO tix) for up to 50 cards
Deck Analysis
Parse deck lists (plain text or MTGO XML) to get mana curve, color distribution, type breakdown, mana base analysis, and format legality
Rules Reference
Look up Comprehensive Rules by section number or text search
Find official glossary definitions for game terminology (e.g., "permanent", "stack", "priority")
Retrieve official rules definitions for keyword abilities like Flying, Deathtouch, or Equip
Commander & Format Intelligence
Analyze legendary creatures as Commanders with strategies, archetypes, and recommended card categories
Find known infinite combos from Commander Spellbook by card name(s) or color identity, including steps and prerequisites
Identify synergy categories (tokens, sacrifice, counters, etc.) and sample cards for a specific card
Retrieve staple cards and popular archetypes for any format, optionally filtered by archetype
All data is stored locally in SQLite for fast offline queries with automatic updates.
mtg-oracle
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.
Not just another Scryfall wrapper. mtg-oracle downloads card data, comprehensive rules, and combo databases locally into SQLite for fast offline queries, and ships with curated MTG knowledge (archetypes, format primers, commander strategies, mana base guidelines) that makes LLMs genuinely competent at Magic.
Installation
npm install -g mtg-oracleOr run directly with npx:
npx mtg-oracleRelated MCP server: scryfall-mcp-server
Claude Desktop Configuration
Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):
{
"mcpServers": {
"mtg-oracle": {
"command": "npx",
"args": ["-y", "mtg-oracle"]
}
}
}Or if installed globally:
{
"mcpServers": {
"mtg-oracle": {
"command": "mtg-oracle"
}
}
}Claude Code Configuration
claude mcp add mtg-oracle -- npx -y mtg-oracleData
On first run, mtg-oracle downloads card data from Scryfall and rules data from Academy Ruins. Data is stored in ~/.mtg-oracle/ and updated automatically on subsequent runs. No card data is bundled in the npm package.
Tools
Card Tools
Tool | Description |
| Search cards by name, type, color, mana cost, rarity, set, format, or keyword. Full-text search across names, type lines, and oracle text. |
| Get complete details for a specific card: oracle text, mana cost, type, P/T, rulings, and legality. Fuzzy name matching. |
| Get official Wizards of the Coast rulings for a card (interactions, edge cases, clarifications). |
| Check format legality for one or more cards (up to 50). Covers Commander, Modern, Standard, Legacy, Vintage, and more. |
| Find cards with a specific keyword or mechanic (Flying, Trample, Cascade, etc.). Optionally includes the keyword's rules definition. |
| Look up current market prices for one or more cards (up to 50). Returns USD, USD Foil, EUR, and MTGO tix prices from Scryfall. |
Deck Tools
Tool | Description |
| Analyze a deck list (plain text or MTGO XML). Returns mana curve, color distribution, type breakdown, mana base analysis, and format legality check. |
Rules Tools
Tool | Description |
| Look up Comprehensive Rules by section number (e.g., "702.1") or search by text. Returns rule text with subsections and parent context. |
| Look up game terminology in the official glossary ("permanent", "spell", "stack", "priority", etc.). |
| Get the official rules definition for keyword abilities (Flying, Deathtouch, Equip, etc.). |
Commander Tools
Tool | Description |
| Analyze a legendary creature as a Commander: strategies, archetypes, recommended card categories for deckbuilding. |
| Find known infinite combos from Commander Spellbook. Search by card name(s) or color identity. Returns steps, prerequisites, and results. |
| Find synergy categories (tokens, sacrifice, counters, etc.) and sample cards that work well with a specific card. |
| Get staple cards and popular archetypes for any format. Optionally filter by archetype. |
Development
# Install dependencies
npm install
# Run tests
npm test
# Build
npm run build
# Run locally
npm startAttribution
Card data provided by Scryfall. This project is not produced by or endorsed by Scryfall.
Combo data from Commander Spellbook.
Rules data from Academy Ruins.
Legal
This is unofficial Fan Content permitted under the Fan Content Policy. Not approved/endorsed by Wizards of the Coast. Portions of the materials used are property of Wizards of the Coast. All rights reserved.
License
MIT
Available Tools
14 toolsanalyze_commanderA
Analyze a legendary creature as a potential Commander. Returns color identity, suggested strategies, archetypes, and recommended card categories for building a deck around this commander. Use this when a user wants help building or evaluating a Commander deck.
Inputs: name (required).
analyze_deckA
Analyze a Magic: The Gathering deck list. Paste a deck list (plain text format like '4 Lightning Bolt' per line, or MTGO .dek XML) and get mana curve, color distribution, type breakdown, mana base analysis, and format legality check. Use this when a user shares a deck list and wants feedback.
Inputs: deck_list (required), format.
check_legalityA
Check which formats a card (or multiple cards) is legal in. Use this when a user wants to know if a card is legal, banned, or restricted in formats like Commander, Modern, Standard, Legacy, or Vintage. Accepts a single card name or an array of up to 50 card names.
Inputs: cards (required), format.
find_combosA
Find known infinite combos and synergistic card combinations from Commander Spellbook. Use this when a user asks about combos involving specific cards, combos in specific colors, or wants to find win conditions. Returns combo steps, prerequisites, and results.
Inputs: card_name, card_names, color_identity, limit.
find_synergiesA
Find synergy categories and sample cards that work well with a specific card. Use this when a user wants to know what strategies or card types synergize with a particular card. Identifies matching archetypes (tokens, sacrifice, counters, etc.) and suggests complementary cards.
Inputs: card_name (required), color_identity, format, category, +1 more.
get_cardA
Get complete details for a specific Magic card including oracle text, mana cost, type, power/toughness, rulings, and format legality. Use this when you know the exact card name (or close to it) and need full information. Supports fuzzy matching — partial names work.
Inputs: name (required).
get_format_staplesA
Get staple cards and popular archetypes for a specific format (Commander, Modern, Legacy, etc.). Use this when a user asks about the meta, popular decks, or key cards in a format. Optionally filter by archetype.
Inputs: format (required), archetype.
get_glossaryA
Look up a term in the Magic: The Gathering glossary. Use this when a user asks "what does X mean" for game-specific terminology like "permanent", "spell", "stack", "priority", etc. Supports partial matching.
Inputs: term (required).
get_keywordA
Get the official rules definition for a Magic keyword ability (e.g., "Flying", "Deathtouch", "Equip"). Use this when a user asks how a keyword works or what its rules text says. Different from get_glossary — this is specifically for keyword abilities with rules text.
Inputs: name (required).
get_pricesA
Look up current market prices for one or more Magic cards. Returns USD, USD Foil, EUR, and MTGO tix prices from Scryfall. Use this when a user asks about card prices, deck costs, or wants to compare card values.
Inputs: names (required).
get_rulingsA
Get official rulings for a specific Magic card. Use this when a user asks about specific interactions, edge cases, or how a card works in unusual situations. Returns timestamped rulings from Wizards of the Coast.
Inputs: card_name (required).
lookup_ruleA
Look up a specific section of the Magic: The Gathering Comprehensive Rules by section number (e.g., "702", "702.1") or search rules text. Use this when a user asks about specific game rules, rule interactions, or needs the official rule text. Returns the rule and its subsections.
Inputs: section, query.
search_by_mechanicA
Find cards that have a specific keyword or mechanic (e.g., "Flying", "Trample", "Scry", "Cascade"). Use this when a user asks about cards with a particular ability or mechanic. Optionally includes the keyword's official rules definition.
Inputs: keyword (required), include_definition, format, limit.
search_cardsA
Search for Magic: The Gathering cards by name, type, color, mana cost, rarity, set, format legality, or keyword. Use this when you need to find cards matching specific criteria. Supports full-text search across card names, type lines, and oracle text. Returns a summary list — use get_card for full details on a specific card.
Inputs: query, name, type, colors, +7 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 14 tools
Most tools have distinct targets, but search_by_mechanic overlaps with search_cards since the latter supports keyword-based search. get_keyword and get_glossary are explicitly differentiated, and lookups like rulings vs. card details are well separated.
All tool names follow a consistent verb_noun snake_case pattern (get_, search_, analyze_, find_, check_, lookup_). Even multi-word objects like get_format_staples are clear and predictable.
14 tools is well-scoped for a Magic: The Gathering oracle service. Each tool covers a meaningful aspect (card data, pricing, legality, rulings, deck/commander analysis, combos), and none feels superfluous.
The surface covers all major info needs: card lookup and search, prices, legality, rulings, comprehensive rules, glossary, deck analysis, commander analysis, combos, synergies, and format staples. There are no obvious dead ends for common MTG questions.
Maintenance
Related MCP Connectors
Official remote MCP server for Archivist AI TTRPG campaign memory: characters, sessions, and more.
The Commons by Dead Brands, LLC: free MCP hub, live games, and Rent-a-Bot. No signup.
Crypto market intelligence, token rug-checks, and wallet verification in one MCP server.
MCP server for Midjourney AI image generation and editing
Related MCP Servers
- AlicenseAqualityBmaintenanceMCP server for I Want My MTG that enables conversational search of Magic: The Gathering cards/sets and inventory management via API tools.61418 npm1MIT
- FlicenseNot gradedqualityDmaintenanceMCP server that searches and retrieves Magic: The Gathering card data from the Scryfall API.-
- AlicenseNot gradedqualityBmaintenanceUnified MCP server for Magic: The Gathering, combining Scryfall card search and pricing, EDHRec commander recommendations, Archidekt deck reading, and decklist validation into a single service.MIT
- AlicenseAqualityCmaintenanceMCP server for Magic: The Gathering card prices, deck analysis, sealed product EV calculations, and investment insights, powered by live data from 5 vendors covering 99K+ cards.21119 PyPIMIT