MCP Server

MTG MCP Server MCP Server

Name: MTG MCP Server MCP Server
Author: io.github.j4th

io.github.j4th/mtg-mcp-server

Repository Registry

What is the MTG MCP Server MCP server?

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

How to install MTG MCP Server

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

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

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mtg-mcp-server": {
      "command": "uvx",
      "args": [
        "mtg-mcp-server"
      ],
      "env": {
        "MTG_MCP_TRANSPORT": "<YOUR_MTG_MCP_TRANSPORT>",
        "MTG_MCP_HTTP_PORT": "<YOUR_MTG_MCP_HTTP_PORT>",
        "MTG_MCP_LOG_LEVEL": "<YOUR_MTG_MCP_LOG_LEVEL>",
        "MTG_MCP_ENABLE_17LANDS": "<YOUR_MTG_MCP_ENABLE_17LANDS>",
        "MTG_MCP_ENABLE_EDHREC": "<YOUR_MTG_MCP_ENABLE_EDHREC>",
        "MTG_MCP_ENABLE_BULK_DATA": "<YOUR_MTG_MCP_ENABLE_BULK_DATA>",
        "MTG_MCP_SCRYFALL_RATE_LIMIT_MS": "<YOUR_MTG_MCP_SCRYFALL_RATE_LIMIT_MS>",
        "MTG_MCP_BULK_DATA_REFRESH_HOURS": "<YOUR_MTG_MCP_BULK_DATA_REFRESH_HOURS>",
        "MTG_MCP_ENABLE_RULES": "<YOUR_MTG_MCP_ENABLE_RULES>",
        "MTG_MCP_DISABLE_CACHE": "<YOUR_MTG_MCP_DISABLE_CACHE>",
        "MTG_MCP_ENABLE_MOXFIELD": "<YOUR_MTG_MCP_ENABLE_MOXFIELD>",
        "MTG_MCP_ENABLE_SPICERACK": "<YOUR_MTG_MCP_ENABLE_SPICERACK>",
        "MTG_MCP_ENABLE_MTGGOLDFISH": "<YOUR_MTG_MCP_ENABLE_MTGGOLDFISH>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "mtg-mcp-server": {
      "command": "uvx",
      "args": [
        "mtg-mcp-server"
      ],
      "env": {
        "MTG_MCP_TRANSPORT": "<YOUR_MTG_MCP_TRANSPORT>",
        "MTG_MCP_HTTP_PORT": "<YOUR_MTG_MCP_HTTP_PORT>",
        "MTG_MCP_LOG_LEVEL": "<YOUR_MTG_MCP_LOG_LEVEL>",
        "MTG_MCP_ENABLE_17LANDS": "<YOUR_MTG_MCP_ENABLE_17LANDS>",
        "MTG_MCP_ENABLE_EDHREC": "<YOUR_MTG_MCP_ENABLE_EDHREC>",
        "MTG_MCP_ENABLE_BULK_DATA": "<YOUR_MTG_MCP_ENABLE_BULK_DATA>",
        "MTG_MCP_SCRYFALL_RATE_LIMIT_MS": "<YOUR_MTG_MCP_SCRYFALL_RATE_LIMIT_MS>",
        "MTG_MCP_BULK_DATA_REFRESH_HOURS": "<YOUR_MTG_MCP_BULK_DATA_REFRESH_HOURS>",
        "MTG_MCP_ENABLE_RULES": "<YOUR_MTG_MCP_ENABLE_RULES>",
        "MTG_MCP_DISABLE_CACHE": "<YOUR_MTG_MCP_DISABLE_CACHE>",
        "MTG_MCP_ENABLE_MOXFIELD": "<YOUR_MTG_MCP_ENABLE_MOXFIELD>",
        "MTG_MCP_ENABLE_SPICERACK": "<YOUR_MTG_MCP_ENABLE_SPICERACK>",
        "MTG_MCP_ENABLE_MTGGOLDFISH": "<YOUR_MTG_MCP_ENABLE_MTGGOLDFISH>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mtg-mcp-server": {
      "command": "uvx",
      "args": [
        "mtg-mcp-server"
      ],
      "env": {
        "MTG_MCP_TRANSPORT": "<YOUR_MTG_MCP_TRANSPORT>",
        "MTG_MCP_HTTP_PORT": "<YOUR_MTG_MCP_HTTP_PORT>",
        "MTG_MCP_LOG_LEVEL": "<YOUR_MTG_MCP_LOG_LEVEL>",
        "MTG_MCP_ENABLE_17LANDS": "<YOUR_MTG_MCP_ENABLE_17LANDS>",
        "MTG_MCP_ENABLE_EDHREC": "<YOUR_MTG_MCP_ENABLE_EDHREC>",
        "MTG_MCP_ENABLE_BULK_DATA": "<YOUR_MTG_MCP_ENABLE_BULK_DATA>",
        "MTG_MCP_SCRYFALL_RATE_LIMIT_MS": "<YOUR_MTG_MCP_SCRYFALL_RATE_LIMIT_MS>",
        "MTG_MCP_BULK_DATA_REFRESH_HOURS": "<YOUR_MTG_MCP_BULK_DATA_REFRESH_HOURS>",
        "MTG_MCP_ENABLE_RULES": "<YOUR_MTG_MCP_ENABLE_RULES>",
        "MTG_MCP_DISABLE_CACHE": "<YOUR_MTG_MCP_DISABLE_CACHE>",
        "MTG_MCP_ENABLE_MOXFIELD": "<YOUR_MTG_MCP_ENABLE_MOXFIELD>",
        "MTG_MCP_ENABLE_SPICERACK": "<YOUR_MTG_MCP_ENABLE_SPICERACK>",
        "MTG_MCP_ENABLE_MTGGOLDFISH": "<YOUR_MTG_MCP_ENABLE_MTGGOLDFISH>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "mtg-mcp-server": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mtg-mcp-server"
      ],
      "env": {
        "MTG_MCP_TRANSPORT": "<YOUR_MTG_MCP_TRANSPORT>",
        "MTG_MCP_HTTP_PORT": "<YOUR_MTG_MCP_HTTP_PORT>",
        "MTG_MCP_LOG_LEVEL": "<YOUR_MTG_MCP_LOG_LEVEL>",
        "MTG_MCP_ENABLE_17LANDS": "<YOUR_MTG_MCP_ENABLE_17LANDS>",
        "MTG_MCP_ENABLE_EDHREC": "<YOUR_MTG_MCP_ENABLE_EDHREC>",
        "MTG_MCP_ENABLE_BULK_DATA": "<YOUR_MTG_MCP_ENABLE_BULK_DATA>",
        "MTG_MCP_SCRYFALL_RATE_LIMIT_MS": "<YOUR_MTG_MCP_SCRYFALL_RATE_LIMIT_MS>",
        "MTG_MCP_BULK_DATA_REFRESH_HOURS": "<YOUR_MTG_MCP_BULK_DATA_REFRESH_HOURS>",
        "MTG_MCP_ENABLE_RULES": "<YOUR_MTG_MCP_ENABLE_RULES>",
        "MTG_MCP_DISABLE_CACHE": "<YOUR_MTG_MCP_DISABLE_CACHE>",
        "MTG_MCP_ENABLE_MOXFIELD": "<YOUR_MTG_MCP_ENABLE_MOXFIELD>",
        "MTG_MCP_ENABLE_SPICERACK": "<YOUR_MTG_MCP_ENABLE_SPICERACK>",
        "MTG_MCP_ENABLE_MTGGOLDFISH": "<YOUR_MTG_MCP_ENABLE_MTGGOLDFISH>"
      }
    }
  }
}

Claude Code

claude mcp add mtg-mcp-server --env MTG_MCP_TRANSPORT=<YOUR_MTG_MCP_TRANSPORT> --env MTG_MCP_HTTP_PORT=<YOUR_MTG_MCP_HTTP_PORT> --env MTG_MCP_LOG_LEVEL=<YOUR_MTG_MCP_LOG_LEVEL> --env MTG_MCP_ENABLE_17LANDS=<YOUR_MTG_MCP_ENABLE_17LANDS> --env MTG_MCP_ENABLE_EDHREC=<YOUR_MTG_MCP_ENABLE_EDHREC> --env MTG_MCP_ENABLE_BULK_DATA=<YOUR_MTG_MCP_ENABLE_BULK_DATA> --env MTG_MCP_SCRYFALL_RATE_LIMIT_MS=<YOUR_MTG_MCP_SCRYFALL_RATE_LIMIT_MS> --env MTG_MCP_BULK_DATA_REFRESH_HOURS=<YOUR_MTG_MCP_BULK_DATA_REFRESH_HOURS> --env MTG_MCP_ENABLE_RULES=<YOUR_MTG_MCP_ENABLE_RULES> --env MTG_MCP_DISABLE_CACHE=<YOUR_MTG_MCP_DISABLE_CACHE> --env MTG_MCP_ENABLE_MOXFIELD=<YOUR_MTG_MCP_ENABLE_MOXFIELD> --env MTG_MCP_ENABLE_SPICERACK=<YOUR_MTG_MCP_ENABLE_SPICERACK> --env MTG_MCP_ENABLE_MTGGOLDFISH=<YOUR_MTG_MCP_ENABLE_MTGGOLDFISH> -- uvx mtg-mcp-server