MTG Assistant

What is MTG Assistant?

MTG Assistant is a Model Context Protocol server that fetches Magic: The Gathering card information using the Scryfall API. It is intended for developers integrating MTG card lookups into MCP-compatible clients such as Claude.

How to use MTG Assistant?

Install dependencies with uv, then run uv run mcp-server-mtg-assistant from the project directory. Alternatively, install via pip install mcp-server-mtg-assistant and run python -m mcp_server_mtg_assistant. Add a configuration entry to your MCP client (e.g., mcp.json) with uv or wsl.exe commands and the correct --directory path. The server exposes one tool: get_mtg_card_info, which accepts a search query string.

Key features of MTG Assistant

• Fetches card details from the Scryfall API.
• Provides one tool: get_mtg_card_info.
• Configurable for Linux, macOS, WSL, and Windows.
• Supports debug via the MCP inspector.
• Uses uv for dependency management and execution.

Use cases of MTG Assistant

• Look up a specific Magic card’s name, text, or characteristics.
• Answer rules questions by first retrieving card data from Scryfall.
• Integrate MTG card information into LLM-based assistants or chat clients.
• Automate card research for deck building or game analysis.

FAQ from MTG Assistant

What data source does MTG Assistant use?

It retrieves card information from the Scryfall API, a public database of Magic: The Gathering cards.

What are the runtime requirements?

The server requires Python and the uv package manager (recommended). It can also be run via pip if the package is published.

How do I configure MTG Assistant for Windows with a WSL server?

Use wsl.exe as the command with the path to uv inside WSL, and a WSL‑style path (e.g., /mnt/d/...) for the --directory argument.

What should I do if I get a .venv conflict when switching between environments?

Delete the .venv directory in the project root before switching environments. The next uv run will create a fresh, compatible virtual environment.

How can I debug the MTG Assistant server?

Run the MCP inspector by prefixing your server command with npx @modelcontextprotocol/inspector. Example: npx @modelcontextprotocol/inspector uv --directory <project_path> run mcp-server-mtg-assistant.