万智牌卡牌与套牌MCP服务器

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

EDHRec — Commander Recommendations

Archidekt — Deck Reading

Validation

Precon Decks (MTGJSON + EDHRec)

Goldfish — Deck Simulation

Workflow: run goldfish_annotate on the deck first — it auto-derives what the engine models on its own and hands back the short list of cards that need a manual annotation. Pass those annotations to goldfish_run (or goldfish_ab for a paired swap comparison), then publish the numbers with goldfish_report — reports are rendered from the stored run's metrics, never hand-authored. Goldfish sims measure speed and consistency only; they cannot value interaction. For hosted reports, set GOLDFISH_REPORT_DIR to persist each run's HTML (served at /goldfish/r/<run_code>), and GOLDFISH_PUBLIC_BASE_URL to have run outputs include the public report link; leave both unset and reports are served from memory via goldfish_report only.

Comprehensive Rules

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.

MYSTIC_FORGE_CR is optional: it sets where the auto-refreshed Comprehensive Rules cache is written; it defaults to the working directory.

Price watchlist

Personal MTG price watchlists with 120 days of daily MTGJSON history plus weekly averages further back — the server keeps its own price store, so history outlives MTGJSON's rolling ~90-day window. Lists are identified by a passphrase (shown once at watchlist_create, or forged by hand at https://mcp.kautiontape.com/mtg/w/new): use it in a personal connector URL (https://mcp.kautiontape.com/mtg/mcp/<passphrase>) or pass it to tools in chat. Share codes (SC-…) grant read-only viewing at https://mcp.kautiontape.com/mtg/s/<code>. Every change is an append-only event — see the full chain at https://mcp.kautiontape.com/mtg/w/<passphrase> and recover any revision with watchlist_clone(at_seq=N) (mints a new passphrase). Prices ingest nightly from MTGJSON (tcgplayer/cardkingdom/cardmarket/manapool retail). A card's price basis is the cheapest of the USD shops unless it is pinned to one market; targets are judged on the basis. A target is a fixed price or a rule — low follows the historic low, low-10% stays 10% under it, -20% resolves to 20% under today's price — written after @ in bulk adds and imports. The board exports 1 Card Name lists straight into TCGplayer Mass Entry, the Card Kingdom deck builder, or Mana Pool, and imports them back. Health: GET /health.

Data Sources

• Scryfall — Card data and prices (updated daily from TCGPlayer, Cardmarket, Cardhoarder)
• EDHRec — Commander metagame data and recommendations
• Archidekt — Deck building and storage
• MTGJSON — Daily price history and printing/uuid mapping for the watchlist

License

MIT