Skip to main content
MCP server CX Codex

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

Install into Claude Code · Platform CLI All methods and platforms ↓
claude mcp add mtg-oracle -- npx -y mtg-oracle
Open on GitHub

What 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-oracle

Step 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/.

Similar MCP servers

All MCP servers for Agent setup: memory, context, orchestration →

Project sponsors

Companies that keep this analytics open