scryfall-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| search_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. |
| get_card_namedA | 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. |
| get_random_cardB | Fetch a single random card, optionally constrained by a Scryfall query. |
| autocomplete_card_namesA | Return up to 20 card names that complete the given partial input. Useful for resolving a name before a precise lookup. |
| get_card_by_idB | Fetch a single card by its Scryfall UUID. |
| get_card_by_set_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'). |
| get_card_collectionA | 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":"..."}. |
| get_card_imagesA | 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. |
| get_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. |
| get_card_printingsA | 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. |
| list_setsA | List all Magic sets known to Scryfall (a compact summary of each). |
| get_setA | Fetch a single set by its set code (e.g. 'mh2'), Scryfall ID, or TCGplayer group ID. |
| get_card_rulingsA | Fetch official rulings for a card, identified either by Scryfall ID, or by set code + collector number. |
| list_symbologyA | List every card symbol Scryfall knows (mana symbols, tap, etc.) with metadata. |
| parse_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. |
| get_catalogA | Fetch a Scryfall catalog: a canonical list of values used across cards (e.g. all creature types, all keyword abilities, all card names). |
| list_bulk_dataA | 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. |
| get_bulk_dataA | 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. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
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.