MTG MCP Server

Name: MTG MCP Server
Author: j4th

by j4thversion 3.0.0i★ –iRuns on your computer

Registry nameio.github.j4th/mtg-mcp-server

Install

Overview

Description from the maker (original English)

Magic: The Gathering card search, combo lookup, draft analytics, and Commander tools.

PopNx MCP’s three pillars

These three are never merged into one score: opinions, measurements and popularity are different things.

User voiceiNo reviews yetReviews open together with accounts in a later step
Our basic checksi1 of 1 passedChecked from public information; code not scanned yet
UsageiNot measured yet★ –

What you can do with it

We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.

Connection: Runs on your computer
Transport: stdio
Category: Marketing & social media

Install

Pick the AI app you use, then copy the settings.

Before you install

Basic checks: 1 of 1 passed
Runs on your computer with your user’s permissions (files, network, apps).
You fill in yourself: MTG_MCP_TRANSPORT, MTG_MCP_HTTP_PORT, MTG_MCP_LOG_LEVEL, MTG_MCP_ENABLE_17LANDS, MTG_MCP_ENABLE_EDHREC, MTG_MCP_ENABLE_BULK_DATA, MTG_MCP_SCRYFALL_RATE_LIMIT_MS, MTG_MCP_BULK_DATA_REFRESH_HOURS, MTG_MCP_ENABLE_RULES, MTG_MCP_DISABLE_CACHE, MTG_MCP_ENABLE_MOXFIELD, MTG_MCP_ENABLE_SPICERACK, MTG_MCP_ENABLE_MTGGOLDFISH

You need

PyPIPython’s uv installed (for the uvx command)

Which app do you use?

ClaudeClaude CodeCursorVS CodeChatGPT

Pick your app above. We remember it, so next time the button says “Install in …”.

Open Claude Desktop → Settings → Developer → Edit Config, and paste this into claude_desktop_config.json

{
  "mcpServers": {
    "mtg": {
      "command": "uvx",
      "args": [
        "mtg-mcp-server"
      ],
      "env": {
        "MTG_MCP_TRANSPORT": "your-value",
        "MTG_MCP_HTTP_PORT": "your-value",
        "MTG_MCP_LOG_LEVEL": "your-value",
        "MTG_MCP_ENABLE_17LANDS": "your-value",
        "MTG_MCP_ENABLE_EDHREC": "your-value",
        "MTG_MCP_ENABLE_BULK_DATA": "your-value",
        "MTG_MCP_SCRYFALL_RATE_LIMIT_MS": "your-value",
        "MTG_MCP_BULK_DATA_REFRESH_HOURS": "your-value",
        "MTG_MCP_ENABLE_RULES": "your-value",
        "MTG_MCP_DISABLE_CACHE": "your-value",
        "MTG_MCP_ENABLE_MOXFIELD": "your-value",
        "MTG_MCP_ENABLE_SPICERACK": "your-value",
        "MTG_MCP_ENABLE_MTGGOLDFISH": "your-value"
      }
    }
  }
}

Run this in your terminal

claude mcp add mtg --env MTG_MCP_TRANSPORT=your-value --env MTG_MCP_HTTP_PORT=your-value --env MTG_MCP_LOG_LEVEL=your-value --env MTG_MCP_ENABLE_17LANDS=your-value --env MTG_MCP_ENABLE_EDHREC=your-value --env MTG_MCP_ENABLE_BULK_DATA=your-value --env MTG_MCP_SCRYFALL_RATE_LIMIT_MS=your-value --env MTG_MCP_BULK_DATA_REFRESH_HOURS=your-value --env MTG_MCP_ENABLE_RULES=your-value --env MTG_MCP_DISABLE_CACHE=your-value --env MTG_MCP_ENABLE_MOXFIELD=your-value --env MTG_MCP_ENABLE_SPICERACK=your-value --env MTG_MCP_ENABLE_MTGGOLDFISH=your-value -- uvx mtg-mcp-server

Fill in the empty values before running it.

Open in Cursor

Or copy the settings yourself

Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json

{
  "mcpServers": {
    "mtg": {
      "command": "uvx",
      "args": [
        "mtg-mcp-server"
      ],
      "env": {
        "MTG_MCP_TRANSPORT": "your-value",
        "MTG_MCP_HTTP_PORT": "your-value",
        "MTG_MCP_LOG_LEVEL": "your-value",
        "MTG_MCP_ENABLE_17LANDS": "your-value",
        "MTG_MCP_ENABLE_EDHREC": "your-value",
        "MTG_MCP_ENABLE_BULK_DATA": "your-value",
        "MTG_MCP_SCRYFALL_RATE_LIMIT_MS": "your-value",
        "MTG_MCP_BULK_DATA_REFRESH_HOURS": "your-value",
        "MTG_MCP_ENABLE_RULES": "your-value",
        "MTG_MCP_DISABLE_CACHE": "your-value",
        "MTG_MCP_ENABLE_MOXFIELD": "your-value",
        "MTG_MCP_ENABLE_SPICERACK": "your-value",
        "MTG_MCP_ENABLE_MTGGOLDFISH": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

Open in VS Code

Or copy the settings yourself

Paste into .vscode/mcp.json in your project

{
  "servers": {
    "mtg": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mtg-mcp-server"
      ],
      "env": {
        "MTG_MCP_TRANSPORT": "your-value",
        "MTG_MCP_HTTP_PORT": "your-value",
        "MTG_MCP_LOG_LEVEL": "your-value",
        "MTG_MCP_ENABLE_17LANDS": "your-value",
        "MTG_MCP_ENABLE_EDHREC": "your-value",
        "MTG_MCP_ENABLE_BULK_DATA": "your-value",
        "MTG_MCP_SCRYFALL_RATE_LIMIT_MS": "your-value",
        "MTG_MCP_BULK_DATA_REFRESH_HOURS": "your-value",
        "MTG_MCP_ENABLE_RULES": "your-value",
        "MTG_MCP_DISABLE_CACHE": "your-value",
        "MTG_MCP_ENABLE_MOXFIELD": "your-value",
        "MTG_MCP_ENABLE_SPICERACK": "your-value",
        "MTG_MCP_ENABLE_MTGGOLDFISH": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

This one runs on your computer, and ChatGPT can only connect to servers on the internet. Pick another app.

Your choice stays on this device in a cookie; no account needed.

Values you fill in

MTG_MCP_TRANSPORT env
Server transport — 'stdio' (default) or 'http'
MTG_MCP_HTTP_PORT env
HTTP port when transport is 'http'
MTG_MCP_LOG_LEVEL env
Logging level — DEBUG, INFO, WARNING, or ERROR
MTG_MCP_ENABLE_17LANDS env
Enable 17Lands draft analytics backend
MTG_MCP_ENABLE_EDHREC env
Enable EDHREC commander metagame backend (uses undocumented endpoints)
MTG_MCP_ENABLE_BULK_DATA env
Enable Scryfall Oracle Cards bulk data for rate-limit-free lookups (~30 MB download)
MTG_MCP_SCRYFALL_RATE_LIMIT_MS env
Minimum delay between Scryfall API calls in milliseconds
MTG_MCP_BULK_DATA_REFRESH_HOURS env
Hours between Scryfall bulk data refreshes
MTG_MCP_ENABLE_RULES env
Enable Comprehensive Rules engine for rules lookup and keyword tools
MTG_MCP_DISABLE_CACHE env
Disable in-memory TTL caching (useful for testing)
MTG_MCP_ENABLE_MOXFIELD env
Enable Moxfield deck search and import backend (reverse-engineered API)
MTG_MCP_ENABLE_SPICERACK env
Enable Spicerack tournament results backend
MTG_MCP_ENABLE_MTGGOLDFISH env
Enable MTGGoldfish metagame data backend (HTML scraping)

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

What it can do

Runs on your computer; the tool list appears in your AI app after you install it.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 7, 2026

✓ Pass
Maker matches the repo
The registry name was verified with the GitHub account j4th, which owns the repo
… Not checked yet
Still maintained
We have not read this repo from GitHub yet
… Not checked yet
Has a licence
We have not read this repo from GitHub yet
– Not applicable
Endpoint responds
This one runs on your computer; there is no internet endpoint
– Not applicable
Sign-in with OAuth
Runs on your computer and uses local settings instead
… Not checked yet
No hidden instructions in tool descriptions
Runs on your computer; we can only read tool lists from internet endpoints

Compared with others in Marketing & social mediai

More stars than 0% of the other 2980 servers in this category
Published to the registry more recently than 5% of the other 2980 servers in this category
Basic checks equal to or better than 100% of the other 2980 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is MTG MCP Server safe?

It passed 1 of 1 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

The registry does not list a required key, though some servers ask you to sign in on first use.

Does it run on my computer or in the cloud?

It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).

Is it still maintained?

The GitHub repo last changed –, and the latest version (3.0.0) reached the registry 7 months ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Python (uv) on your computer.

What can I use instead?

In the same category: MCP YouTube Transcript, Google Analytics MCP, BibiGPT YouTube Video Summarizer

Alternatives

Servers in the same category from other makers, sorted by stars.

Reading a card:★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

MCP YouTube Transcript

by jkawamoto

An MCP server retrieving transcripts of YouTube videos

Runs on your computer★ 495MITUpdated 10 days ago

Install

Google Analytics MCP

by surendranb

GA4 MCP server for AI agents: schema discovery, server-side aggregation, analysis-ready defaults.

Runs on your computer★ 244MITUpdated 10 days ago

Install

BibiGPT YouTube Video Summarizer

by JimmyLv

AI video summarizer: summarize and transcribe YouTube, Bilibili, TikTok and podcast videos.

Runs in the cloud★ 137MITUpdated 10 days ago

Install

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

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.

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 dra

Only the beginning is shown; read the rest in the repo

MTG MCP Server

Overview

PopNx MCP’s three pillars

What you can do with it

Install

Before you install

Values you fill in

What it can do

Basic checksi

Maker matches the repo

Still maintained

Has a licence

Endpoint responds

Sign-in with OAuth

No hidden instructions in tool descriptions

Compared with others in Marketing & social mediai

Common questions

Alternatives

MCP YouTube Transcript

Google Analytics MCP

BibiGPT YouTube Video Summarizer

README from the maker

mtg-mcp-server

Table of Contents

What You Can Do

See It in Action

Install

Hosted (zero setup)

Claude Code

Claude Desktop (local)

PyPI

Install globally

Add to a project

Development

Configuration

Pass env vars through uvx

Tools

Card Data (scryfall_*)

Bulk Data (bulk_*)

Combos (spellbook_*)

Draft Analytics (draft_*)

Commander Metagame (edhrec_*)

Decklists (moxfield_*)

Tournament Data (spicerack_*)

Metagame (goldfish_*)

Commander Workflows

Deck Building

Draft Workflows

Card Data (`scryfall_*`)

Bulk Data (`bulk_*`)

Combos (`spellbook_*`)

Draft Analytics (`draft_*`)

Commander Metagame (`edhrec_*`)

Decklists (`moxfield_*`)

Tournament Data (`spicerack_*`)

Metagame (`goldfish_*`)