scryfall-mcp
Provides tools to search, retrieve, and explore Magic: The Gathering card data via the Scryfall API, including card details, prices, printings, rulings, sets, and more.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@scryfall-mcp search for 'Tarmogoyf' with its current prices"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
scryfall-mcp
A Model Context Protocol server that exposes the Scryfall Magic: The Gathering API as tools for LLM clients (Claude Desktop, Claude Code, etc.).
No API key is required — Scryfall is a public API. The server sends a descriptive
User-Agent, requests JSON, and throttles itself to ~10 requests/second per Scryfall's
guidelines.
Tools
Card search & lookup
search_cards— full-text search using Scryfall query syntax (pagination, sort, unique modes)get_card_named— exact or fuzzy name lookup, optional setget_random_card— a random card, optionally constrained by a queryautocomplete_card_names— name completions for a partial inputget_card_by_id— lookup by Scryfall UUIDget_card_by_set_number— lookup by set code + collector number (+ optional language)get_card_collection— batch lookup of up to 75 cards by identifier
Images & prices
get_card_images— image URIs (small/normal/large/png/art_crop/border_crop), handles double-faced cardsget_card_prices— market prices (USD/foil/EUR/tix) and purchase linksget_card_printings— every printing of a card with per-printing set, rarity, prices, and art
Sets & rulings
list_sets— all sets (compact summary)get_set— a set by code, Scryfall ID, or TCGplayer group IDget_card_rulings— official rulings by card ID or set + collector number
Symbology & catalogs
list_symbology— all card symbols with metadataparse_mana_cost— parse a mana cost string into canonical formget_catalog— canonical value lists (creature types, keyword abilities, card names, …)
Bulk data
list_bulk_data— list downloadable full-dataset files (returns download URIs)get_bulk_data— metadata for one bulk file by type or ID
Card-heavy responses are summarized to the most useful fields to keep output compact. Single-card lookups accept
full: trueto return the complete Scryfall object. Bulk-data tools return download URIs only — fetch the (often hundreds of MB) files directly.
Related MCP server: Scryfall MCP Server
Install & build
npm install
npm run buildConfigure a client
Point your MCP client at the built entry. For Claude Desktop
(claude_desktop_config.json) or Claude Code (.mcp.json):
{
"mcpServers": {
"scryfall": {
"command": "node",
"args": ["/Users/ronald/Desktop/projects/scryfall-mcp/dist/index.js"]
}
}
}Or add it to Claude Code from the CLI:
claude mcp add scryfall -- node /Users/ronald/Desktop/projects/scryfall-mcp/dist/index.jsDevelopment
npm run dev # tsx watch mode
npm run typecheck # tsc --noEmitLicense
MIT
Available Tools
18 toolsautocomplete_card_namesAutocomplete card namesA
Return up to 20 card names that complete the given partial input. Useful for resolving a name before a precise lookup.
Inputs: q (required), include_extras.
get_bulk_dataGet a bulk data entryA
Fetch metadata for a single bulk data file by its type (e.g. 'oracle_cards', 'default_cards', 'rulings') or by its Scryfall ID. Returns the download URI; does not download the (often hundreds of MB) file itself.
Inputs: id, type.
get_card_by_idGet card by Scryfall IDB
Fetch a single card by its Scryfall UUID.
Inputs: id (required), full.
get_card_by_set_numberGet card by set + collector numberA
Fetch a single card by its set code and collector number, e.g. set 'mh2' number '173'. Optionally specify a language code (e.g. 'ja').
Inputs: set (required), collector_number (required), full, lang.
get_card_collectionGet a collection of cardsA
Batch-fetch up to 75 cards in one request by a list of identifiers. Each identifier is an object such as {"id":""}, {"name":"Lightning Bolt"}, {"set":"mh2","collector_number":"173"}, or {"name":"...","set":"..."}.
Inputs: identifiers (required).
get_card_imagesGet card image URIsA
Return image URIs (small, normal, large, png, art_crop, border_crop) for a card, identified by id, name, or set + collector number. Handles double-faced cards.
Inputs: id, set, name, fuzzy, +1 more.
get_card_namedGet card by nameA
Fetch a single card by name. Use 'exact' for an exact (case-insensitive) name, or 'fuzzy' for a forgiving best-match search. Provide exactly one.
Inputs: set, full, exact, fuzzy.
get_card_pricesGet card pricesA
Return market prices (USD, USD foil, EUR, MTGO tix) and purchase links for a card, identified by id, name, or set + collector number.
Inputs: id, set, name, fuzzy, +1 more.
get_card_printingsList all printings of a cardA
List every printing of a card by name, with per-printing set, collector number, rarity, prices, and image URIs. Useful for comparing prices/art across sets.
Inputs: name (required), order.
get_card_rulingsGet card rulingsA
Fetch official rulings for a card, identified either by Scryfall ID, or by set code + collector number.
Inputs: id, set, collector_number.
get_catalogGet a catalogA
Fetch a Scryfall catalog: a canonical list of values used across cards (e.g. all creature types, all keyword abilities, all card names).
Inputs: catalog (required).
get_random_cardGet a random cardB
Fetch a single random card, optionally constrained by a Scryfall query.
Inputs: q, full.
get_setGet a setA
Fetch a single set by its set code (e.g. 'mh2'), Scryfall ID, or TCGplayer group ID.
Inputs: id, code, tcgplayer_id.
list_bulk_dataList bulk data filesA
List Scryfall's downloadable bulk data files (full datasets such as all cards, oracle cards, rulings). Returns download URIs and sizes — fetch the files directly, not via this server.
Inputs: no named parameters.
list_setsList all setsA
List all Magic sets known to Scryfall (a compact summary of each).
Inputs: no named parameters.
list_symbologyList card symbolsA
List every card symbol Scryfall knows (mana symbols, tap, etc.) with metadata.
Inputs: no named parameters.
parse_mana_costParse a mana costA
Parse a mana cost string (e.g. 'RUW', '2WW', '{X}{R}') and return its canonical form, converted mana cost, colors, and color identity.
Inputs: cost (required).
search_cardsSearch cardsA
Full-text card search using Scryfall's query syntax (e.g. 'c:red type:instant cmc<=2', 'o:"draw a card" f:commander'). Returns a compact summary of up to ~175 cards per page. See https://scryfall.com/docs/syntax for the query language.
Inputs: q (required), dir, page, order, +3 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 18 tools
Each tool targets a specific aspect of Magic card data (search, fetch by ID/name/set, images, prices, rulings, sets, bulk data, catalogs, mana parsing). The descriptions clearly distinguish them, preventing confusion.
All tool names follow a consistent verb_noun pattern (e.g., autocomplete_card_names, get_card_by_id, list_sets, search_cards), making it predictable for an agent.
18 tools cover the core interactions with Scryfall without being excessive. Each tool serves a distinct purpose, and the count is appropriate for a comprehensive card database server.
The tool set covers all expected operations: searching, fetching by various identifiers, images, prices, rulings, printings, sets, bulk data, catalogs, and mana parsing. No obvious gaps for a read-only query tool.
Maintenance
Related MCP Connectors
MCP server providing access to the Scorecard API to evaluate and optimize LLM systems.
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
The Mercado Pago MCP Server implements the Model Context Protocol to provide AI agents and LLMs with access to Mercado Pago's APIs and tools within compatible development environments. It acts as an intermediary that translates Mercado Pago resources into executable functions (tools) that AI applications can invoke to perform actions and automate flows. The server simplifies integration, enables using documentation to implement or improve code, and optimizes operations through natural language interactions without manual implementations.
An MCP server that provides an API to LLMs to manage their JumpCloud resources.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables interaction with the Scryfall API, allowing users to search for Magic: The Gathering card details, retrieve card rulings, and access pricing information using the Model Context Protocol.737MIT
- AlicenseAqualityBmaintenanceA comprehensive Model Context Protocol server that integrates with the Scryfall API to provide Magic: The Gathering card data to AI assistants like Claude.141MIT
- AlicenseNot gradedqualityDmaintenanceA comprehensive Model Context Protocol server that provides AI assistants with rich Magic: The Gathering information, including card data, comprehensive rules, EDHREC recommendations, combo interactions, and intelligent Commander deck generation.1MIT
- AlicenseAqualityDmaintenanceMCP server for searching and retrieving Magic: The Gathering card information via the Scryfall API, with support for field presets, multiple output formats, and automatic rate limiting.4MIT