Skip to content
MCP server

MTG MCP Server

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

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
3.0.0
Listing updated
5 days ago

About MTG MCP Server

MTG MCP Server is an open-source MCP server. It runs locally on your machine and is started by your AI client.

Install

Run in a terminal

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

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mtg-mcp-server": {
      "command": "uvx",
      "args": [
        "mtg-mcp-server"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mtg-mcp-server": {
      "command": "uvx",
      "args": [
        "mtg-mcp-server"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "mtg-mcp-server": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mtg-mcp-server"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Configuration

  • MTG_MCP_TRANSPORTServer transport — 'stdio' (default) or 'http'
  • MTG_MCP_HTTP_PORTHTTP port when transport is 'http'
  • MTG_MCP_LOG_LEVELLogging level — DEBUG, INFO, WARNING, or ERROR
  • MTG_MCP_ENABLE_17LANDSEnable 17Lands draft analytics backend
  • MTG_MCP_ENABLE_EDHRECEnable EDHREC commander metagame backend (uses undocumented endpoints)
  • MTG_MCP_ENABLE_BULK_DATAEnable Scryfall Oracle Cards bulk data for rate-limit-free lookups (~30 MB download)
  • MTG_MCP_SCRYFALL_RATE_LIMIT_MSMinimum delay between Scryfall API calls in milliseconds
  • MTG_MCP_BULK_DATA_REFRESH_HOURSHours between Scryfall bulk data refreshes
  • MTG_MCP_ENABLE_RULESEnable Comprehensive Rules engine for rules lookup and keyword tools
  • MTG_MCP_DISABLE_CACHEDisable in-memory TTL caching (useful for testing)
  • MTG_MCP_ENABLE_MOXFIELDEnable Moxfield deck search and import backend (reverse-engineered API)
  • MTG_MCP_ENABLE_SPICERACKEnable Spicerack tournament results backend
  • MTG_MCP_ENABLE_MTGGOLDFISHEnable MTGGoldfish metagame data backend (HTML scraping)

Pricing

Open source

MTG MCP Server FAQ

Is MTG MCP Server free?

Yes. MTG MCP Server is open source, so you can use and self-host it for free.

How do I add MTG MCP Server to Claude Code?

Run this command in your terminal: claude mcp add mtg-mcp-server -- uvx mtg-mcp-server

Where this comes from

  • Description: from the official MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers