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"

                    

... [View full README on GitHub](https://github.com/j4th/mtg-mcp-server#readme)