Skip to main content
Glama
edhrec-mcp

edhrec-mcp

by getsec

edhrec-mcp

An MCP server for Magic: The Gathering, focused on Commander (EDH). It exposes authoritative card data from Scryfall and community deckbuilding suggestions from EDHREC.

Tools

  • get_card(name) — card details: oracle text, mana cost, type, color identity, Commander legality, USD price, image.

  • search_cards(query, limit=20) — Scryfall query-syntax search.

  • get_commander_recommendations(commander, theme=None, budget=None) — EDHREC recommended cards (top, high-synergy, game changers, by type) with stats.

  • list_commander_themes(commander) — available themes/archetypes with counts.

  • get_average_decklist(commander, theme=None, budget=None) — the typical ~99 cards.

  • get_collection(colors=None, binder=None, type_contains=None, name_contains=None) — your cards, from the newest ManaBox CSV export, with color identity and USD value.

Related MCP server: Scryfall MCP Server

Your collection (ManaBox)

In ManaBox: Collection tab > top-right menu > Export > CSV. The newest ManaBox_Collection*.csv in ~/Downloads is used (override with EDHREC_MCP_COLLECTION, a file or folder). Re-export whenever the collection changes; nothing else to sync. When an export exists, recommendations get an owned flag (plus owned_only=True to filter) and the average decklist gains owned / missing lists.

theme is a slug from list_commander_themes (e.g. infect). budget is budget or expensive.

Install

Uses uv for environment and dependency management.

uv sync

This creates .venv/ and installs the project from the locked dependencies.

Without uv, you can use a standard virtualenv instead:

python3 -m venv .venv && .venv/bin/pip install -e .

Run

uv run edhrec-mcp

Register with Claude Code

claude mcp add edhrec -- uv run --directory /absolute/path/to/edhrec-mcp edhrec-mcp

Or add to an MCP client config:

{
  "mcpServers": {
    "edhrec": {
      "command": "uv",
      "args": ["run", "--directory", "/absolute/path/to/edhrec-mcp", "edhrec-mcp"]
    }
  }
}

Data & caching

Responses are cached under ~/.cache/edhrec-mcp/ (override with EDHREC_MCP_CACHE_DIR): EDHREC pages 24h, Scryfall cards 12h. Prices may therefore be up to 12h stale. EDHREC has no official API; this server reads its public JSON endpoints politely (identifying User-Agent, throttled requests).

Development

uv sync --extra dev          # install runtime + dev dependencies
uv run pytest                # unit tests (no network)
uv run pytest -m network     # live integration tests

Available Tools

5 tools
get_average_decklistB

The typical ~99-card EDHREC decklist for a Commander.

Optional theme (theme slug) and budget ('budget'/'expensive') narrow it.

Inputs: commander (required), theme, budget.

get_cardA

Look up a Magic card by name (exact, falling back to fuzzy match).

Returns oracle text, mana cost, type line, color identity, Commander legality, USD price, image URL and set.

Inputs: name (required).

get_commander_recommendationsA

EDHREC card recommendations for a Commander.

Optional theme is a theme slug from list_commander_themes (e.g. 'infect'). Optional budget is 'budget' or 'expensive'. Returns card lists (top cards, high-synergy cards, game changers, by type) with synergy and inclusion stats.

Inputs: commander (required), theme, budget.

list_commander_themesA

List EDHREC themes/archetypes available for a Commander, with deck counts.

Inputs: commander (required).

search_cardsC

Search for Magic cards using Scryfall query syntax.

Example queries: 't:dragon c:r cmc<=4', 'o:"draw a card" t:instant'.

Inputs: query (required), limit.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.8/5.0

    Scored across 5 tools

    Disambiguation5/5

    Each tool has a distinct purpose: decklist retrieval, card lookup, recommendations, theme listing, and card search. No overlap or ambiguity.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern using snake_case (e.g., get_average_decklist, list_commander_themes). Verbs like get, list, search are clear and predictable.

    Tool Count5/5

    5 tools is well-scoped for the EDHREC domain, covering core operations without being overly extensive or sparse.

    Completeness5/5

    The tool set covers essential EDHREC operations: decklist retrieval, card info, commander recommendations, theme listing, and card search. No obvious gaps that would hinder agent workflows.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      MCP server for searching and retrieving Magic: The Gathering card information via the Scryfall API, with support for field presets, multiple output formats, and automatic rate limiting.
      4
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Unified MCP server for Magic: The Gathering, combining Scryfall card search and pricing, EDHRec commander recommendations, Archidekt deck reading, and decklist validation into a single service.
      MIT