What is Mcp Mtg Assistant

mcp-mtg-assistant is a Model Context Protocol server that provides functionalities for fetching Magic: The Gathering card information using the Scryfall API.

Use cases

Use cases include looking up card details, answering rules-related queries, and integrating card information into other applications.

How to use

To use mcp-mtg-assistant, install the required dependencies using ‘uv’ or ‘pip’, navigate to the project directory, and run the server script. You can also configure it for MCP clients by adding an entry to their configuration.

Key features

Key features include the ability to retrieve specific card details from the Scryfall API and assist in answering Magic: The Gathering rules questions.

Where to use

mcp-mtg-assistant can be used in gaming applications, rule clarification tools, and any platform that requires Magic: The Gathering card information.

MCP Server MTG Assistant

A Model Context Protocol server that provides Magic: The Gathering card information fetching capabilities using the Scryfall API.

Example Rules Question Workflow

While primarily used for looking up specific card details, this server can also be a crucial first step in answering MTG rules questions.

User Query: “If I cast a Finale of Devastation with X=10 and search for an Avenger of Zendikar, do the tokens also get +10/+10 and haste, or not?”

Available Tools

• get_mtg_card_info - Retrieves details for a specific Magic: The Gathering card from Scryfall.
  • query (string, required): The search query string (e.g., card name, partial name, characteristics).

Installation and Running

This project uses uv for dependency management and running scripts.

Using uv (recommended)

Ensure uv is installed. You can run the server directly from the project directory:

# Navigate to the project root directory first
cd path/to/mcp-servers/mcp-mtg-assistant

# Install dependencies (if needed) and run the server script
uv run mcp-server-mtg-assistant

Using PIP (for distribution or alternative setup)

If the package were published, you could install it via pip:

pip install mcp-server-mtg-assistant

After installation, you could run it as a script:

python -m mcp_server_mtg_assistant

For development, you typically run it using uv run as shown above.

Configuration

Configure for MCP Clients (e.g., Claude.app, Inspector)

Add an entry to your client’s MCP server configuration. The exact key ("mtg-assistant" in the examples) can be chosen by you.

Important: The configuration needs to point uv to the correct project directory using the --directory argument. The path style (/ vs \) depends on your operating system and how you run uv.

Handling .venv Conflicts (Different Environments)

• Problem: uv run creates a .venv directory specific to the operating system/environment (e.g., Linux vs. Windows). If you switch between running the server directly on Windows and running it via WSL (or native Linux), the existing .venv might be incompatible.
• Solution: Before switching environments, delete the .venv directory in the mcp-mtg-assistant project root. uv run will then create a fresh, compatible one for the environment you are using.

Debugging

You can use the MCP inspector to debug the server by prefixing the command and arguments from your configuration with npx @modelcontextprotocol/inspector.

# Example using the Default (Linux/macOS/WSL) configuration:
npx @modelcontextprotocol/inspector uv --directory /path/to/mcp-servers/mcp-mtg-assistant run mcp-server-mtg-assistant

# Example using the Recommended (Windows Client + WSL Server) configuration:
npx @modelcontextprotocol/inspector wsl.exe /home/your-user/.cargo/bin/uv --directory /mnt/d/repos/mcp-servers/mcp-mtg-assistant run mcp-server-mtg-assistant

# Example using the Alternative (Direct Windows) configuration:
npx @modelcontextprotocol/inspector uv --directory D:\path\to\mcp-servers\mcp-mtg-assistant run mcp-server-mtg-assistant

Contributing

We encourage contributions to help expand and improve this MTG Assistant MCP server. Whether you want to add new features, enhance existing functionality, or improve documentation, your input is valuable.

For examples of other MCP servers and implementation patterns, see:
https://github.com/modelcontextprotocol/servers

Pull requests are welcome! Feel free to contribute new ideas, bug fixes, or enhancements.

License

mcp-server-mtg-assistant is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License.