scryfall-mcp
If you are the rightful owner of scryfall-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
This MCP server interfaces with the Scryfall API to fetch and display detailed Magic: The Gathering card data.
MCP Server – Scryfall API Interface
This is an MCP server that interfaces with the Scryfall API to fetch and display detailed Magic: The Gathering card data. It supports searching cards by name, color, type, and text content.
Features
- Search MTG cards via Scryfall by:
- Card name
- Color(s)
- Type line
- Oracle text
- Detailed card data output:
- Oracle text, mana cost, colors
- Type, power/toughness, rarity
- Set name
- Prices in USD/EUR (regular and foil)
Project Setup
This project uses uv for Python environment and dependency management. All dependencies are declared in pyproject.toml.
Requirements
- Python 3.12+
- uv (install with
cargo install uv)
Installation
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 in the console, however this is intended to be ran by an MCP host, like Claude Desktop.
Integration with Claude Desktop
Claude Desktop can run the MCP server to interact with the Scryfall API and use the results. You need to install or update to the latest Claude version and create the claude_desktop_config.json file if it doesn't exist yet:
~/Library/Application\ Support/Claude/claude_desktop_config.json in MacOS
$env:AppData\Claude\claude_desktop_config.json in Windows
{
"mcpServers": {
"scryfall": {
"command": "/ABSOLUTE/PATH/TO/BIN/uv",
"args": [
"--directory",
"/ABSOLUTE/PATH/TO/mcp-server",
"run",
"scryfall.py"
]
}
}
}
Testing
This project uses pytest for unit testing. Tests are located in the tests/ directory.
Running Tests
To run the full test suite:
pytest
To run a specific test:
pytest tests/test_scryfall.py::test_get_cards_no_query
