MTG Deck Manager MCP Servers

Name: MTG Deck Manager MCP Servers
Author: artillect

@artillect

About MTG Deck Manager MCP Servers

Model Context Protocol (MCP) servers for searching for cards with the Scryfall API, and managing the LLM's decklist and hand when playing

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mtg-mcp-servers": {
      "command": "python",
      "args": [
        "-m",
        "venv",
        ".venv"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is MTG Deck Manager MCP Servers?

This project provides two Model Context Protocol (MCP) servers for interacting with Magic: The Gathering decks and card information through Claude. It includes a deck manager for uploading decks, drawing cards, managing hands, performing mulligans, and handling sideboarding, plus a Scryfall API integration for searching, looking up card details, and retrieving random cards.

How to use MTG Deck Manager MCP Servers?

Install by cloning the repository, setting up a Python virtual environment, and installing dependencies (fastmcp and httpx). Configure the Claude Desktop client by adding two MCP server entries in the JSON configuration – one pointing to mtg_server.py and one to scryfall_server.py, adjusting paths to your local installation. After setup, ask Claude to perform deck actions or card searches.

Key features of MTG Deck Manager MCP Servers

Upload and manage MTG deck lists
Draw cards, view hand, and perform mulligans
Manage sideboarding between games
Search for cards via Scryfall API
Get random cards and detailed card information

Use cases of MTG Deck Manager MCP Servers

Simulate draws and test draft decks during deckbuilding
Quickly look up card rulings, prices, or images while playing
Handle sideboarding actions in a match with AI assistance
Explore card databases by name, random selection, or other criteria

FAQ from MTG Deck Manager MCP Servers

What functionality does each of the two servers provide?

The mtg-server handles deck operations (upload, draw, hand, mulligan, sideboard). The scryfall server provides card search, random cards, and card lookup using the Scryfall API.

What dependencies are required?

Python 3, fastmcp, and httpx are required. Install them in a virtual environment via pip install fastmcp httpx.

How do I configure the servers in Claude?

Add a JSON block to the Claude Desktop configuration with two entries: one for mtg-server and one for scryfall. Each entry requires the full path to the Python executable in the virtual environment and the full path to the respective .py script.

Are there known issues or limitations?

The Scryfall server may occasionally crash due to ongoing development. Both servers must be running to use their respective features.

Where do deck lists and card data reside?

Deck lists are uploaded by the user and managed locally by the server. Scryfall data is fetched from the public Scryfall API and is not stored persistently by this server.