MTG Deck Manager
About
Integrates with Magic: The Gathering resources to enable deck management, card drawing, hand manipulation, and Scryfall API searches for comprehensive card information retrieval and game simulation.
Details
- Repository
- artillect/mtg-mcp-servers
Explore
- 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
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
MTG Deck ManagerCommand (node, npx, python, etc.)pythonArguments-
Argument 1
C:\Path\To\Your\Project\mtg_server.py
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
-
Argument 1
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Setup
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
Install Dependencies
pip install fastmcp httpx
Create And Activate A Virtual Environment
python -m venv .venv
.venv\Scripts\activate
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.
upload_deck
Upload an MTG deck list.
draw_cards
Draw cards from your deck.
view_hand
View your current hand.
search_card_info
Search for card information via Scryfall.
get_random_cards
Get random cards from the card database.
search_by_name
Search for cards by their name.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"mtg deck manager": {
"cwd": "C:\\Path\\To\\Your\\Project\\.venv\\Scripts",
"env": {},
"args": [
"C:\\Path\\To\\Your\\Project\\mtg_server.py"
],
"command": "python"
}
}
}Linux
{
"cwd": "C:\\Path\\To\\Your\\Project\\.venv\\Scripts",
"env": [],
"args": [
"C:\\Path\\To\\Your\\Project\\mtg_server.py"
],
"command": "python"
}Macos
{
"cwd": "C:\\Path\\To\\Your\\Project\\.venv\\Scripts",
"env": [],
"args": [
"C:\\Path\\To\\Your\\Project\\mtg_server.py"
],
"command": "python"
}Windows
{
"env": [],
"args": [
"C:\\Path\\To\\Your\\Project\\mtg_server.py"
],
"command": "C:\\Path\\To\\Your\\Project\\.venv\\Scripts\\python.exe"
}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
1. Clone this repository to your local machine:
git clone https://github.com/artillect/mtg-deck-mcp-server.git
cd mtg-deck-mcp-server
2. Set up a Python virtual environment:
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
