MTG MCP Server
by j4thio.github.j4th/mtg-mcp-serverv3.0.0
Magic: The Gathering card search, combo lookup, draft analytics, and Commander tools.
context tax
queued
security
queued
cold start
queued
freshness
Stale6mo ago
Install MTG MCP server
Install in Claude Code
claude mcp add mtg -- uvx mtg-mcp-serverInstall in Cursor
{
"mcpServers": {
"mtg": {
"command": "uvx",
"args": [
"mtg-mcp-server"
]
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"mtg": {
"command": "uvx",
"args": [
"mtg-mcp-server"
]
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"mtg": {
"type": "stdio",
"command": "uvx",
"args": [
"mtg-mcp-server"
]
}
}
}Add to .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"mtg": {
"command": "uvx",
"args": [
"mtg-mcp-server"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| 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) |
Freshness
Stale — last maintenance signal 6mo ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-04-04 · 6mo ago · GitHub
Latest release
2026-04-04 · 6mo ago · GitHub · v3.0.0
Package published
no data · npm/PyPI
Registry entry updated
2026-04-04 · 6mo ago · official registry · v3.0.0
FAQ
›How do I install the MTG MCP server in Claude Code?
Run: claude mcp add mtg -- uvx mtg-mcp-server. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does MTG require an API key?
No required environment variables are declared in its published metadata.
›Can I use MTG as a remote (hosted) MCP server?
No hosted endpoint is published; it runs locally over stdio.
›Is MTG in the official MCP registry?
Yes, as io.github.j4th/mtg-mcp-server.
Alternatives to MTG
Other data & analytics MCP servers.