Mtg Oracle

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.

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

Or run directly with npx:

npx mtg-oracle

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

Data

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

Deck Tools

Rules Tools

Commander Tools

Development

# Install dependencies
npm install

# Run tests
npm test

# Build
npm run build

# Run locally
npm start

Attribution

• 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