A Model Context Protocol (MCP) server that provides access to the Scryfall API for Magic: The Gathering card data.
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"scryfall-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# Scryfall MCP Server [](https://opensource.org/licenses/Apache-2.0) [](https://www.python.org/downloads/) [](https://pypi.org/project/scryfall-mcp/) A Model Context Protocol (MCP) server that provides access to the Scryfall API for Magic: The Gathering card data. This server enables AI assistants and other MCP clients to search for cards, retrieve card information, download high-resolution images, and access comprehensive MTG data through a standardized interface. ## Features - **Card Search**: Search for Magic: The Gathering cards using Scryfall's powerful search syntax - **Card Details**: Retrieve detailed information about specific cards including prices, legality, and metadata - **Image Downloads**: Download high-resolution card images and art crops with automatic organization - **Database Operations**: Manage local card databases with integrity verification and cleanup tools - **Set Information**: Access information about MTG sets and expansions - **Artwork Access**: Get high-quality card artwork and images in multiple formats - **Advanced Filtering**: Use Scryfall's advanced search operators for precise queries - **Version Management**: Support for downloading specific card versions by set and collector number - **Rate Limiting**: Built-in rate limiting to respect Scryfall API guidelines ## Installation Install the package from PyPI: ```bash pip install scryfall-mcp ``` Or install from source: ```bash git clone https://github.com/kaminaduck/scryfall-mcp.git cd scryfall-mcp pip install -e . ``` ## Quick Start ### Running the Server Start the MCP server: ```bash python -m scryfall_mcp ``` Or run directly: ```python from scryfall_mcp import main main() ``` ### Basic Usage The server provides several tools that can be used by MCP clients: #### Search for Cards …
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.