Skip to main content
Glama
scryfall-mcp

scryfall-mcp

by rotohun

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 set

  • get_random_card — a random card, optionally constrained by a query

  • autocomplete_card_names — name completions for a partial input

  • get_card_by_id — lookup by Scryfall UUID

  • get_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 cards

  • get_card_prices — market prices (USD/foil/EUR/tix) and purchase links

  • get_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 ID

  • get_card_rulings — official rulings by card ID or set + collector number

Symbology & catalogs

  • list_symbology — all card symbols with metadata

  • parse_mana_cost — parse a mana cost string into canonical form

  • get_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: true to 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 build

Configure 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.js

Development

npm run dev        # tsx watch mode
npm run typecheck  # tsc --noEmit

License

MIT

Available Tools

18 tools
autocomplete_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

    A4/5.0

    Scored across 18 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness5/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Enables 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.
      7
      37
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      A 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.
      1
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      MCP 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.
      4
      MIT