Log inSubmit server
Mtg Oracle logo

Mtg Oracle

by gregario

Searches Magic cards, rules, prices, decks, Commander combos, synergies, and format data through MCP.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Mtg Oracle

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "gregario-mtg-oracle": {
      "command": "npx",
      "args": [
        "-y",
        "mtg-oracle"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

We couldn’t confirm it starts correctly

We ran the install command but it didn't respond within our test window — this can mean a slow first-time install rather than a real problem.

npx -y mtg-oracle

No response to initialize.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 1mo ago.

Overview

The gregario/mtg-oracle MCP server gives AI assistants tools for searching Magic: The Gathering cards, checking rules and legality, analyzing decks, and exploring Commander strategies. It downloads Scryfall card data, Academy Ruins rules data, and combo data into a local SQLite database for offline queries after initial setup. Use it when an agent needs structured card details, rulings, format checks, price data, deck metrics, or Commander-focused recommendations. It runs locally through Node.js and does not require a documented API key.

Use cases

  • Search cards by mechanics, colors, sets, or formats
  • Check card rulings and format legality
  • Analyze deck curves, colors, types, and mana bases
  • Explore Commander combos and card synergies
  • Look up Magic rules and format staples

Key features

  • Multi-field and full-text card search
  • Comprehensive Rules and glossary lookup
  • Deck analysis with legality checks
  • Scryfall price lookup for up to 50 cards
  • Commander combo, synergy, and strategy tools

Tools14

What Mtg Oracle lets your agent do. Expand a tool for its parameters.

Self-reported~458 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 2d ago

Recent health check succeeded.

19/19 checks healthy over the last 79d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 9d ago via OSV.dev · mtg-oracle (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars4Stargazers on the source repository.
npm downloads244Package downloads in the last 30 days.
Last commit5mo agoMost recent push to the default branch.
Install checkInconclusiveDidn't respond in our test window — often a slow first install.
Tools exposed14Callable tools this server registers over MCP.
Directory activity4 viewsConfig copies, upvotes, and views on AllMCPs.

How Mtg Oracle works

What gregario/mtg-oracle MCP server does

The gregario/mtg-oracle MCP server exposes 14 Magic: The Gathering tools over the Model Context Protocol. It covers card discovery, card details, official rulings, format legality, rules references, deck analysis, market prices, Commander planning, known combos, card synergies, and format staples.

Card searches can use fields such as name, type, color, mana cost, rarity, set, format, and keyword, with full-text matching across names, type lines, and oracle text. Individual card lookups return details including oracle text, mana cost, types, power and toughness, rulings, and legality. Legality checks accept up to 50 cards and support formats including Commander, Modern, Standard, Legacy, and Vintage.

How it works

On its first run, the server retrieves card information from Scryfall and rules information from Academy Ruins. It stores downloaded data under ~/.mtg-oracle/ and updates that local data on later runs. The local SQLite approach supports queries without repeatedly requesting card data during normal use, although the initial data download requires network access.

Rules tools can retrieve Comprehensive Rules sections by number or text search, provide surrounding context and subsections, define glossary terms, and explain keyword abilities. The server also exposes official card rulings for interaction questions. Price lookups return USD, foil USD, EUR, and MTGO ticket values from Scryfall.

Setup and configuration

The package requires Node.js 18 or newer. Run it directly with:

Terminal
npx -y mtg-oracle

It can also be installed globally with npm and started using the mtg-oracle command. For Claude Desktop, add a server entry whose command is npx and whose arguments are -y and mtg-oracle.

No environment variables or credential configuration are documented. The first launch creates the local data directory and obtains the source datasets automatically.

Tools and capabilities

The gregario/mtg-oracle MCP server supports plain-text and MTGO XML deck input. Deck analysis reports mana curve, color distribution, card-type breakdown, mana-base information, and a format legality check.

Commander tools can evaluate a legendary creature, suggest strategy and archetype directions, identify useful card categories, find known infinite combos from Commander Spellbook, and return synergy categories with example cards. Combo searches can use card names or color identity and include steps, prerequisites, and results. Format-staple lookups can return common cards and archetypes, optionally narrowed to an archetype.

Limitations and notes

Card and price information comes from Scryfall, combo information comes from Commander Spellbook, and rules information comes from Academy Ruins. The project is unofficial fan content and is not endorsed by Wizards of the Coast or Scryfall. Price results are source data lookups rather than a stated guarantee of live market accuracy. The npm package does not bundle card data, so its first run needs to download the required datasets.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Mtg Oracle

Run `npx -y mtg-oracle`, or install it globally with npm using `npm install -g mtg-oracle`.

Yes. Configure Claude Desktop to run `npx` with the arguments `-y` and `mtg-oracle`.

No API key or credential configuration is documented. The server downloads its data sources on first run.

Yes. It accepts plain-text or MTGO XML deck lists and reports curve, colors, card types, mana-base analysis, and format legality.

It uses Scryfall for card and price data, Academy Ruins for rules data, and Commander Spellbook for combo data.

Related MCP servers

All in Gaming All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewMtg Oracle AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/gregario-mtg-oracle?style=directory)](https://allmcps.com/mcp/gregario-mtg-oracle)
HTML Embed
<a href="https://allmcps.com/mcp/gregario-mtg-oracle"><img src="https://allmcps.com/api/badge/gregario-mtg-oracle?style=directory" alt="Mtg Oracle on AllMCPs" /></a>