Mystic Forge

A unified MCP (Model Context Protocol) server for Magic: The Gathering. Combines Scryfall card search & pricing, EDHRec commander recommendations, Archidekt deck reading, and decklist validation into a single server.

Tools

Scryfall — Card Search & Pricing

Tool	Description
scryfall_search	Full Scryfall query syntax search
scryfall_named	Look up a card by name (exact + fuzzy)
scryfall_random	Random card with optional filter
scryfall_price	Current prices across all printings
scryfall_price_list	Batch-price up to 75 cards at once

EDHRec — Commander Recommendations

Tool	Description
edhrec_commander	Top card recommendations for a commander
edhrec_average_deck	Average decklist for a commander
edhrec_precon_upgrade	Community cut/added cards for a precon (real add %, ranked cuts)
edhrec_combos	Popular combo lines
edhrec_top_cards	Trending cards by period and color
edhrec_recommendations	Personalized suggestions given your current cards
edhrec_salt	Saltiest (most hated) cards

Archidekt — Deck Reading

Tool	Description
archidekt_deck	Fetch a public deck by ID or URL
archidekt_user_decks	List a user's public decks
archidekt_export	Export deck as importable card list

Validation

Tool	Description
validate_decklist	Verify card names, deck size, and color identity
validate_archidekt_deck	Full validation of an Archidekt deck including categories

Precon Decks (MTGJSON + EDHRec)

Tool	Description
precon_search	Search official precons by name or set code (MTGJSON)
precon_decklist	Full official contents of a precon (MTGJSON)
precon_export	Export a precon in Archidekt import format
precon_diff	Exact cut/added cards between a precon and a specific deck

Quick Start

Docker

docker compose up -d

The server runs at http://localhost:8000/mcp (streamable HTTP transport).

Connect to Claude Code

Add to ~/.claude/settings.local.json:

{
  "mcpServers": {
    "mystic-forge": {
      "type": "url",
      "url": "http://localhost:8000/mcp"
    }
  }
}

Connect to Claude.ai

Add as a Custom Connection with the URL http://localhost:8000/mcp.

stdio mode

python server.py --stdio

Self-Hosting with Private Archidekt Decks

Archidekt does not support OAuth, so private deck access requires your credentials. Create a .env file:

cp .env.example .env
# Edit .env with your Archidekt username and password

Important: Never deploy credentials on a shared/public server. Private deck access is for self-hosted instances only.

Data Sources

• Scryfall — Card data and prices (updated daily from TCGPlayer, Cardmarket, Cardhoarder)
• EDHRec — Commander metagame data and recommendations
• Archidekt — Deck building and storage

License

MIT