Mtg Oracle

io.github.gregarioPublished by GitHub account gregariov0.1.0Updated Oct 27, 2026

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

VerifiedSTDIODesktop onlyKnowledge & MemoryData & Analytics

Overview

AI-generated overview

Local Magic: The Gathering server that lets an assistant search cards, look up rules, analyze decks and explore Commander combos and synergies.

What you can do
  • Search and read cards: full-text card search, full card details, official rulings, format legality checks, mechanic searches and market prices
  • Analyze decks: mana curve, color and type breakdown, mana base and legality from a plain-text or MTGO XML deck list
  • Look up rules: Comprehensive Rules by section number or text, official glossary terms and keyword ability definitions
  • Commander support: commander strategy analysis, known infinite combos from Commander Spellbook, synergy categories and format staples
When to use it
Useful when you want an assistant to answer Magic: The Gathering questions accurately — card lookups, rules disputes, deck building and tuning, Commander strategy, or checking combos and format legality — without pasting card text by hand.
Requirements
Runs locally as a Node.js process, installed globally with npm or launched with npx. On first run it downloads card data from Scryfall and rules data from Academy Ruins into a local folder, and updates it automatically on later runs, so network access is needed. No accounts, API keys or environment variables are declared.
Before you install
The first run downloads a sizable card and rules dataset to local storage and refreshes it automatically on subsequent runs. Card, combo and rules data come from third-party sources (Scryfall, Commander Spellbook, Academy Ruins) and prices are informational only. It is unofficial fan content, not endorsed by Wizards of the Coast.

Installation

In SourceWeft

  1. Open Mtg Oracle in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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

bash
npm install -g mtg-oracle

Or run directly with npx:

bash
npx mtg-oracle

Claude Desktop Configuration

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

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

Or if installed globally:

json
{  "mcpServers": {    "mtg-oracle": {      "command": "mtg-oracle"    }  }}

Claude Code Configuration

bash
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

ToolDescription
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.

Deck Tools

ToolDescription
analyze_deckAnalyze a deck list (plain text or MTGO XML). Returns mana curve, color distribution, type breakdown, mana base analysis, and format legality check.

Rules Tools

ToolDescription
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.).

Commander Tools

ToolDescription
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.

Development

bash
# Install dependenciesnpm install
# Run testsnpm test
# Buildnpm run build
# Run locallynpm start

Attribution

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

Source: README.md at commit e8d736d

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.0LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts