mtg-oracle — Claude Code MCP server: what it does, how to install
mtg-oracle is a Claude Code MCP server that supplies card lookups, comprehensive Magic: The Gathering rules, format legality checks, and deck analysis tools.
MIT ★ 6 updated 2026-05-02
claude mcp add mtg-oracle -- npx -y mtg-oracleWhat mtg-oracle does
This server equips your assistant with local SQLite storage containing Scryfall card stats, Academy Ruins rules text, and Commander Spellbook combo data. It handles fuzzy card searches, price lookups across paper and digital formats, and legality checks for up to 50 cards at a time.
The package provides 14 tools covering plain-text or MTGO XML deck breakdowns, archetype staples, and synergy discovery. On its initial launch, it pulls card and rule datasets into ~/.mtg-oracle/ for offline processing. Running it requires Node.js 18 or higher.
What it helps with
- verify format legality for custom Magic decklists
- inspect mana curves and color distribution from MTGO XML files
- look up official rules and keyword definitions by section number
- discover Commander combos and synergies for specific color identities
Example prompts for the agent
- Analyze the decklist in deck.txt and check its Modern format legality
- Find combos for Atraxa with Commander Spellbook interactions
- Look up rule 702.1 and summarize how the mechanic works
How to install mtg-oracle
Platform CLI
claude mcp add mtg-oracle -- npx -y mtg-oraclePlatform CLI
codex mcp add mtg-oracle -- npx -y mtg-oracleConfig file
{
"mcpServers": {
"mtg-oracle": {
"command": "npx",
"args": [
"-y",
"mtg-oracle"
]
}
}
}Config file
{
"servers": {
"mtg-oracle": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mtg-oracle"
]
}
}
}Platform CLI
gemini mcp add mtg-oracle npx -y mtg-oracleStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about mtg-oracle
How to install mtg-oracle in Claude Code?
Run claude mcp add mtg-oracle -- npx -y mtg-oracle in your terminal.
What does mtg-oracle do?
It adds 14 tools to query Magic: The Gathering card texts, format rulings, prices, and Commander combos from a local SQLite database.
What is required to run mtg-oracle?
You need Node.js version 18 or newer. On first launch, the server downloads card databases directly to ~/.mtg-oracle/.