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. Its 40 documented tools cover card, format, staples, commander.

People connecting data & analytics tools to Claude, Cursor, VS Code, or another MCP client. The project is written in Python.

VERIFIED ACTIVE

LAST COMMIT 2026-06-24 · ★ 17 · #34 OF 75 MAINTAINED DATA & ANALYTICS · VERIFIED 2026-08-25

MIT · Python servers · how we verify → /methodology

01 · Install MTG MCP Server

before you install - you'll need

Set MTG_MCP_ENABLE_EDHREC, MTG_MCP_ENABLE_17LANDS, MTG_MCP_ENABLE_BULK_DATA, MTG_MCP_ENABLE_RULES before connecting.

Claude Code

claude mcp add j4th-mtg-mcp-server -- uvx mtg-mcp-server

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "j4th-mtg-mcp-server": {
      "command": "uvx",
      "args": [
        "mtg-mcp-server"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

pypi package mtg-mcp-server - check the name against the project README before installing (PyPI has no namespace ownership)

registry namespace io.github.j4th is GitHub-verified and matches the repo owner

03 · What MTG MCP Server can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can search using full Scryfall syntax (f:commander id:sultai t:creature), set metadata by code, search by name, type, or oracle text, and check if a card is legal in a format.

Capability map

Tools grouped from the project's README - what MTG MCP Server lets an agent do.

Card

10 tools - e.g. Full card data by exact or fuzzy name; Current USD, EUR, and foil prices; Official rulings and clarifications

card_details · card_price · card_rulings · card_lookup · card_search · card_in_formats…

Format

4 tools - e.g. Check if a card is legal in a format; Search for cards legal in a specific format; Top-played cards in a format by EDHREC rank

format_legality · format_search · format_staples · format_decklists

read & search

3 tools - e.g. Search using full Scryfall syntax (f:commander id:sultai t:creature); Search for combos by card name and color identity; Search public decks by format, keyword, or sort order

search_cards · find_combos · search_decks

Commander

3 tools - e.g. Most-played cards for a commander with synergy scores; Full commander profile from all sources; Compare 2-5 commanders head-to-head

commander_staples · commander_overview · commander_comparison

Decklist

2 tools - e.g. Find combos present in a decklist; Fetch a full decklist by deck ID or URL

find_decklist_combos · decklist

Archetype

2 tools - e.g. Win rates by color pair for a set; Sample decklist for an archetype

archetype_stats · archetype_list

Deck

2 tools - e.g. Deck metadata (name, format, author, dates); Estimated paper price for an archetype deck

deck_info · deck_price

update

1 tool - e.g. Set metadata by code

set_info

Latest releases

v3.0.0 · 2026-04-04

TL;DR · 69 tools now. Added competitive metagame tracking (MTGGoldfish + Spicerack), sideboard strategy tools, and Moxfield deck search. You can ask "what's the Modern metagame look like?" or "build me a sideboard for…

v2.2.0 · 2026-04-04

add Spicerack tournament results provider (#46) · add MTGGoldfish metagame provider with 4 tools · upgrade pygments >=2.20.0 to resolve CVE-2026-4539 · format-appropriate ranking for bulk_format_staples + docs TOC

v2.1.1 · 2026-04-03

add Moxfield public decklist provider · bump fastmcp 3.1.1 → 3.2.0, patch to v2.1.1

04 · Who maintains MTG MCP Server

MTG MCP Server is maintained by j4th. It's the only MCP server we track from this author; the repo dates to Mar 2026.

05 · Facts

repository: github.com/j4th/mtg-mcp-server
website: https://github.com/j4th/mtg-mcp-server
category: data & analytics - ranked #34 of 75 actively-maintained data & analytics servers as of 2026-08-25.
registry: io.github.j4th/mtg-mcp-server (active, first published 2026-03-24 · 12 versions)
packages: pypi:mtg-mcp-server

06 · MTG MCP Server FAQ

Is MTG MCP Server still maintained?

Yes - as of 2026-08-25, its last commit was 2026-06-24. We re-verify nightly.

What can MTG MCP Server do?

How do I install MTG MCP Server?

Run `uvx mtg-mcp-server`. The README documents 4 environment variables (MTG_MCP_ENABLE_EDHREC, MTG_MCP_ENABLE_17LANDS, MTG_MCP_ENABLE_BULK_DATA…) to set first. Set MTG_MCP_ENABLE_EDHREC, MTG_MCP_ENABLE_17LANDS, MTG_MCP_ENABLE_BULK_DATA, MTG_MCP_ENABLE_RULES before connecting. You can also paste the ready-made client config above.

Does MTG MCP Server run locally?

Yes - it's a stdio server: it runs on your machine (via uvx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to MTG MCP Server

Alternatives to MTG MCP Server

Maintained data & analytics servers if MTG MCP Server isn't the fit.

Pairs well with

Servers that cover what MTG MCP Server doesn't - only shown when the pairing reason fits the companion.

More data & analytics MCP servers · jDataMunch MCP · Keboola MCP Server · Dashboards · Reddit Growth MCP · Logly

More Python MCP servers · Nexus MCP · Aruba Email & Calendar · Memo · German Newsfeed MCP Server · Repo Graph · see all