Magic The Gathering MCP

Hosted Model Context Protocol server for Magic: The Gathering deckbuilding agents. Real-time card data from Scryfall, real-deck references from Moxfield, and synergy/recommendation data from EDHREC — no auth, no setup, no dummy data.

Live data12 toolsNo authenticationStreamable HTTP & SSE

Hosted server

Plug this URL into ChatGPT's “Custom MCP Server” connector, Claude Desktop, or any client supporting the Model Context Protocol Streamable HTTP transport. No authentication required.

Streamable HTTP / SSEhttps://mtg-mcp.doodlemed.org/mcp
Aliashttps://mtg-mcp.doodlemed.org/sse
Canonicalhttps://mtg-mcp.doodlemed.org/api/mcp

GET any URL in a browser to see capability metadata. POST JSON-RPC 2.0 (initialize, tools/list, tools/call) to use it.

Connect from ChatGPT

ChatGPT supports custom MCP servers in its connector settings. Use the steps below to connect this server to ChatGPT in under a minute.

  1. Open ChatGPT and go to Settings → Connectors → Advanced → Developer mode and turn it on.
  2. Back in Connectors, click Create (or + Add) to add a new custom MCP server.
  3. Fill in the form:
    • Name: Magic The Gathering
    • Description: server for agents to deckbuild
    • MCP Server URL: https://mtg-mcp.doodlemed.org/mcp
    • Authentication: None
  4. Check “I understand and want to continue” on the custom-server warning, then save.
  5. In any chat, click the connector picker and select Magic The Gathering. ChatGPT will list 12 tools. Try a prompt like “Pull EDHREC recommendations for Atraxa, Praetors' Voice.”

Want to publish this connector as a discoverable App in ChatGPT? See App submission notes for the metadata, domain verification, and review steps.

Connect from Claude Desktop / Code

For Claude Desktop, edit claude_desktop_config.json and add an HTTP MCP server entry:

{
  "mcpServers": {
    "mtg-commander": {
      "type": "http",
      "url": "https://mtg-mcp.doodlemed.org/mcp"
    }
  }
}

For a stdio transport (Claude Desktop legacy, MCP Inspector, scripted clients), download a static binary below and point the client at the absolute path of the binary instead.

Download static binary

Go binaries built from the upstream nathanmartins/mtg-mcp source — statically linked, ~7 MB each, run the original stdio MCP transport directly.

Local stdio install

# Linux x86_64 example
curl -L https://mtg-mcp.doodlemed.org/mtg-mcp/binaries/mtg-commander-server-linux-amd64 \
  -o mtg-commander-server
chmod +x mtg-commander-server
./mtg-commander-server

Add to Claude Desktop's claude_desktop_config.json under mcpServers with the absolute path to the binary.

Available tools (12)

Every tool is backed by a real upstream API: Scryfall for card data, Moxfield for real decklists, EDHREC for synergy and combo data. No mock or cached responses.

  • search_cards
    Scryfall card search
    Search MTG cards using Scryfall query syntax. Up to 50 results, full card details, Commander legality.
  • get_card_details
    Scryfall card details
    Oracle text, mana cost, power/toughness, color identity, format legalities, artist and set.
  • check_commander_legality
    Scryfall legality check
    Banned / legal / not legal across all formats; quick format validation.
  • get_card_rulings
    Scryfall rulings
    Official Wizards of the Coast rulings with dates and sources.
  • get_card_price
    Scryfall pricing + live FX
    USD and EUR (regular + foil) from Scryfall, BRL via real-time currency conversion. Optional set-specific pricing.
  • get_banned_list
    Scryfall Commander banlist
    Real-time Commander banned list, updated automatically (85+ cards).
  • validate_deck
    Deck validator
    100-card size, singleton rule, Commander legality, color identity. JSON array decklists.
  • get_moxfield_deck
    Moxfield deck fetch
    Full decklist by URL or public ID, organized by card type, with metadata (views, likes, comments, author).
  • get_moxfield_user_decks
    Moxfield user decks
    List a user's public decks, paginated up to 100 per page.
  • search_moxfield_decks
    Moxfield deck search
    Search by commander name, filter by format, sort by updated/views/likes.
  • get_edhrec_recommendations
    EDHREC recommendations
    High-synergy cards, top staples, inclusion percentages, salt scores, deck count and meta stats.
  • get_edhrec_combos
    EDHREC combos
    Popular Commander combos by color identity (e.g. wu, ubr, wubrg) with prerequisites and results.