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
Overview
MTG Deck Manager MCP Servers is a project that provides Machine-Comprehensible Protocol (MCP) servers for interacting with Magic: The Gathering decks and card information directly through Claude.
To use the MTG Deck Manager, clone the repository, set up a Python virtual environment, install the necessary dependencies, and configure the Claude Desktop Client to interact with the MCP servers.
- 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.
- Managing and playing Magic: The Gathering decks.
- Searching for specific cards using the Scryfall API.
- Drawing cards and managing hands during gameplay.
Add to your AI client
Use these steps to connect MTG Deck Manager MCP Servers in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.
Cursor
Add this to your .cursor/mcp.json file in your project root, then restart Cursor.
.cursor/mcp.json
{
"mcpServers": {
"mtg-mcp-servers-artillect": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mtg-mcp-servers-artillect"
]
}
}
}Claude Desktop
Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.
~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)
{
"mcpServers": {
"mtg-mcp-servers-artillect": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mtg-mcp-servers-artillect"
]
}
}
}Claude Code
Add this to your project's .mcp.json file. Claude Code will detect it automatically.
.mcp.json (project root)
{
"mcpServers": {
"mtg-mcp-servers-artillect": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mtg-mcp-servers-artillect"
]
}
}
}VS Code (Copilot)
Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.
.vscode/mcp.json
{
"servers": {
"mtg-mcp-servers-artillect": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mtg-mcp-servers-artillect"
]
}
}
}Windsurf
Add this to your Windsurf MCP config file, then restart Windsurf.
~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mtg-mcp-servers-artillect": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mtg-mcp-servers-artillect"
]
}
}
}Cline
Open Cline settings, navigate to MCP Servers, and add this server configuration.
Cline MCP Settings (via UI)
{
"mcpServers": {
"mtg-mcp-servers-artillect": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mtg-mcp-servers-artillect"
]
}
}
}FAQ
Can I use this project without a Python environment?
No, you need to set up a Python virtual environment to run the servers.
What should I do if the Scryfall server crashes?
The Scryfall server may crash occasionally due to ongoing development; ensure both servers are running for proper functionality.