English Français العربية

io.github.gregario/mtg-oracle

Registre officiel Autres

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

Code source Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

NPM package mtg-oracle
Claude Code 
claude mcp add mtg-oracle -- npx -y mtg-oracle@0.1.0
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "mtg-oracle": {
            "command": "npx",
            "args": [
                "-y",
                "mtg-oracle@0.1.0"
            ]
        }
    }
}

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. mtg-oracle
  2. Installation
  3. Claude Desktop Configuration
  4. Claude Code Configuration
  5. Data
  6. Tools
  7. Development
  8. Attribution
  9. Legal
  10. License

mtg-oracle

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

# Install dependencies
npm install

# Run tests
npm test

# Build
npm run build

# Run locally
npm start

Attribution

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

Questions fréquentes

Qu'est-ce que io.github.gregario/mtg-oracle ?

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

Comment installer io.github.gregario/mtg-oracle ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add mtg-oracle -- npx -y mtg-oracle@0.1.0. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour io.github.gregario/mtg-oracle ?

Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.

io.github.gregario/mtg-oracle est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient io.github.gregario/mtg-oracle ?

Il est publié par gregario. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.