MTG Deck Manager MCP Servers
This project provides Model Context Protocol (MCP) servers for interacting with Magic: The Gathering decks and card information directly through Claude.
Features
- MTG Deck Manager: Upload decks, draw cards, manage your hand, perform mulligans, and handle sideboarding
- Scryfall API Integration: Search for cards, get random cards, and look up card information
Installation
- Clone this repository to your local machine:
git clone https://github.com/artillect/mtg-deck-mcp-server.git
cd mtg-deck-mcp-server
- Set up a Python virtual environment:
# Create and activate a virtual environment
python -m venv .venv
.venv\Scripts\activate
# Install dependencies
pip install fastmcp httpx
Claude Desktop Client Configuration
Add the following to your Claude config:
{
"mcp_servers": {
"mtg-server": {
"command": "C:\\Path\\To\\Your\\Project\\.venv\\Scripts\\python.exe",
"args": [
"C:\\Path\\To\\Your\\Project\\mtg_server.py"
]
},
"scryfall": {
"command": "C:\\Path\\To\\Your\\Project\\.venv\\Scripts\\python.exe",
"args": [
"C:\\Path\\To\\Your\\Project\\scryfall_server.py"
]
}
}
}
Make sure to adjust the paths to match your local installation.
Usage
After setting up the servers in your Claude client, you can interact with them by asking Claude to:
- Upload an MTG deck list
- Draw cards from your deck
- View your hand
- Search for card information via Scryfall
- Get random cards or search by name
Notes
- The Scryfall server may occasionally crash due to ongoing development.
- Make sure both servers are running when you want to use their respective features.