dccoder/mtg-mcp repository overview

⁠MTGMCP

This is a simple MCP server for the Scryfall⁠ to assist with card data and deck building. This allows clients such as Claude Desktop⁠ to search for Magic: The Gathering card details using the Scryfall API.

⁠Description

This server exposes a number of MCP tools to assist with MTG card search and deck building. The tools and their purposes are listed below.

⁠Tools

⁠search_card_by_name

This tool takes a card name as input, queries the Scryfall API for cards matching that exact name, and returns the details of the found card(s) in a structured format.

⁠search_card_by_color

This tool takes a card color as input, queries the Scryfall API for cards with that color, and returns the details of the found card(s) in a structured format.

⁠search_card_by_text

This tool takes a card's text as input, queries the Scryfall API for cards with that text or similar text, and returns the details of the found card(s) in a structured format.

⁠find_related_cards

This tool finds cards related to a specified card through various relationship types:

• Reprints: Other printings of the same card
• Tokens: Token cards created by the card
• Mechanics: Cards sharing similar keyword abilities
• Same Set: Other cards from the same expansion

⁠find_card_synergies

This advanced tool analyzes a card and finds synergistic cards for deck building:

• Keyword Synergies: Cards sharing keyword abilities (flying, trample, etc.)
• Theme Synergies: Cards fitting strategic themes (sacrifice, tokens, graveyard, counters, etc.)
• Tribal Synergies: Cards sharing creature types
• Color Identity: Cards matching color requirements

The tool automatically extracts themes from card text.

⁠Installation

⁠Download Pre-built Binaries

Pre-built binaries are available for Windows, Linux on the Releases page⁠.

⁠Available Platforms:

• Windows: mtg-mcp-windows-amd64.zip (x64) / mtg-mcp-windows-arm64.zip (ARM64)
• Linux: mtg-mcp-linux-amd64.tar.gz (x64) / mtg-mcp-linux-arm64.tar.gz (ARM64)

⁠Installation Steps:

Windows:

1. Download the appropriate .zip file for your architecture
2. Extract the archive to your desired location

Linux:

1. Download the appropriate .tar.gz file for your architecture
2. Extract: tar -xzf mtg-mcp-*.tar.gz
3. Make executable: chmod +x mtg-mcp-*

⁠Development

⁠Prerequisites

• Go programming language (version 1.24 or later recommended for go-sdk)

⁠Building

1. Navigate to the src/ directory:

   cd src
   

   Copy
2. Ensure dependencies are downloaded:

   go mod tidy
   

   Copy
3. Build the executable:

   go build .
   

   Copy

⁠Running the Server

The server supports two communication transports⁠:

• STDIO: For local execution and SSH-tunneled remote access
• SSE: For remote HTTP/HTTPS access over the internet

⁠Local Execution (STDIO Mode)

Execute the compiled binary from your terminal:

.\mtg-mcp-windows-amd64.exe

⁠Remote HTTP Access

For remote access over the internet, run with SSE transport:

# Linux
MCP_TRANSPORT=sse MCP_SSE_PORT=3000 ./mtg-mcp-linux-amd64

# Windows
$env:MCP_TRANSPORT="sse"; $env:MCP_SSE_PORT="3000"; .\mtg-mcp-windows-amd64.exe

# Docker
docker run --rm -p 3000:3000 \
  -e MCP_TRANSPORT=sse \
  -e MCP_SSE_PORT=3000 \
  mtg-mcp:latest

The server will start on http://0.0.0.0:3000/sse and be accessible from anywhere.

⁠Using with Claude Desktop

Update your claude_desktop_config.json to include the following under mcpServers:

⁠Docker

    "mtg-mcp":{
      "command": "docker",
      "args": [
        "run",
        "-i",
        "dccoder/mtg-mcp:latest",
	"-e MCP_TRANSPORT=stdio"
      ]
    }

⁠Local STDIO

Windows:

"mtg-mcp": {
    "command": "C:\\path\\to\\mtg-mcp-windows-amd64.exe",
    "args": []
}

Linux:

"mtg-mcp": {
    "command": "/path/to/mtg-mcp-linux-amd64",
    "args": []
}

This configuration file can be found by going to Settings -> Developer -> Edit Config in Claude Desktop.

⁠Environment Variables

This server supports the following environment variables:

Example with environment variables:

{
  "mcpServers": {
    "card_server": {
      "command": "/path/to/mtg-mcp-linux-amd64",
      "args": [],
      "env": {
        "MCP_LOG_TO_FILE": "false",
        "MCP_SERVER_NAME": "my-mtg-server"
      }
    }
  }
}

⁠Sources

Card effects and keywords are from the Magic: The Gathering Comprehensive Rules - September 19, 2025⁠