Scryfall MCP

🚀 MCP Server - Scryfall API Interface

This is an MCP server integrated with the Scryfall API, designed to retrieve and display detailed data of standard Magic: The Gathering cards. It supports card searches by name, color, type, and text content.

🚀 Quick Start

This MCP server connects with the Scryfall API to fetch and present detailed Magic: The Gathering card data. It allows you to search for cards using various criteria and provides comprehensive card information.

✨ Features

• Search MTG Cards via Scryfall:
  • By card name.
  • By color (single or multiple colors).
  • By type line.
  • By card text description.
• Output Detailed Card Data:
  • Card text description, mana cost, and color.
  • Type, power/toughness, and rarity.
  • Card set name.
  • Prices in US dollars and Euros (for both regular and foil cards).

📦 Installation

This project uses uv for Python environment and dependency management. All dependencies are declared in the pyproject.toml file.

Prerequisites

• Python version 3.12 or higher.
• uv (install using cargo install uv).

Installation Steps

uv venv
source .venv/bin/activate  # Or `.venv/Scripts/activate` on Windows
uv pip install -r pyproject.toml

Running the Project

Running the project with uv run scryfall.py "Atraxa" should display the Scryfall results for the Atraxa card. However, this project is intended to be run on an MCP host (such as Claude Desktop).

Integration with Claude Desktop

Claude Desktop can run this MCP server to connect with the Scryfall API and utilize the results. You need to install or update to the latest version of Claude and add the following content to its configuration file (create it if it doesn't exist):

~/Library/Application\ Support/Claude/claude_desktop_config.json on MacOS $env:AppData\Claude\claude_desktop_config.json on Windows

{
    "mcpServers": {
        "scryfall": {
            "command": "/ABSOLUTE/PATH/TO/BIN/uv",
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/mcp-server",
                "run",
                "scryfall.py"
            ]
        }
    }
}

💻 Usage Examples

Basic Usage

To search for a card named "Atraxa":

uv run scryfall.py "Atraxa"

📚 Documentation

Testing

This project uses pytest for unit testing. The test files are located in the tests/ folder.

Running Tests

To run the full test suite:

pytest

To run a specific test:

pytest tests/test_scryfall.py::test_get_cards_no_query