edhrec-mcp
This MCP server provides Magic: The Gathering Commander card lookup, Scryfall searches, and EDHREC deckbuilding recommendations.
Look up a card by name (exact/fuzzy) for oracle text, mana cost, type, color identity, Commander legality, USD price, image, and set.
Search cards using Scryfall query syntax, with a configurable result limit.
Get EDHREC recommendations for a commander, optionally narrowed by theme slug and budget, including top cards, high-synergy cards, game changers, by-type cards, and stats.
List available EDHREC themes/archetypes for a commander with deck counts.
Get the typical ~99-card average decklist for a commander, optionally filtered by theme and budget.
Note: the README mentions ManaBox collection/owned filtering, but the provided server schema does not expose a collection tool.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@edhrec-mcp recommend cards for Urza, Lord High Artificer"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 syncThis 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-mcpRegister with Claude Code
claude mcp add edhrec -- uv run --directory /absolute/path/to/edhrec-mcp edhrec-mcpOr 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 testsAvailable Tools
5 toolsget_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
Scored across 5 tools
Each tool has a distinct purpose: decklist retrieval, card lookup, recommendations, theme listing, and card search. No overlap or ambiguity.
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.
5 tools is well-scoped for the EDHREC domain, covering core operations without being overly extensive or sparse.
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
Related MCP Connectors
An MCP server that integrates with Discord to provide AI-powered features.
Market data tools for the MCP ecosystem: server stats, events, search, leaderboards, package trends.
One MCP server for the services your AI needs: memory, files, Microsoft 365, kanban and more.
Related MCP Servers
- AlicenseAqualityDmaintenanceMagic: The Gathering MCP server with card search, rules lookup, deck analysis, and Commander intelligence145MIT
- AlicenseAqualityDmaintenanceMCP 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.4MIT
- FlicenseNot gradedqualityDmaintenanceMCP server that searches and retrieves Magic: The Gathering card data from the Scryfall API.-
- AlicenseNot gradedqualityBmaintenanceUnified 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