Summary
Connects Claude to the Magic: The Gathering data ecosystem through Scryfall, Commander Spellbook, 17Lands, EDHREC, and competitive metagame sources. You get 69 tools covering card search with full Scryfall syntax, combo lookups, draft analytics with GIH win rates and ALSA scores, Commander staples and synergy data, and constructed metagame snapshots. The server exposes both high level operations like deck validation and mana base suggestions alongside granular lookups for rules interactions and card comparisons. Useful when you're building decks, analyzing draft picks, researching Commander upgrades, or need programmatic access to MTG data without managing multiple APIs. Built on FastMCP with Python 3.12, runs locally or hosted, no API keys required since all sources are public.
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
Tools
Public tool metadata for what this MCP can expose to an agent.
69 tools
pingHealth check — returns 'pong'.
Health check — returns 'pong'.
No parameter schema in public metadata yet.
scryfall_search_cardsSearch for Magic cards using Scryfall syntax. Examples: "f:commander id:sultai t:creature", "o:destroy t:instant cmc<=3" See https://scryfall.com/docs/syntax for full syntax reference.4 params
Search for Magic cards using Scryfall syntax. Examples: "f:commander id:sultai t:creature", "o:destroy t:instant cmc<=3" See https://scryfall.com/docs/syntax for full syntax reference.
Parameters* required
pageintegerPage number for paginated results, 1-indexeddefault: 1
limitintegerMax cards to return (default 30, 0 for all)default: 30
querystringScryfall search query (e.g. 'f:commander id:sultai t:creature cmc<=3'). See scryfall.com/docs/syntax
response_formatstringOutput verbosity: 'detailed' (default) or 'concise'one of
detailed · concisedefault: detailedscryfall_card_detailsGet full details for a Magic card by exact or fuzzy name.3 params
Get full details for a Magic card by exact or fuzzy name.
Parameters* required
namestringCard name — exact match by default (e.g. 'Muldrotha, the Gravetide')
fuzzybooleanUse fuzzy matching for approximate names (e.g. 'muldrotha' finds 'Muldrotha, the Gravetide')default: false
response_formatstringOutput verbosity: 'detailed' (default) or 'concise'one of
detailed · concisedefault: detailedscryfall_card_priceGet current prices for a Magic card. Prices update once per day.1 params
Get current prices for a Magic card. Prices update once per day.
Parameters* required
namestringCard name for price lookup (exact match)
scryfall_card_rulingsGet official rulings and clarifications for a Magic card.1 params
Get official rulings and clarifications for a Magic card.
Parameters* required
namestringCard name to get official rulings for (exact match)
scryfall_set_infoGet metadata for a Magic set by its code.1 params
Get metadata for a Magic set by its code.
Parameters* required
set_codestringSet code (e.g. 'dom', 'mh2', 'lci')
scryfall_whats_newFind recently printed or released Magic cards. Searches Scryfall for cards released within the given number of days. Optionally filter by set or format legality.5 params
Find recently printed or released Magic cards. Searches Scryfall for cards released within the given number of days. Optionally filter by set or format legality.
Parameters* required
daysintegerLook back this many days for recent cards (minimum 1)default: 30
limitintegerMax cards to return (default 30, 0 for all)default: 30
formatvalueFilter to cards legal in a format (e.g. 'standard', 'commander', 'modern')
set_codevalueFilter to a specific set code (e.g. 'mh3', 'lci')
response_formatstringOutput verbosity: 'detailed' (default) or 'concise'one of
detailed · concisedefault: detailedspellbook_find_combosSearch for known combos involving a specific card. Optionally filter by color identity (e.g. "sultai", "BUG", "wubrg"). Returns up to `limit` combos with cards involved and results produced.3 params
Search for known combos involving a specific card. Optionally filter by color identity (e.g. "sultai", "BUG", "wubrg"). Returns up to `limit` combos with cards involved and results produced.
Parameters* required
limitintegerMaximum number of combos to returndefault: 10
card_namestringCard name to search for combos (e.g. 'Muldrotha, the Gravetide')
color_identityvalueFilter by color identity — name ('sultai'), letters ('BUG'), or 'wubrg'
spellbook_combo_detailsGet detailed steps for a specific combo by its Spellbook ID. Use an ID from find_combos results (e.g. "1414-2730-5131-5256").1 params
Get detailed steps for a specific combo by its Spellbook ID. Use an ID from find_combos results (e.g. "1414-2730-5131-5256").
Parameters* required
combo_idstringSpellbook combo ID from find_combos results (e.g. '1414-2730-5131-5256')
spellbook_find_decklist_combosFind combos present in (or nearly present in) a Commander decklist. Provide commander name(s) and a list of card names in the main deck. Returns combos that are fully included and those that are almost included.2 params
Find combos present in (or nearly present in) a Commander decklist. Provide commander name(s) and a list of card names in the main deck. Returns combos that are fully included and those that are almost included.
Parameters* required
decklistarrayList of card names in the main deck
commandersarrayCommander card name(s) (e.g. ['Muldrotha, the Gravetide'])
spellbook_estimate_bracketEstimate the Commander bracket (power level) for a decklist. Provide commander name(s) and a list of card names in the main deck. Returns bracket tag and any bracket-relevant findings.2 params
Estimate the Commander bracket (power level) for a decklist. Provide commander name(s) and a list of card names in the main deck. Returns bracket tag and any bracket-relevant findings.
Parameters* required
decklistarrayList of card names in the main deck
commandersarrayCommander card name(s) (e.g. ['Muldrotha, the Gravetide'])
draft_card_ratingsGet win rate and draft performance data for cards in a set. Key metrics: GIH WR (ever_drawn_win_rate), ALSA (avg_seen), OH WR (opening_hand_win_rate), IWD (drawn_improvement_win_rate). Note: 17Lands data skews toward above-average players (~56% baseline WR). Cards with <500 ga...5 params
Get win rate and draft performance data for cards in a set. Key metrics: GIH WR (ever_drawn_win_rate), ALSA (avg_seen), OH WR (opening_hand_win_rate), IWD (drawn_improvement_win_rate). Note: 17Lands data skews toward above-average players (~56% baseline WR). Cards with <500 ga...
Parameters* required
limitintegerMax cards to return (default 50, 0 for all)default: 50
sort_bystringSort order: 'gih_wr' (default), 'alsa', 'iwd', 'name'default: gih_wr
set_codestringThree-letter set code (e.g. 'LCI', 'MKM', 'OTJ', 'BLB')
event_typestringDraft format — 'PremierDraft' (default) or 'TradDraft'default: PremierDraft
response_formatstringOutput verbosity: 'detailed' (default) or 'concise'one of
detailed · concisedefault: detaileddraft_archetype_statsGet win rates by color pair/archetype for a draft set. Note: start_date and end_date are required by the 17Lands API. Args: set_code: Three-letter set code (e.g. "LCI", "MKM", "OTJ"). start_date: Start date in YYYY-MM-DD format. end_date: End date in YYYY-MM-DD format. event_t...4 params
Get win rates by color pair/archetype for a draft set. Note: start_date and end_date are required by the 17Lands API. Args: set_code: Three-letter set code (e.g. "LCI", "MKM", "OTJ"). start_date: Start date in YYYY-MM-DD format. end_date: End date in YYYY-MM-DD format. event_t...
Parameters* required
end_datestringEnd date in YYYY-MM-DD format (required by 17Lands API)
set_codestringThree-letter set code (e.g. 'LCI', 'MKM', 'OTJ', 'BLB')
event_typestringDraft format — 'PremierDraft' (default) or 'TradDraft'default: PremierDraft
start_datestringStart date in YYYY-MM-DD format (required by 17Lands API)
edhrec_commander_staplesGet the most-played cards for a commander with synergy scores and inclusion rates. Shows which cards are most commonly played with this commander and how synergistic they are (vs. generic popularity).4 params
Get the most-played cards for a commander with synergy scores and inclusion rates. Shows which cards are most commonly played with this commander and how synergistic they are (vs. generic popularity).
Parameters* required
limitintegerMax cards per category (default 10, 0 for all)default: 10
categoryvalueFilter by card type: 'creatures', 'enchantments', 'artifacts', 'instants', 'sorceries', 'lands', 'planeswalkers'
commander_namestringFull commander name (e.g. 'Muldrotha, the Gravetide')
response_formatstringOutput verbosity: 'detailed' (default) or 'concise'one of
detailed · concisedefault: detailededhrec_card_synergyGet synergy data for a specific card with a specific commander. Shows how synergistic the card is with the commander compared to its general popularity, plus how many decks include it. Args: card_name: The card to check (e.g. "Spore Frog"). commander_name: The commander to che...2 params
Get synergy data for a specific card with a specific commander. Shows how synergistic the card is with the commander compared to its general popularity, plus how many decks include it. Args: card_name: The card to check (e.g. "Spore Frog"). commander_name: The commander to che...
Parameters* required
card_namestringCard to check synergy for (e.g. 'Spore Frog')
commander_namestringCommander to check synergy against (e.g. 'Muldrotha, the Gravetide')
moxfield_decklistFetch a full decklist from Moxfield by deck ID or URL. Returns the complete decklist organized by board (commanders, mainboard, sideboard, companions) with card names and quantities.1 params
Fetch a full decklist from Moxfield by deck ID or URL. Returns the complete decklist organized by board (commanders, mainboard, sideboard, companions) with card names and quantities.
Parameters* required
deck_idstringMoxfield deck ID or full URL (e.g. 'abc123' or 'https://www.moxfield.com/decks/abc123')
moxfield_deck_infoGet metadata for a Moxfield deck (name, format, author, dates). Returns deck metadata without the full card list. Use ``decklist`` for the complete card list.1 params
Get metadata for a Moxfield deck (name, format, author, dates). Returns deck metadata without the full card list. Use ``decklist`` for the complete card list.
Parameters* required
deck_idstringMoxfield deck ID or full URL (e.g. 'abc123' or 'https://www.moxfield.com/decks/abc123')
moxfield_search_decksSearch public Moxfield decks by format, keyword, or sort order. Returns a paginated list of deck summaries with name, format, author, colors, and card counts.5 params
Search public Moxfield decks by format, keyword, or sort order. Returns a paginated list of deck summaries with name, format, author, colors, and card counts.
Parameters* required
pageintegerPage number (1-indexed)default: 1
sortstringSort order: 'Updated', 'Created', or 'Views'default: Updated
queryvalueOptional search text to filter decks by name or description
formatvalueFormat filter (e.g. 'pauper', 'commander', 'modern'). Leave empty for all formats.
page_sizeintegerResults per page (max 100)default: 20
moxfield_user_decksList a user's public decks on Moxfield. Verifies the user exists, then searches for their public decks. Optionally filter by format.2 params
List a user's public decks on Moxfield. Verifies the user exists, then searches for their public decks. Optionally filter by format.
Parameters* required
formatvalueOptional format filter (e.g. 'commander', 'modern')
usernamestringMoxfield username to look up
bulk_card_lookupLook up a Magic card by exact name using Scryfall bulk data. Returns full card details including mana cost, type, oracle text, colors, power/toughness, prices, legalities, and EDHREC rank. Case-insensitive.2 params
Look up a Magic card by exact name using Scryfall bulk data. Returns full card details including mana cost, type, oracle text, colors, power/toughness, prices, legalities, and EDHREC rank. Case-insensitive.
Parameters* required
namestringCard name for exact lookup, case-insensitive (e.g. 'Sol Ring')
response_formatstringOutput verbosity: 'detailed' (default) or 'concise'one of
detailed · concisedefault: detailedbulk_card_searchSearch for Magic cards in Scryfall bulk data. Args: query: Substring to search for (case-insensitive). search_field: Field to search in -- "name", "type", or "text". limit: Maximum number of results to return (default 20).4 params
Search for Magic cards in Scryfall bulk data. Args: query: Substring to search for (case-insensitive). search_field: Field to search in -- "name", "type", or "text". limit: Maximum number of results to return (default 20).
Parameters* required
limitintegerMaximum number of results to returndefault: 20
querystringSubstring to search for, case-insensitive
search_fieldstringField to search in -- 'name' (card name), 'type' (type line), or 'text' (oracle text)one of
name · type · textdefault: nameresponse_formatstringOutput verbosity: 'detailed' (default) or 'concise'one of
detailed · concisedefault: detailedbulk_format_legalityBatch legality check for cards in a specific format. Returns a markdown table showing the legality status of each card in the specified format. Handles common format aliases (e.g. 'edh' for 'commander').2 params
Batch legality check for cards in a specific format. Returns a markdown table showing the legality status of each card in the specified format. Handles common format aliases (e.g. 'edh' for 'commander').
Parameters* required
cardsarrayList of card names to check legality for
formatstringFormat to check (e.g. 'commander', 'modern', 'standard', 'legacy')
bulk_format_searchSearch for legal cards in a specific format using natural language. Combines format legality filtering with name/type/text search and optional color identity, price, and rarity constraints. Results are sorted by EDHREC rank (most popular first).7 params
Search for legal cards in a specific format using natural language. Combines format legality filtering with name/type/text search and optional color identity, price, and rarity constraints. Results are sorted by EDHREC rank (most popular first).
Parameters* required
limitintegerMaximum results to returndefault: 20
querystringSearch query -- card name, type, or oracle text substring (e.g. 'flying creatures', 'destroy target')
formatstringFormat to search in (e.g. 'commander', 'modern', 'standard')
rarityvalueRarity filter (e.g. 'common', 'uncommon', 'rare', 'mythic')
max_pricevalueMaximum USD price filter
color_identityvalueColor identity filter (e.g. 'sultai', 'WU', 'red'). Only returns cards within this identity.
response_formatstringOutput verbosity: 'detailed' (default) or 'concise'one of
detailed · concisedefault: detailedbulk_format_staplesFind the most popular (staple) cards legal in a format. Ranking adapts to the format: singleton formats (Commander, Brawl, Oathbreaker) use EDHREC rank; competitive formats use MTGGoldfish tournament frequency when available, falling back to a mana-efficiency heuristic.6 params
Find the most popular (staple) cards legal in a format. Ranking adapts to the format: singleton formats (Commander, Brawl, Oathbreaker) use EDHREC rank; competitive formats use MTGGoldfish tournament frequency when available, falling back to a mana-efficiency heuristic.
Parameters* required
colorvalueColor identity filter (e.g. 'sultai', 'WU', 'red'). Only returns cards within this identity.
limitintegerMaximum results to returndefault: 20
formatstringFormat to find staples for (e.g. 'commander', 'modern', 'legacy')
card_typevalueCard type filter (e.g. 'creature', 'instant', 'land')
ranking_modestringHow to rank staples: 'auto' (default) picks the best mode for the format, 'edhrec' uses Commander popularity, 'competitive' uses a mana-efficiency heuristic, 'tournament' uses MTGGoldfish metagame frequency.one of
auto · edhrec · competitive · tournamentdefault: autoresponse_formatstringOutput verbosity: 'detailed' (default) or 'concise'one of
detailed · concisedefault: detailedbulk_similar_cardsFind cards similar to a given card. Scores similarity based on shared keywords, type words, CMC proximity, and oracle text overlap. Optionally filter by format legality and price.5 params
Find cards similar to a given card. Scores similarity based on shared keywords, type words, CMC proximity, and oracle text overlap. Optionally filter by format legality and price.
Parameters* required
limitintegerMaximum results to returndefault: 10
formatvalueFormat filter (e.g. 'commander', 'modern'). Only returns legal cards.
card_namestringName of the card to find similar cards for
max_pricevalueMaximum USD price filter
response_formatstringOutput verbosity: 'detailed' (default) or 'concise'one of
detailed · concisedefault: detailedbulk_random_cardGet a random Magic card, optionally filtered by format, color, type, and rarity. Returns full card details in the same format as card_lookup.4 params
Get a random Magic card, optionally filtered by format, color, type, and rarity. Returns full card details in the same format as card_lookup.
Parameters* required
formatvalueFormat filter (e.g. 'commander', 'modern'). Only returns legal cards.
rarityvalueRarity filter (e.g. 'common', 'uncommon', 'rare', 'mythic')
card_typevalueCard type filter (e.g. 'creature', 'instant', 'land')
color_identityvalueColor identity filter (e.g. 'sultai', 'WU', 'red'). Only returns cards within this identity.
bulk_ban_listGet the banned and restricted cards for a format. Returns alphabetically sorted lists of banned and restricted cards, including their type lines.1 params
Get the banned and restricted cards for a format. Returns alphabetically sorted lists of banned and restricted cards, including their type lines.
Parameters* required
formatstringFormat to check ban list for (e.g. 'commander', 'modern', 'standard')
bulk_card_in_formatsShow a card's legality across all Magic formats. Returns a table with the card's legality status in each format, ordered with the most common formats first.1 params
Show a card's legality across all Magic formats. Returns a table with the card's legality status in each format, ordered with the most common formats first.
Parameters* required
card_namestringCard name to check format legality for
spicerack_recent_tournamentsList recent tournaments for a format with dates, player counts, and IDs. Use the tournament ID from the results with ``tournament_results`` to see full standings and decklists.4 params
List recent tournaments for a format with dates, player counts, and IDs. Use the tournament ID from the results with ``tournament_results`` to see full standings and decklists.
Parameters* required
limitintegerMaximum number of tournaments to return (default 10)default: 10
formatstringMTG format name (e.g. 'Modern', 'Legacy', 'Pauper')
num_daysintegerNumber of days to look back (default 14)default: 14
response_formatstringOutput verbosity: 'detailed' (default) or 'concise'one of
detailed · concisedefault: detailedspicerack_tournament_resultsGet full standings and decklists for a specific tournament. Look up a tournament by its Spicerack ID. Use ``recent_tournaments`` first to find tournament IDs.5 params
Get full standings and decklists for a specific tournament. Look up a tournament by its Spicerack ID. Use ``recent_tournaments`` first to find tournament IDs.
Parameters* required
top_nintegerNumber of top standings to show (default 8)default: 8
formatvalueFormat to search within (optional, helps narrow results)
num_daysintegerNumber of days to look back (default 30)default: 30
tournament_idstringSpicerack tournament ID (e.g. '3135276')
response_formatstringOutput verbosity: 'detailed' (default) or 'concise'one of
detailed · concisedefault: detailedspicerack_format_decklistsFind top-performing decklists across recent tournaments for a format. Collects top-4 finishers with Moxfield decklists from recent events. Use ``moxfield_decklist`` to fetch the full card list for a deck.4 params
Find top-performing decklists across recent tournaments for a format. Collects top-4 finishers with Moxfield decklists from recent events. Use ``moxfield_decklist`` to fetch the full card list for a deck.
Parameters* required
limitintegerMaximum number of decklists to return (default 10)default: 10
formatstringMTG format name (e.g. 'Modern', 'Legacy', 'Pauper')
num_daysintegerNumber of days to look back (default 14)default: 14
response_formatstringOutput verbosity: 'detailed' (default) or 'concise'one of
detailed · concisedefault: detailedgoldfish_metagameGet the current metagame breakdown for a competitive format. Shows top archetypes with meta share percentages, deck counts, and estimated paper prices.2 params
Get the current metagame breakdown for a competitive format. Shows top archetypes with meta share percentages, deck counts, and estimated paper prices.
Parameters* required
formatstringMTG format name (e.g. 'Modern', 'Legacy', 'Pioneer', 'Pauper')
response_formatstringOutput verbosity: 'detailed' (default) or 'concise'one of
detailed · concisedefault: detailedgoldfish_archetype_listGet a sample decklist for an archetype in a format. Returns deck metadata (author, event, result, date) and the full mainboard and sideboard card list.3 params
Get a sample decklist for an archetype in a format. Returns deck metadata (author, event, result, date) and the full mainboard and sideboard card list.
Parameters* required
formatstringMTG format name (e.g. 'Modern', 'Legacy', 'Pioneer')
archetypestringArchetype name (e.g. 'Boros Energy', 'Azorius Control')
response_formatstringOutput verbosity: 'detailed' (default) or 'concise'one of
detailed · concisedefault: detailedgoldfish_format_staplesGet the most-played cards in a format with deck inclusion percentages. Shows which cards appear most frequently across all archetypes in the format, with average copies played per deck.3 params
Get the most-played cards in a format with deck inclusion percentages. Shows which cards appear most frequently across all archetypes in the format, with average copies played per deck.
Parameters* required
limitintegerMaximum number of staples to return (default 20)default: 20
formatstringMTG format name (e.g. 'Modern', 'Legacy', 'Pioneer')
response_formatstringOutput verbosity: 'detailed' (default) or 'concise'one of
detailed · concisedefault: detailedgoldfish_deck_priceGet the estimated paper price for an archetype deck. Returns the total estimated cost of the deck based on current card prices from MTGGoldfish.3 params
Get the estimated paper price for an archetype deck. Returns the total estimated cost of the deck based on current card prices from MTGGoldfish.
Parameters* required
formatstringMTG format name (e.g. 'Modern', 'Legacy', 'Pioneer')
archetypestringArchetype name (e.g. 'Boros Energy', 'Azorius Control')
response_formatstringOutput verbosity: 'detailed' (default) or 'concise'one of
detailed · concisedefault: detailedcommander_overviewComprehensive commander profile combining data from all available sources. Returns card details, top combos, EDHREC staples, and synergy scores. Degrades gracefully if optional sources (EDHREC, Spellbook) are unavailable.2 params
Comprehensive commander profile combining data from all available sources. Returns card details, top combos, EDHREC staples, and synergy scores. Degrades gracefully if optional sources (EDHREC, Spellbook) are unavailable.
Parameters* required
commander_namestringCommander card name (e.g. 'Muldrotha, the Gravetide')
response_formatstringOutput verbosity: 'detailed' (default) or 'concise'one of
detailed · concisedefault: detailedevaluate_upgradeAssess whether a card is worth adding to a specific commander deck. Returns card details, price, synergy score, and combos enabled for the caller to assess. Degrades gracefully if optional sources (EDHREC, Spellbook) are unavailable.3 params
Assess whether a card is worth adding to a specific commander deck. Returns card details, price, synergy score, and combos enabled for the caller to assess. Degrades gracefully if optional sources (EDHREC, Spellbook) are unavailable.
Parameters* required
card_namestringCard to evaluate for the deck (e.g. 'Spore Frog')
commander_namestringCommander the deck is built around
response_formatstringOutput verbosity: 'detailed' (default) or 'concise'one of
detailed · concisedefault: detaileddraft_pack_pickRank cards in a draft pack using 17Lands win rate data. Provides GIH WR, ALSA, IWD stats, and color fit analysis based on current picks. Requires 17Lands to be enabled.4 params
Rank cards in a draft pack using 17Lands win rate data. Provides GIH WR, ALSA, IWD stats, and color fit analysis based on current picks. Requires 17Lands to be enabled.
Parameters* required
packarrayList of card names currently in the draft pack
set_codestringThree-letter set code for the draft format (e.g. 'LCI', 'MKM')
current_picksvalueCards already drafted — enables color fit analysis when provided
response_formatstringOutput verbosity: 'detailed' (default) or 'concise'one of
detailed · concisedefault: detailedsuggest_cutsIdentify the weakest cards to cut from a commander decklist. Scores cards by synergy, inclusion rate, and combo membership. Degrades gracefully if EDHREC or Spellbook backends fail (uses whatever data is available).4 params
Identify the weakest cards to cut from a commander decklist. Scores cards by synergy, inclusion rate, and combo membership. Degrades gracefully if EDHREC or Spellbook backends fail (uses whatever data is available).
Parameters* required
decklistarrayList of card names in the deck
num_cutsintegerNumber of cut candidates to suggestdefault: 5
commander_namestringCommander the deck is built around
response_formatstringOutput verbosity: 'detailed' (default) or 'concise'one of
detailed · concisedefault: detailedcard_comparisonCompare 2-5 cards side-by-side for a specific commander deck. Shows mana cost, type, synergy, inclusion rate, combo count, and price for each card. Scryfall and Spellbook required; EDHREC optional.3 params
Compare 2-5 cards side-by-side for a specific commander deck. Shows mana cost, type, synergy, inclusion rate, combo count, and price for each card. Scryfall and Spellbook required; EDHREC optional.
Parameters* required
cardsarray2-5 card names to compare side-by-side
commander_namestringCommander the deck is built around
response_formatstringOutput verbosity: 'detailed' (default) or 'concise'one of
detailed · concisedefault: detailedbudget_upgradeSuggest budget-friendly upgrades for a commander deck. Ranks EDHREC staples by synergy-per-dollar within the given budget ceiling. Requires EDHREC (for staples) and Scryfall (for prices).4 params
Suggest budget-friendly upgrades for a commander deck. Ranks EDHREC staples by synergy-per-dollar within the given budget ceiling. Requires EDHREC (for staples) and Scryfall (for prices).
Parameters* required
budgetnumberMaximum price per card in USD (e.g. 5.0 for cards under $5)
commander_namestringCommander the deck is built around
num_suggestionsintegerNumber of upgrade suggestions to returndefault: 10
response_formatstringOutput verbosity: 'detailed' (default) or 'concise'one of
detailed · concisedefault: detaileddeck_analysisFull decklist health check — mana curve, colors, combos, bracket, budget, synergy. Uses all available backends: Scryfall bulk data for rate-limit-free card resolution, Scryfall API as fallback, Spellbook for combos and bracket estimation, EDHREC for synergy scores. Degrades gr...3 params
Full decklist health check — mana curve, colors, combos, bracket, budget, synergy. Uses all available backends: Scryfall bulk data for rate-limit-free card resolution, Scryfall API as fallback, Spellbook for combos and bracket estimation, EDHREC for synergy scores. Degrades gr...
Parameters* required
decklistarrayList of card names in the deck (99 cards for Commander)
commander_namestringCommander the deck is built around
response_formatstringOutput verbosity: 'detailed' (default) or 'concise'one of
detailed · concisedefault: detailedset_overviewDraft format overview — top commons/uncommons and trap rares. Uses 17Lands card ratings to provide a data-driven format breakdown. Requires 17Lands to be enabled.3 params
Draft format overview — top commons/uncommons and trap rares. Uses 17Lands card ratings to provide a data-driven format breakdown. Requires 17Lands to be enabled.
Parameters* required
set_codestringThree-letter set code for the draft format (e.g. 'LCI', 'MKM')
event_typestringDraft format — 'PremierDraft' (default) or 'TradDraft'default: PremierDraft
response_formatstringOutput verbosity: 'detailed' (default) or 'concise'one of
detailed · concisedefault: detailedtheme_searchFind cards matching a theme — mechanical, tribal, or abstract/flavorful. Maps themes to oracle text patterns and searches bulk data. Groups results by relevance tier (strong match, moderate match, flavor match).6 params
Find cards matching a theme — mechanical, tribal, or abstract/flavorful. Maps themes to oracle text patterns and searches bulk data. Groups results by relevance tier (strong match, moderate match, flavor match).
Parameters* required
limitintegerMaximum number of resultsdefault: 20
themestringTheme to search for — mechanical (aristocrats, voltron, tokens), tribal (goblin, merfolk), or abstract (music, death, ocean)
formatvalueFormat legality filter (e.g. 'standard', 'modern', 'commander')
max_pricevalueMaximum card price in USD
color_identityvalueColor identity filter (e.g. 'sultai', 'BUG', 'WR')
response_formatstringOutput verbosity: 'detailed' (default) or 'concise'one of
detailed · concisedefault: detailedbuild_aroundFind synergistic cards for 1-5 build-around cards in any format. Analyzes oracle text for key mechanics, searches for synergies, and checks combo potential. Groups results by role (enablers, payoffs, support).5 params
Find synergistic cards for 1-5 build-around cards in any format. Analyzes oracle text for key mechanics, searches for synergies, and checks combo potential. Groups results by role (enablers, payoffs, support).
Parameters* required
cardsarray1-5 card names to build around
limitintegerMaximum number of suggestionsdefault: 20
budgetvalueMaximum price per card in USD
formatstringFormat to build for (e.g. 'standard', 'modern', 'commander')
response_formatstringOutput verbosity: 'detailed' (default) or 'concise'one of
detailed · concisedefault: detailedcomplete_deckIdentify gaps in a partial decklist and suggest cards to fill them. Analyzes mana curve, card roles, and format-specific ratios, then suggests cards for underrepresented categories.5 params
Identify gaps in a partial decklist and suggest cards to fill them. Analyzes mana curve, card roles, and format-specific ratios, then suggests cards for underrepresented categories.
Parameters* required
budgetvalueMaximum price per suggested card in USD
formatstringFormat to build for (e.g. 'standard', 'modern', 'commander')
decklistarrayPartial decklist — card names already chosen
commandervalueCommander name (required for Commander format)
response_formatstringOutput verbosity: 'detailed' (default) or 'concise'one of
detailed · concisedefault: detailedcommander_comparisonCompare 2-5 commanders head-to-head: stats, combos, staples, popularity. Side-by-side comparison table with mana cost, color identity, EDHREC rank, combo count, and shared/unique staples.2 params
Compare 2-5 commanders head-to-head: stats, combos, staples, popularity. Side-by-side comparison table with mana cost, color identity, EDHREC rank, combo count, and shared/unique staples.
Parameters* required
commandersarray2-5 commander names to compare head-to-head
response_formatstringOutput verbosity: 'detailed' (default) or 'concise'one of
detailed · concisedefault: detailedtribal_staplesBest cards for a creature type — lords, synergy pieces, and top members. Groups results by: lords/anthems, tribal synergy, best members, tribal support.5 params
Best cards for a creature type — lords, synergy pieces, and top members. Groups results by: lords/anthems, tribal synergy, best members, tribal support.
Parameters* required
limitintegerMaximum number of resultsdefault: 20
tribestringCreature type (e.g. 'Goblin', 'Merfolk', 'Samurai')
formatvalueFormat legality filter (e.g. 'commander', 'modern')
color_identityvalueColor identity filter (e.g. 'sultai', 'WR')
response_formatstringOutput verbosity: 'detailed' (default) or 'concise'one of
detailed · concisedefault: detailedprecon_upgradeAnalyze and upgrade a Commander precon — identify weakest cards, suggest replacements. Pairs each upgrade with a specific cut, explaining the synergy improvement.5 params
Analyze and upgrade a Commander precon — identify weakest cards, suggest replacements. Pairs each upgrade with a specific cut, explaining the synergy improvement.
Parameters* required
budgetnumberMaximum price per upgrade card in USDdefault: 50
decklistarrayFull precon decklist — card names
commanderstringCommander card name
num_upgradesintegerNumber of upgrade suggestionsdefault: 10
response_formatstringOutput verbosity: 'detailed' (default) or 'concise'one of
detailed · concisedefault: detailedcolor_identity_staplesTop cards across ALL commanders in a color identity. Uses EDHREC aggregated data when available, falls back to EDHREC rank from bulk data.4 params
Top cards across ALL commanders in a color identity. Uses EDHREC aggregated data when available, falls back to EDHREC rank from bulk data.
Parameters* required
limitintegerMaximum number of resultsdefault: 20
categoryvalueCard category filter (e.g. 'creatures', 'instants', 'lands')
color_identitystringColor identity (e.g. 'sultai', 'BUG', 'WR', 'mono-red')
response_formatstringOutput verbosity: 'detailed' (default) or 'concise'one of
detailed · concisedefault: detailedsealed_pool_buildBuild 1-3 decks from a sealed pool using card quality and color pair analysis. Evaluates each 2-color pair, selects best cards, and suggests land splits. Uses 17Lands data when available for card quality scoring.3 params
Build 1-3 decks from a sealed pool using card quality and color pair analysis. Evaluates each 2-color pair, selects best cards, and suggests land splits. Uses 17Lands data when available for card quality scoring.
Parameters* required
poolarrayCard names in the sealed pool (typically 84-90)
set_codestringThree-letter set code (e.g. 'LCI', 'MKM')
response_formatstringOutput verbosity: 'detailed' (default) or 'concise'one of
detailed · concisedefault: detaileddraft_signal_readAnalyze draft picks and recommend a direction based on color signals. Uses ALSA data to detect which colors are open (cards seen later than expected = open).4 params
Analyze draft picks and recommend a direction based on color signals. Uses ALSA data to detect which colors are open (cards seen later than expected = open).
Parameters* required
picksarrayCards already drafted, in pick order
set_codestringThree-letter set code (e.g. 'LCI', 'MKM')
current_packvalueCurrent pack contents — if provided, cards are ranked with signal context
response_formatstringOutput verbosity: 'detailed' (default) or 'concise'one of
detailed · concisedefault: detaileddraft_log_reviewReview a completed draft — pick-by-pick GIH WR analysis and key decision points. Identifies where you could have taken a higher-WR card, pivot points, and overall draft grade.4 params
Review a completed draft — pick-by-pick GIH WR analysis and key decision points. Identifies where you could have taken a higher-WR card, pivot points, and overall draft grade.
Parameters* required
picksarrayCards drafted in order (pack 1 pick 1 through pack 3 pick 14)
set_codestringThree-letter set code (e.g. 'LCI', 'MKM')
final_deckvalueFinal deck submitted — enables 'made the deck' analysis
response_formatstringOutput verbosity: 'detailed' (default) or 'concise'one of
detailed · concisedefault: detailedrotation_checkCheck Standard rotation status and identify which cards are rotating. Shows sets currently in Standard with rotation dates. If cards provided, identifies which are in rotating sets and suggests replacements.2 params
Check Standard rotation status and identify which cards are rotating. Shows sets currently in Standard with rotation dates. If cards provided, identifies which are in rotating sets and suggests replacements.
Parameters* required
cardsvalueCard names to check for rotation — omit for general rotation info
response_formatstringOutput verbosity: 'detailed' (default) or 'concise'one of
detailed · concisedefault: detailedmetagame_snapshotGet the current metagame breakdown for a competitive format. Shows top archetypes with meta share %, tier classification, and prices. Uses MTGGoldfish as primary source with Spicerack tournament data as fallback.2 params
Get the current metagame breakdown for a competitive format. Shows top archetypes with meta share %, tier classification, and prices. Uses MTGGoldfish as primary source with Spicerack tournament data as fallback.
Parameters* required
formatstringCompetitive format (e.g. 'Modern', 'Legacy', 'Pioneer', 'Pauper')
response_formatstringOutput verbosity: 'detailed' (default) or 'concise'one of
detailed · concisedefault: detailedarchetype_decklistGet the stock decklist for a competitive archetype. Returns a full decklist (mainboard + sideboard) with deck metadata and total price when available. Archetype name is fuzzy-matched.3 params
Get the stock decklist for a competitive archetype. Returns a full decklist (mainboard + sideboard) with deck metadata and total price when available. Archetype name is fuzzy-matched.
Parameters* required
formatstringCompetitive format (e.g. 'Modern', 'Legacy', 'Pioneer', 'Pauper')
archetypestringArchetype name (e.g. 'Boros Energy', 'Mono-Blue Terror') — fuzzy matched
response_formatstringOutput verbosity: 'detailed' (default) or 'concise'one of
detailed · concisedefault: detailedarchetype_comparisonCompare 2-4 competitive archetypes side-by-side. Shows price, colors, key cards, shared staples, and differences.3 params
Compare 2-4 competitive archetypes side-by-side. Shows price, colors, key cards, shared staples, and differences.
Parameters* required
formatstringCompetitive format (e.g. 'Modern', 'Legacy', 'Pioneer', 'Pauper')
archetypesarray2-4 archetype names to compare (fuzzy matched)
response_formatstringOutput verbosity: 'detailed' (default) or 'concise'one of
detailed · concisedefault: detailedformat_entry_guideGet a beginner-oriented guide for entering a competitive format. Shows archetypes sorted by budget accessibility, cross-archetype staples (buy once, play everywhere), and format rules summary.3 params
Get a beginner-oriented guide for entering a competitive format. Shows archetypes sorted by budget accessibility, cross-archetype staples (buy once, play everywhere), and format rules summary.
Parameters* required
budgetvalueMax budget in USD — filters archetypes to this price ceiling
formatstringCompetitive format (e.g. 'Modern', 'Legacy', 'Pioneer', 'Pauper')
response_formatstringOutput verbosity: 'detailed' (default) or 'concise'one of
detailed · concisedefault: detailedsuggest_sideboardSuggest a 15-card sideboard for a competitive deck. Analyzes the main deck's weaknesses and recommends sideboard cards with per-card reasoning. Works with heuristic analysis alone; enhanced with MTGGoldfish frequency data when available.4 params
Suggest a 15-card sideboard for a competitive deck. Analyzes the main deck's weaknesses and recommends sideboard cards with per-card reasoning. Works with heuristic analysis alone; enhanced with MTGGoldfish frequency data when available.
Parameters* required
formatstringCompetitive format (e.g. 'Modern', 'Pauper')
decklistarrayMain deck card names (e.g. ['4 Lightning Bolt', '4 Goblin Guide'])
meta_contextvalueOptional context about local metagame (e.g. 'heavy on Mono-Red and Affinity')
response_formatstringOutput verbosity: 'detailed' (default) or 'concise'one of
detailed · concisedefault: detailedsideboard_guideGet a specific sideboard in/out plan for a named matchup. Given a full 75 and a matchup archetype, produces specific boarding instructions with reasoning.5 params
Get a specific sideboard in/out plan for a named matchup. Given a full 75 and a matchup archetype, produces specific boarding instructions with reasoning.
Parameters* required
formatstringCompetitive format (e.g. 'Modern', 'Pauper')
matchupstringMatchup archetype name (e.g. 'Mono-Red Aggro') — fuzzy matched
decklistarrayMain deck card names (e.g. ['4 Lightning Bolt', '4 Goblin Guide'])
sideboardarraySideboard card names (e.g. ['2 Hydroblast', '3 Tormod\'s Crypt'])
response_formatstringOutput verbosity: 'detailed' (default) or 'concise'one of
detailed · concisedefault: detailedsideboard_matrixGenerate a sideboard matrix for a deck across common matchups. Matrix shows which sideboard cards come IN/OUT/FLEX for each matchup. Auto-detects top matchups from metagame data or uses provided matchup list.5 params
Generate a sideboard matrix for a deck across common matchups. Matrix shows which sideboard cards come IN/OUT/FLEX for each matchup. Auto-detects top matchups from metagame data or uses provided matchup list.
Parameters* required
formatstringCompetitive format (e.g. 'Modern', 'Pauper')
decklistarrayMain deck card names (e.g. ['4 Lightning Bolt', '4 Goblin Guide'])
matchupsvalueMatchup names to include — omit to auto-detect from metagame data
sideboardarraySideboard card names (e.g. ['2 Hydroblast', '3 Tormod\'s Crypt'])
response_formatstringOutput verbosity: 'detailed' (default) or 'concise'one of
detailed · concisedefault: detaileddeck_validateValidate a decklist against a format's construction rules. Checks legality, deck size, copy limits, color identity (Commander), singleton rules, and Pauper rarity. Returns VALID or INVALID with actionable error messages.5 params
Validate a decklist against a format's construction rules. Checks legality, deck size, copy limits, color identity (Commander), singleton rules, and Pauper rarity. Returns VALID or INVALID with actionable error messages.
Parameters* required
formatstringFormat to validate against (e.g. 'commander', 'modern', 'standard', 'legacy')
decklistarrayCard names, optionally prefixed with quantity (e.g. '4x Lightning Bolt' or 'Lightning Bolt')
commandervalueCommander card name (required for Commander format)
sideboardvalueSideboard card names, same format as decklist
response_formatstringOutput verbosity: 'detailed' (default) or 'concise'one of
detailed · concisedefault: detailedsuggest_mana_baseSuggest a mana base for a decklist based on color pip distribution. Analyzes color requirements, recommends land count, and suggests format-legal dual lands. Handles hybrid and phyrexian mana.4 params
Suggest a mana base for a decklist based on color pip distribution. Analyzes color requirements, recommends land count, and suggests format-legal dual lands. Handles hybrid and phyrexian mana.
Parameters* required
formatstringFormat for land legality checking (e.g. 'commander', 'modern')
decklistarrayNon-land card names in the deck
total_landsvalueOverride total land count (default: auto-calculated from avg CMC)
response_formatstringOutput verbosity: 'detailed' (default) or 'concise'one of
detailed · concisedefault: detailedprice_comparisonCompare prices across multiple cards using Scryfall bulk data. Returns a markdown table with USD, USD foil, and EUR prices sorted by USD descending.2 params
Compare prices across multiple cards using Scryfall bulk data. Returns a markdown table with USD, USD foil, and EUR prices sorted by USD descending.
Parameters* required
cardsarray2-20 card names to compare prices
response_formatstringOutput verbosity: 'detailed' (default) or 'concise'one of
detailed · concisedefault: detailedrules_lookupLook up MTG Comprehensive Rules by number or keyword search. Returns matching rules with full text, parent context, and subrules.3 params
Look up MTG Comprehensive Rules by number or keyword search. Returns matching rules with full text, parent context, and subrules.
Parameters* required
querystringRule number (e.g. '704.5k') or keyword to search for
sectionvalueNarrow search to a section (e.g. 'combat', 'stack', 'lands', 'state-based')
response_formatstringOutput verbosity: 'detailed' (default) or 'concise'one of
detailed · concisedefault: detailedkeyword_explainExplain an MTG keyword with rules text, examples, and interactions. Returns the rules definition, reminder text, and up to 5 example cards from bulk data.2 params
Explain an MTG keyword with rules text, examples, and interactions. Returns the rules definition, reminder text, and up to 5 example cards from bulk data.
Parameters* required
keywordstringMTG keyword to explain (e.g. 'trample', 'deathtouch')
response_formatstringOutput verbosity: 'detailed' (default) or 'concise'one of
detailed · concisedefault: detailedrules_interactionExplain how two mechanics or cards interact under MTG rules. Returns relevant rules, step-by-step resolution, and common misconceptions.3 params
Explain how two mechanics or cards interact under MTG rules. Returns relevant rules, step-by-step resolution, and common misconceptions.
Parameters* required
mechanic_astringFirst mechanic or card name
mechanic_bstringSecond mechanic or card name
response_formatstringOutput verbosity: 'detailed' (default) or 'concise'one of
detailed · concisedefault: detailedrules_scenarioResolve a game scenario step-by-step using MTG rules. Covers priority, stack resolution, state-based actions, and triggers with rule citations.2 params
Resolve a game scenario step-by-step using MTG rules. Covers priority, stack resolution, state-based actions, and triggers with rule citations.
Parameters* required
scenariostringGame scenario to resolve (describe the board state and action)
response_formatstringOutput verbosity: 'detailed' (default) or 'concise'one of
detailed · concisedefault: detailedcombat_calculatorCalculate combat step-by-step with keyword interactions. Resolves declare attackers → declare blockers → damage steps → state-based actions. Looks up card keywords from bulk data if card names are provided.4 params
Calculate combat step-by-step with keyword interactions. Resolves declare attackers → declare blockers → damage steps → state-based actions. Looks up card keywords from bulk data if card names are provided.
Parameters* required
blockersarrayBlocking creature names or descriptions
keywordsvalueAdditional keyword abilities to consider (e.g. 'deathtouch', 'trample')
attackersarrayAttacking creature names or descriptions
response_formatstringOutput verbosity: 'detailed' (default) or 'concise'one of
detailed · concisedefault: detailedmtg-mcp-server
69 tools, 19 prompts, and 21 resources that give AI assistants deep access to Magic: The Gathering -- card data, combos, draft analytics, Commander metagame, competitive constructed, sideboard strategy, deck building, rules engine, and more. Works with Claude Code, Claude Desktop, or any MCP client.
Built on data from Scryfall, Commander Spellbook, 17Lands, EDHREC, Moxfield, Spicerack, and MTGGoldfish. See Data Sources & Attribution for details and usage terms.
Table of Contents
- What You Can Do — example prompts and real tool output
- Install — hosted, Claude Code, Claude Desktop, PyPI, development
- Configuration — environment variables and feature flags
- Tools — all 69 tools across 13 domains
- Architecture — FastMCP 3.x mount system
- Stack — Python 3.12+, FastMCP, httpx, Pydantic
- Development — mise commands for testing, linting, typechecking
- Documentation — cookbook, architecture, tool reference, and more
- Status — current tool/test counts
- Data Sources & Attribution — Scryfall, Spellbook, 17Lands, EDHREC, Moxfield, Spicerack, MTGGoldfish
What You Can Do
Ask your AI assistant questions like these and it will use the MTG tools automatically:
Commander
- "Show me everything about Muldrotha as a commander"
- "What are the best budget upgrades for my Atraxa deck under $5?"
- "Compare Muldrotha vs Meren vs Karador as graveyard commanders"
Draft & Limited
- "What are the best commons in Foundations for draft?"
- "Rank these cards for my draft pack: Bitter Triumph, Monstrous Rage, Torch the Tower"
- "Build a sealed deck from this pool: [list]"
Deck Building
- "Validate my Modern decklist"
- "Suggest a mana base for my 3-color Commander deck"
- "Find cards that synergize with sacrifice themes in Golgari"
Rules
- "How do deathtouch and trample interact?"
- "Resolve this combat scenario: my 3/3 with first strike blocks their 5/5 with trample"
Constructed
- "What does the Modern metagame look like right now?"
- "Show me the stock Boros Energy decklist for Modern"
- "Build me a sideboard for this Pioneer deck"
- "Give me a sideboard guide for my deck against Azorius Control"
See It in Action
"Compare Muldrotha, Meren, and Karador as graveyard commanders"
Muldrotha Meren Karador
Mana Cost {3}{B}{G}{U} {2}{B}{G} {5}{W}{B}{G}
Color Identity BGU (Sultai) BG (Golgari) BGW (Abzan)
Stats 6/6 3/4 3/4
EDHREC Rank #1,137 #1,476 #9,894
Total Decks 22,460 19,919 6,305
Combo Count 10 1 10
Top Staples:
Muldrotha Spore Frog (+53%), Sakura-Tribe Elder (+36%), Eternal Witness (+27%)
Meren Spore Frog (+70%), Sakura-Tribe Elder (+55%), Viscera Seer (+52%)
Karador Karmic Guide (+51%), Satyr Wayfinder (+49%), Sun Titan (+48%)
"What are the best commons in Foundations for draft?"
Foundations (FDN) — PremierDraft · Median GIH WR: 54.7%
Rank Card Color GIH WR ALSA IWD Games
1 Bake into a Pie B 58.4% 3.1 +5.3% 354,741
2 Burst Lightning R 58.2% 3.3 +3.0% 338,888
3 Refute U 58.1% 5.3 +4.3% 321,280
4 Stab B 57.9% 3.4 +4.5% 376,569
5 Dazzling Angel W 57.8% 3.2 +2.4% 317,648
Trap rares: Doubling Season (39.4%), Thousand-Year Storm (35.2%) ...
More examples with real tool output in the Cookbook.
Install
No API keys needed -- all data sources are public.
Hosted (zero setup)
The fastest way to get started. No Python install required. Works on mobile.
Via the UI (Claude Desktop or claude.ai): Settings → Connectors → Add custom connector → paste the URL:
https://mtg-mcp-server.fastmcp.app/mcp
Via config file (~/Library/Application Support/Claude/claude_desktop_config.json on macOS, %APPDATA%\Claude\claude_desktop_config.json on Windows):
{
"mcpServers": {
"mtg": {
"type": "url",
"url": "https://mtg-mcp-server.fastmcp.app/mcp"
}
}
}
Claude Code
claude mcp add mtg -- uvx mtg-mcp-server
Or via the UI: Settings → MCP Servers → Add server → enter uvx mtg-mcp-server as the command.
Claude Desktop (local)
Runs on your machine. Requires Python 3.12+.
{
"mcpServers": {
"mtg": {
"command": "uvx",
"args": ["mtg-mcp-server"]
}
}
}
PyPI
# Run directly (no install)
uvx mtg-mcp-server
# Install globally
uv tool install mtg-mcp-server
# Add to a project
uv add mtg-mcp-server
Development
git clone https://github.com/j4th/mtg-mcp-server.git
cd mtg-mcp-server
mise install # Installs Python 3.12, uv, ruff, ty
mise run setup # Creates venv, installs dependencies
uv run mtg-mcp-server # Run the server
Claude Code config for local development:
{
"mcpServers": {
"mtg": {
"command": "uv",
"args": ["run", "--directory", "/path/to/mtg-mcp-server", "mtg-mcp-server"]
}
}
}
Configuration
All settings use MTG_MCP_ environment variables. Everything works out of the box with sensible defaults.
# Feature flags for optional backends
MTG_MCP_ENABLE_EDHREC=false # EDHREC (scrapes undocumented endpoints)
MTG_MCP_ENABLE_17LANDS=false # 17Lands (rate-limits aggressively)
MTG_MCP_ENABLE_BULK_DATA=false # Scryfall bulk data (~30MB download on first use)
MTG_MCP_ENABLE_RULES=false # Comprehensive Rules engine
# Pass env vars through uvx
uvx --env MTG_MCP_ENABLE_EDHREC=false mtg-mcp-server
See .env.example for all available options including base URLs, rate limits, and cache settings.
Tools
69 tools across 13 domains. See docs/TOOL_DESIGN.md for full input/output details.
Card Data (scryfall_*)
| Tool | Description |
|---|---|
search_cards | Search using full Scryfall syntax (f:commander id:sultai t:creature) |
card_details | Full card data by exact or fuzzy name |
card_price | Current USD, EUR, and foil prices |
card_rulings | Official rulings and clarifications |
set_info | Set metadata by code |
whats_new | Recently released or previewed cards |
Bulk Data (bulk_*)
| Tool | Description |
|---|---|
card_lookup | Rate-limit-free card lookup by exact name |
card_search | Search by name, type, or oracle text |
format_legality | Check if a card is legal in a format |
format_search | Search for cards legal in a specific format |
format_staples | Top-played cards in a format by EDHREC rank |
ban_list | Banned and restricted cards for a format |
card_in_formats | Card legality across all formats |
random_card | Random card, optionally filtered by format or type |
similar_cards | Find cards similar by type, keywords, or mana cost |
Combos (spellbook_*)
| Tool | Description |
|---|---|
find_combos | Search for combos by card name and color identity |
combo_details | Step-by-step combo instructions by ID |
find_decklist_combos | Find combos present in a decklist |
estimate_bracket | Estimate Commander bracket for a decklist |
Draft Analytics (draft_*)
| Tool | Description |
|---|---|
card_ratings | Win rates and draft data for cards in a set (17Lands) |
archetype_stats | Win rates by color pair for a set |
Commander Metagame (edhrec_*)
| Tool | Description |
|---|---|
commander_staples | Most-played cards for a commander with synergy scores |
card_synergy | Synergy data for a card with a specific commander |
Decklists (moxfield_*)
| Tool | Description |
|---|---|
decklist | Fetch a full decklist by deck ID or URL |
deck_info | Deck metadata (name, format, author, dates) |
search_decks | Search public decks by format, keyword, or sort order |
user_decks | List a user's public decks |
Tournament Data (spicerack_*)
| Tool | Description |
|---|---|
recent_tournaments | Recent tournaments for a competitive format |
tournament_results | Full standings for a specific tournament |
format_decklists | Top-finishing decklists across recent tournaments |
Metagame (goldfish_*)
| Tool | Description |
|---|---|
metagame | Current metagame breakdown for a competitive format |
archetype_list | Sample decklist for an archetype |
format_staples | Most-played cards in a format with deck inclusion % |
deck_price | Estimated paper price for an archetype deck |
Commander Workflows
| Tool | Description |
|---|---|
commander_overview | Full commander profile from all sources |
evaluate_upgrade | Assess whether a card is worth adding to a deck |
card_comparison | Compare 2-5 cards side-by-side for a commander |
budget_upgrade | Budget-constrained upgrade suggestions ranked by synergy/$ |
commander_comparison | Compare 2-5 commanders head-to-head |
color_identity_staples | Top-played cards across all commanders in a color identity |
Deck Building
| Tool | Description |
|---|---|
theme_search | Find cards matching a mechanical or tribal theme |
build_around | Detect synergies from key cards and find complements |
complete_deck | Gap analysis and suggestions for a partial decklist |
tribal_staples | Best cards for a creature type in a color identity |
precon_upgrade | Analyze a precon and suggest swap pairs |
suggest_cuts | Identify the weakest cards to cut from a decklist |
deck_analysis | Full decklist health check (curve, colors, combos, budget) |
deck_validate | Validate a decklist against format construction rules |
suggest_mana_base | Suggest lands based on color pip distribution |
price_comparison | Compare prices across multiple cards |
Draft Workflows
| Tool | Description |
|---|---|
draft_pack_pick | Rank cards in a draft pack using 17Lands data |
set_overview | Top commons/uncommons and trap rares for a format |
sealed_pool_build | Suggest the best 40-card builds from a sealed pool |
draft_signal_read | Detect open colors from draft picks |
draft_log_review | Pick-by-pick review of a completed draft with grade |
Constructed Workflows
| Tool | Description |
|---|---|
rotation_check | Standard rotation status and rotating cards |
metagame_snapshot | Tiered metagame breakdown with prices |
archetype_decklist | Stock decklist for a competitive archetype |
archetype_comparison | Compare 2-4 archetypes side-by-side |
format_entry_guide | Beginner guide for entering a competitive format |
suggest_sideboard | 15-card sideboard suggestions for a deck |
sideboard_guide | In/out plan for a specific matchup |
sideboard_matrix | Sideboard matrix across common matchups |
Rules Engine
| Tool | Description |
|---|---|
rules_lookup | Look up rules by number or keyword |
keyword_explain | Explain a keyword with rules and example cards |
rules_interaction | How two mechanics interact with rule citations |
rules_scenario | Rules framework for a game scenario |
combat_calculator | Step-by-step combat phases with keyword interactions |
Architecture
Built on FastMCP 3.x. Each data source is an independent sub-server mounted into a single orchestrator:
MTG (orchestrator)
├── scryfall (namespace: scryfall_) -> Scryfall REST API
├── spellbook (namespace: spellbook_) -> Commander Spellbook API
├── draft (namespace: draft_) -> 17Lands data
├── edhrec (namespace: edhrec_) -> EDHREC (scraped, feature-flagged)
├── bulk (namespace: bulk_) -> Scryfall Oracle Cards bulk data
├── moxfield (namespace: moxfield_) -> Moxfield (reverse-engineered, feature-flagged)
├── spicerack (namespace: spicerack_) -> Spicerack tournament API
├── goldfish (namespace: goldfish_) -> MTGGoldfish (scraped, feature-flagged)
└── workflows (no namespace) -> 36 tools (31 composed + 5 rules)
Services are pure async API clients. Providers register MCP tools. Workflows compose across services with partial failure tolerance. See docs/ARCHITECTURE.md for the full picture.
Stack
| Runtime | Python 3.12+, uv |
| MCP | FastMCP 3.2.x |
| HTTP | httpx (async) |
| Validation | Pydantic v2 |
| Logging | structlog |
| Tooling | mise, ruff, ty (Astral) |
| Testing | pytest, respx, pytest-asyncio |
| HTML parsing | selectolax |
Development
git clone https://github.com/j4th/mtg-mcp-server.git
cd mtg-mcp-server
mise install # Installs Python, uv, ruff, ty
mise run setup # Creates venv, installs dependencies
mise run check # Full quality gate: lint + typecheck + tests
mise run check:quick # Fast gate: lint + typecheck + affected tests only
mise run test # All tests with coverage
mise run test:quick # Only tests affected by recent changes
mise run lint # ruff check + format check
mise run typecheck # ty check
mise run dev # MCP Inspector for interactive testing
mise run fix # Auto-fix lint and format issues
Documentation
| Doc | What it covers |
|---|---|
| COOKBOOK.md | Usage recipes -- Commander, draft, deck building, rules workflows |
| TOOL_DESIGN.md | Full reference for all 69 tools, 19 prompts, 21 resources |
| ARCHITECTURE.md | Technical architecture, FastMCP patterns, design decisions |
| SERVICE_CONTRACTS.md | API endpoints, rate limits, response shapes per backend |
| DATA_SOURCES.md | All data sources with auth, stability, and access patterns |
| CACHING_DESIGN.md | TTL cache strategy and Scryfall bulk data design |
| CONTRIBUTING.md | Development setup, TDD workflow, code style, PR process |
| CHANGELOG.md | Version history in Keep a Changelog format |
Status
69 tools, 19 prompts, 21 resource templates. 1340 tests at 88% coverage.
| Phase | What | Status |
|---|---|---|
| 0 | Project scaffold | Done |
| 1 | Scryfall backend (4 tools) | Done |
| 2 | Spellbook + 17Lands + EDHREC backends (9 tools) | Done |
| 3 | Workflow tools -- commander, draft, deck (4 tools) | Done |
| 4 | TTL caching + Scryfall bulk data provider (2 tools) | Done |
| 5 | Analysis & comparison workflows, prompts, resources (4 tools) | Done |
| Branch A | Structured output, rules engine, validation tools (17 tools) | Done |
| Branch B | Format workflows -- deck building, commander depth, limited, constructed (11 tools) | Done |
| Moxfield | Moxfield decklist provider (4 tools) | Done |
| Spicerack | Tournament results provider (3 tools) | Done |
| MTGGoldfish | Metagame data provider (4 tools) | Done |
| v2.3.0 | Metagame workflows, sideboard tools, Moxfield search (9 tools) | Done |
Data Sources & Attribution
This project composes data from multiple third-party services:
- Scryfall -- Card database, prices, rulings, search, bulk data (API guidelines)
- Commander Spellbook -- Combo search, bracket estimation (MIT license)
- 17Lands -- Draft card ratings, archetype win rates (usage guidelines)
- EDHREC -- Commander staples, synergy scores (undocumented endpoints, behind feature flag)
- Moxfield -- Public decklists and deck search (reverse-engineered API, behind feature flag)
- Spicerack -- Tournament results and standings (documented API)
- MTGGoldfish -- Competitive metagame data, archetypes, format staples (HTML scraping, behind feature flag)
See THIRD_PARTY_NOTICES.md for full license texts and usage terms.
Disclaimer
mtg-mcp-server is unofficial Fan Content permitted under the Fan Content Policy. Not approved/endorsed by Wizards. Portions of the materials used are property of Wizards of the Coast. © Wizards of the Coast LLC.
License
MIT -- see LICENSE
Featured
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →Configuration
MTG_MCP_TRANSPORTdefault: stdioServer transport — 'stdio' (default) or 'http'
MTG_MCP_HTTP_PORTdefault: 8000HTTP port when transport is 'http'
MTG_MCP_LOG_LEVELdefault: INFOLogging level — DEBUG, INFO, WARNING, or ERROR
MTG_MCP_ENABLE_17LANDSdefault: trueEnable 17Lands draft analytics backend
MTG_MCP_ENABLE_EDHRECdefault: trueEnable EDHREC commander metagame backend (uses undocumented endpoints)
MTG_MCP_ENABLE_BULK_DATAdefault: trueEnable Scryfall Oracle Cards bulk data for rate-limit-free lookups (~30 MB download)
MTG_MCP_SCRYFALL_RATE_LIMIT_MSdefault: 100Minimum delay between Scryfall API calls in milliseconds
MTG_MCP_BULK_DATA_REFRESH_HOURSdefault: 12Hours between Scryfall bulk data refreshes
MTG_MCP_ENABLE_RULESdefault: trueEnable Comprehensive Rules engine for rules lookup and keyword tools
MTG_MCP_DISABLE_CACHEdefault: falseDisable in-memory TTL caching (useful for testing)
MTG_MCP_ENABLE_MOXFIELDdefault: trueEnable Moxfield deck search and import backend (reverse-engineered API)
MTG_MCP_ENABLE_SPICERACKdefault: trueEnable Spicerack tournament results backend
MTG_MCP_ENABLE_MTGGOLDFISHdefault: trueEnable MTGGoldfish metagame data backend (HTML scraping)
Registryactive
Packagemtg-mcp-server
TransportSTDIO
UpdatedApr 4, 2026
