MTG MCP Server
io.github.j4th/mtg-mcp-server·v3.0.0·20 starsMagic: The Gathering card search, combo lookup, draft analytics, and Commander tools.
20 stars49 downloads/wk
Reviews
Write oneNobody has reviewed MTG MCP Server yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
MTG MCP Server tools (68)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
archetype_comparisonCompare 2-4 competitive archetypes side-by-side.
archetype_decklistGet the stock decklist for a competitive archetype.
archetype_listGet a sample decklist for an archetype in a format.
archetype_statsGet win rates by color pair/archetype for a draft set.
ban_listGet the banned and restricted cards for a format.
budget_upgradeSuggest budget-friendly upgrades for a commander deck.
build_aroundFind synergistic cards for 1-5 build-around cards in any format.
card_comparisonCompare 2-5 cards side-by-side for a specific commander deck.
card_detailsGet full details for a Magic card by exact or fuzzy name.
card_in_formatsShow a card's legality across all Magic formats.
card_lookupLook up a Magic card by exact name using Scryfall bulk data.
card_priceGet current prices for a Magic card. Prices update once per day.
card_ratingsGet win rate and draft performance data for cards in a set.
card_rulingsGet official rulings and clarifications for a Magic card.
card_searchSearch for Magic cards in Scryfall bulk data.
card_synergyGet synergy data for a specific card with a specific commander.
color_identity_staplesTop cards across ALL commanders in a color identity.
combat_calculatorCalculate combat step-by-step with keyword interactions.
combo_detailsGet detailed steps for a specific combo by its Spellbook ID.
commander_comparisonCompare 2-5 commanders head-to-head: stats, combos, staples, popularity.
commander_overviewComprehensive commander profile combining data from all available sources.
commander_staplesGet the most-played cards for a commander with synergy scores and inclusion rates.
complete_deckIdentify gaps in a partial decklist and suggest cards to fill them.
deck_analysisFull decklist health check — mana curve, colors, combos, bracket, budget, synergy.
deck_infoGet metadata for a Moxfield deck (name, format, author, dates).
deck_priceGet the estimated paper price for an archetype deck.
deck_validateValidate a decklist against a format's construction rules.
decklistFetch a full decklist from Moxfield by deck ID or URL.
draft_log_reviewReview a completed draft — pick-by-pick GIH WR analysis and key decision points.
draft_pack_pickRank cards in a draft pack using 17Lands win rate data.
draft_signal_readAnalyze draft picks and recommend a direction based on color signals.
estimate_bracketEstimate the Commander bracket (power level) for a decklist.
evaluate_upgradeAssess whether a card is worth adding to a specific commander deck.
find_combosSearch for known combos involving a specific card.
find_decklist_combosFind combos present in (or nearly present in) a Commander decklist.
format_decklistsFind top-performing decklists across recent tournaments for a format.
format_entry_guideGet a beginner-oriented guide for entering a competitive format.
format_legalityBatch legality check for cards in a specific format.
format_searchSearch for legal cards in a specific format using natural language.
format_staplesGet the most-played cards in a format with deck inclusion percentages.
keyword_explainExplain an MTG keyword with rules text, examples, and interactions.
metagameGet the current metagame breakdown for a competitive format.
metagame_snapshotGet the current metagame breakdown for a competitive format.
pingHealth check — returns 'pong'.
precon_upgradeAnalyze and upgrade a Commander precon — identify weakest cards, suggest replacements.
price_comparisonCompare prices across multiple cards using Scryfall bulk data.
random_cardGet a random Magic card, optionally filtered by format, color, type, and rarity.
recent_tournamentsList recent tournaments for a format with dates, player counts, and IDs.
rotation_checkCheck Standard rotation status and identify which cards are rotating.
rules_interactionExplain how two mechanics or cards interact under MTG rules.
rules_lookupLook up MTG Comprehensive Rules by number or keyword search.
rules_scenarioResolve a game scenario step-by-step using MTG rules.
sealed_pool_buildBuild 1-3 decks from a sealed pool using card quality and color pair analysis.
search_cardsSearch for Magic cards using Scryfall syntax.
search_decksSearch public Moxfield decks by format, keyword, or sort order.
set_infoGet metadata for a Magic set by its code.
set_overviewDraft format overview — top commons/uncommons and trap rares.
sideboard_guideGet a specific sideboard in/out plan for a named matchup.
sideboard_matrixGenerate a sideboard matrix for a deck across common matchups.
similar_cardsFind cards similar to a given card.
suggest_cutsIdentify the weakest cards to cut from a commander decklist.
suggest_mana_baseSuggest a mana base for a decklist based on color pip distribution.
suggest_sideboardSuggest a 15-card sideboard for a competitive deck.
theme_searchFind cards matching a theme — mechanical, tribal, or abstract/flavorful.
tournament_resultsGet full standings and decklists for a specific tournament.
tribal_staplesBest cards for a creature type — lords, synergy pieces, and top members.
user_decksList a user's public decks on Moxfield.
whats_newFind recently printed or released Magic cards.
Public scan report
scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it
- Code scan54 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitylocal package, no credentials required12/15
- Maintenancelast push 96 days ago8/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How MTG MCP Server compares
Against every graded Web search MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 82/100
- higher than 68% of 3,470 Web search servers
- Tools
- 68
- the typical Web search server has 5
- Tools that change things
- 0%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 20
- more than 89% of 1,786 Web search servers
- Downloads a week
- 49
- more than 34% of 827 Web search servers with a package
What its tools let an agent do: 65 read · 2 change · 1 run or deploy
Install MTG MCP Server in Claude Code, Cursor or VS Code
claude mcp add mtg-mcp-server -- uvx mtg-mcp-server
What the publisher says
From the MTG MCP Server repository's README, as published. We do not edit it. Read it on GitHub
<!-- mcp-name: io.github.j4th/mtg-mcp-server -->
mtg-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"
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
MTG MCP Server: common questions
- Is MTG MCP Server safe?
- Mostly: it is graded B (82/100). Read the MTG MCP Server safety report
- How do I install MTG MCP Server?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does MTG MCP Server need an API key?
- No secret keys are declared. It reads 13 settings from the environment.
- Is MTG MCP Server maintained?
- The last commit was 133 days ago (2026-06-24). The latest release is v3.0.0.
- How does MTG MCP Server compare with other Web search MCP servers?
- safety score 82/100 (higher than 68% of 3,470 Web search servers); tools 68 (the typical Web search server has 5); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.