# gregario/mtg-oracle [Health: Active]

**Category:** 🎮 Gaming  
**Repository:** https://github.com/gregario/mtg-oracle  
**GitHub Stars:** 4  
**npm Downloads (last month):** 357  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/gregario-mtg-oracle

## Description
Magic: The Gathering card search, rules lookup, deck analysis, price data, and Commander intelligence. 14 tools, Scryfall + Academy Ruins + Commander Spellbook data.

## Tools
Capabilities this server exposes over MCP:

- **search_cards** — Search cards by name, type, color, mana cost, rarity, set, format, or keyword. Full-text search across names, type lines, and oracle text.
- **get_card** — Get complete details for a specific card: oracle text, mana cost, type, P/T, rulings, and legality. Fuzzy name matching.
- **get_rulings** — Get official Wizards of the Coast rulings for a card (interactions, edge cases, clarifications).
- **check_legality** — Check format legality for one or more cards (up to 50). Covers Commander, Modern, Standard, Legacy, Vintage, and more.
- **search_by_mechanic** — Find cards with a specific keyword or mechanic (Flying, Trample, Cascade, etc.). Optionally includes the keyword's rules definition.
- **get_prices** — Look up current market prices for one or more cards (up to 50). Returns USD, USD Foil, EUR, and MTGO tix prices from Scryfall.
- **analyze_deck** — Analyze a deck list (plain text or MTGO XML). Returns mana curve, color distribution, type breakdown, mana base analysis, and format legality check.
- **lookup_rule** — Look up Comprehensive Rules by section number (e.g., "702.1") or search by text. Returns rule text with subsections and parent context.
- **get_glossary** — Look up game terminology in the official glossary ("permanent", "spell", "stack", "priority", etc.).
- **get_keyword** — Get the official rules definition for keyword abilities (Flying, Deathtouch, Equip, etc.).
- **analyze_commander** — Analyze a legendary creature as a Commander: strategies, archetypes, recommended card categories for deckbuilding.
- **find_combos** — Find known infinite combos from Commander Spellbook. Search by card name(s) or color identity. Returns steps, prerequisites, and results.
- **find_synergies** — Find synergy categories (tokens, sacrifice, counters, etc.) and sample cards that work well with a specific card.
- **get_format_staples** — Get staple cards and popular archetypes for any format. Optionally filter by archetype.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

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

## Documentation

## 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:

```bash
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`. The README also documents adding the same command through Claude Code.

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.

_Full upstream README: https://allmcps.com/mcp/gregario-mtg-oracle/readme_