MTG Deck Manager

by artillect

2 stars
231 downloads
Not rated
GitHub

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

Author
artillect
Repository
artillect/mtg-mcp-servers
GitHub stars
2
Downloads
231
Categories
AI, Design, Developer Tools, Search, Infrastructure, Other
Tags
#integration

- 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:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name MTG Deck Manager
    Command (node, npx, python, etc.) python
    Arguments
    • 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.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

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

python -m venv .venv
.venv\Scripts\activate

pip install fastmcp httpx


Add the following to your Claude config:

json
{
"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"
}

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

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

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.