Scryfall

aid: scryfall
name: Scryfall
description: Scryfall is the most comprehensive free Magic - The Gathering card database. The Scryfall
  API exposes Cards (search, autocomplete, named, random, collection, by various IDs), Sets, Rulings,
  Symbology, Catalogs, Bulk Data downloads, and card-object Migrations. The service is community-funded
  (Patreon / Ko-fi) and offered free of charge under the Wizards of the Coast Fan Content Policy for
  community software, research, and content. The API is HTTPS-only, requires a descriptive User-Agent
  and Accept header on every request, and asks that clients keep sustained traffic under 10 requests
  per second.
type: Index
url: https://raw.githubusercontent.com/api-evangelist/scryfall/main/apis.yml
humanURL: https://scryfall.com/docs/api
image: https://kinlane-productions.s3.amazonaws.com/apis-json/apis-json-logo.jpg
specificationVersion: '0.20'
created: '2026-05-28'
modified: '2026-05-29'
x-type: opensource
x-tier: 3
x-tier-reason: enriched-via-full-pipeline
x-source: public-apis/public-apis
x-category: Games & Comics
tags:
  - Games And Comics
  - Magic The Gathering
  - Card Data
  - Open Data
  - Free
  - Community Funded
  - Public APIs
apis:
  - aid: scryfall:scryfall-api
    name: Scryfall API
    description: The Scryfall REST API exposes Magic - The Gathering card data, set metadata, Oracle
      rulings, symbology, catalogs of in-game data points, daily bulk-data exports, and card-object
      migration records. The Cards surface alone supports lookup by Scryfall ID, set+number,
      Multiverse ID, MTGO ID, Arena ID, TCGplayer ID, Cardmarket ID, exact/fuzzy name, autocomplete,
      random draw, and batch collection. All responses use a discriminated object model keyed by the
      'object' field.
    humanURL: https://scryfall.com/docs/api
    baseURL: https://api.scryfall.com
    tags:
      - Cards
      - Sets
      - Rulings
      - Symbology
      - Catalogs
      - Bulk Data
      - Magic The Gathering
    properties:
      - type: Documentation
        url: https://scryfall.com/docs/api
      - type: APIReference
        url: https://scryfall.com/docs/api/cards
      - type: OpenAPI
        url: openapi/scryfall-openapi.yml
      - type: JSONSchema
        url: json-schema/scryfall-card-schema.json
      - type: JSONSchema
        url: json-schema/scryfall-card-face-schema.json
      - type: JSONSchema
        url: json-schema/scryfall-related-card-schema.json
      - type: JSONSchema
        url: json-schema/scryfall-image-uris-schema.json
      - type: JSONSchema
        url: json-schema/scryfall-legalities-schema.json
      - type: JSONSchema
        url: json-schema/scryfall-prices-schema.json
      - type: JSONSchema
        url: json-schema/scryfall-set-schema.json
      - type: JSONSchema
        url: json-schema/scryfall-ruling-schema.json
      - type: JSONSchema
        url: json-schema/scryfall-card-symbol-schema.json
      - type: JSONSchema
        url: json-schema/scryfall-catalog-schema.json
      - type: JSONSchema
        url: json-schema/scryfall-bulk-data-schema.json
      - type: JSONSchema
        url: json-schema/scryfall-migration-schema.json
      - type: JSONSchema
        url: json-schema/scryfall-list-schema.json
      - type: JSONSchema
        url: json-schema/scryfall-error-schema.json
      - type: JSONStructure
        url: json-structure/scryfall-card-structure.json
      - type: JSONStructure
        url: json-structure/scryfall-set-structure.json
      - type: JSONStructure
        url: json-structure/scryfall-ruling-structure.json
      - type: JSONStructure
        url: json-structure/scryfall-card-symbol-structure.json
      - type: JSONStructure
        url: json-structure/scryfall-catalog-structure.json
      - type: JSONStructure
        url: json-structure/scryfall-bulk-data-structure.json
      - type: JSONStructure
        url: json-structure/scryfall-migration-structure.json
      - type: JSONLD
        url: json-ld/scryfall-context.jsonld
      - type: Example
        url: examples/scryfall-card-example.json
      - type: Example
        url: examples/scryfall-card-list-example.json
      - type: Example
        url: examples/scryfall-set-example.json
      - type: Example
        url: examples/scryfall-ruling-example.json
      - type: Example
        url: examples/scryfall-card-symbol-example.json
      - type: Example
        url: examples/scryfall-catalog-example.json
      - type: Example
        url: examples/scryfall-bulk-data-example.json
      - type: Example
        url: examples/scryfall-migration-example.json
      - type: Example
        url: examples/scryfall-error-example.json
      - type: NaftikoCapability
        url: capabilities/scryfall-cards.yaml
      - type: NaftikoCapability
        url: capabilities/scryfall-sets.yaml
      - type: NaftikoCapability
        url: capabilities/scryfall-rulings.yaml
      - type: NaftikoCapability
        url: capabilities/scryfall-symbology.yaml
      - type: NaftikoCapability
        url: capabilities/scryfall-catalogs.yaml
      - type: NaftikoCapability
        url: capabilities/scryfall-bulk-data.yaml
      - type: NaftikoCapability
        url: capabilities/scryfall-migrations.yaml
      - type: RateLimits
        url: rate-limits/scryfall-rate-limits.yml
      - type: Authentication
        url: https://scryfall.com/docs/api
      - type: Errors
        url: https://scryfall.com/docs/api/errors
common:
  - type: Website
    url: https://scryfall.com
  - type: Documentation
    url: https://scryfall.com/docs/api
  - type: APIReference
    url: https://scryfall.com/docs/api/cards
  - type: GettingStarted
    url: https://scryfall.com/docs/api
  - type: Blog
    url: https://scryfall.com/blog/category/api
  - type: ChangeLog
    url: https://scryfall.com/blog/category/api
  - type: Support
    url: https://scryfall.com/contact
  - type: Contact
    url: https://scryfall.com/contact
  - type: Plans
    url: plans/scryfall-plans-pricing.yml
  - type: RateLimits
    url: rate-limits/scryfall-rate-limits.yml
  - type: SpectralRules
    url: rules/scryfall-rules.yml
  - type: Vocabulary
    url: vocabulary/scryfall-vocabulary.yml
  - type: JSONLD
    url: json-ld/scryfall-context.jsonld
  - type: GitHubOrganization
    url: https://github.com/scryfall
  - type: GitHubRepository
    name: scryfall/api-types
    url: https://github.com/scryfall/api-types
    description: A library describing the Scryfall API as a system of TypeScript types.
  - type: GitHubRepository
    name: scryfall/google-sheets
    url: https://github.com/scryfall/google-sheets
    description: Custom =SCRYFALL() function for Google Sheets.
  - type: GitHubRepository
    name: scryfall/manamoji-slack
    url: https://github.com/scryfall/manamoji-slack
    description: Slack emojis for Magic card symbols.
  - type: GitHubRepository
    name: scryfall/manamoji-discord
    url: https://github.com/scryfall/manamoji-discord
    description: Discord emojis for Magic card symbols.
  - type: GitHubRepository
    name: scryfall/thopter
    url: https://github.com/scryfall/thopter
    description: A Slack bot returning Magic card information, pictures, and prices.
  - type: GitHubRepository
    name: scryfall/servo
    url: https://github.com/scryfall/servo
    description: A Discord bot that returns Magic card information and pictures.
  - type: GitHubRepository
    name: scryfall/scion
    url: https://github.com/scryfall/scion
    description: An Alfred workflow to quickly search for Magic cards.
  - type: GitHubRepository
    name: scryfall/gatherer-bugs
    url: https://github.com/scryfall/gatherer-bugs
    description: A public repository tracking bugs on gatherer.wizards.com.
  - type: GitHubRepository
    name: scryfall/art-game
    url: https://github.com/scryfall/art-game
    description: The MTG art-guessing game on Scryfall.
  - type: SDK
    name: scryfall-client (JavaScript)
    url: https://github.com/crookedneighbor/scryfall-client
    description: Community-maintained JavaScript client for the Scryfall API.
  - type: SDK
    name: scryfall-sdk (TypeScript)
    url: https://www.npmjs.com/package/scryfall-sdk
    description: Community-maintained TypeScript SDK for the Scryfall API.
  - type: SDK
    name: scrython (Python)
    url: https://github.com/NandaScott/Scrython
    description: Community-maintained Python wrapper for the Scryfall API.
  - type: SDK
    name: scryfall (Rust)
    url: https://docs.rs/scryfall
    description: Community-maintained Rust client for the Scryfall API.
  - type: Tools
    name: cryppadotta/scryfall-mcp
    url: https://github.com/cryppadotta/scryfall-mcp
    description: MCP server providing card details, rulings, and price lookups via the Scryfall API.
  - type: Tools
    name: bmurdock/scryfall-mcp
    url: https://github.com/bmurdock/scryfall-mcp
    description: MCP server for Scryfall-backed Magic search, rules lookup, pricing, set discovery,
      and deckbuilding workflows.
  - type: Tools
    name: andershaig/mcp-scryfall
    url: https://github.com/andershaig/mcp-scryfall
    description: MCP server for Scryfall's Magic card search inside Claude.
  - type: Tools
    name: JoeMoCode/Scryfall-MCP
    url: https://github.com/joemocode/scryfall-mcp
    description: MCP server bringing Magic card data into Claude Desktop.
  - type: Tools
    name: artillect/mtg-mcp-servers
    url: https://github.com/artillect/mtg-mcp-servers
    description: MCP servers for Scryfall card search plus LLM decklist and hand management.
  - type: Pricing
    url: https://scryfall.com/donate
  - type: TermsOfService
    url: https://scryfall.com/docs/api
  - type: PrivacyPolicy
    url: https://scryfall.com/privacy
  - type: Features
    data:
      - name: Comprehensive card database
        description: Every Magic - The Gathering printing across paper, MTGO, and Arena with localized
          translations.
      - name: Fulltext search query language
        description: Powerful Scryfall search syntax supporting color, type, format legality, set,
          price, oracle text, and more.
      - name: Daily bulk-data exports
        description: Five daily JSON exports - oracle_cards, unique_artwork, default_cards, all_cards,
          and rulings - for offline ingestion.
      - name: Multi-resolution card imagery
        description: Six image renderings per card - small, normal, large, png, art_crop, border_crop.
      - name: Up-to-date market prices
        description: USD / EUR / MTGO Tix pricing across normal, foil, and etched finishes.
      - name: Oracle rulings
        description: Wizards of the Coast Oracle rulings plus Scryfall editorial notes per card.
      - name: Symbology with SVG renderings
        description: All Magic mana and text symbols with parser endpoint and downloadable SVG art.
      - name: Catalogs of in-game data points
        description: Canonical lists of card names, creature types, supertypes, keyword abilities,
          and more for autocomplete and validation.
      - name: Free with attribution
        description: No API key, no paid tier - usage is governed by attribution and a documented
          rate-limit policy.
  - type: UseCases
    data:
      - name: Deck building applications
        description: Powering search, autocomplete, and legality checks in deck-builder web and
          mobile apps.
      - name: Price tracking and portfolio tools
        description: Aggregating USD / EUR / Tix prices across reprints for collection valuation.
      - name: Discord and Slack card-lookup bots
        description: Inline card images, prices, and rulings inside team chat channels.
      - name: LLM and AI agent integrations
        description: MCP servers exposing card data, rulings, and search to Claude and other agents.
      - name: Research and dataset publishing
        description: Bulk-data exports feed academic and journalistic research on Magic's design
          history and card economy.
      - name: Spoiler and set-release coverage
        description: Tracking newly-spoiled cards into and through release day via the Sets and Cards
          endpoints.
      - name: Custom card-rendering and proxy printing
        description: High-resolution PNG and SVG art for personal-use proxies and educational content.
      - name: Tournament-legality verification
        description: Format-legality checks for Standard, Pioneer, Modern, Legacy, Vintage, Pauper,
          Commander, Brawl, Alchemy, and historic formats.
  - type: Integrations
    data:
      - name: TCGplayer
        description: Cross-referenced card identifiers and purchase links via tcgplayer_id.
      - name: Cardmarket
        description: Cross-referenced card identifiers and purchase links via cardmarket_id.
      - name: Cardhoarder
        description: MTGO price feed integration and purchase links.
      - name: Wizards of the Coast Gatherer
        description: Cross-referenced via multiverse_ids for canonical Oracle text.
      - name: Magic Online (MTGO)
        description: Identifier mapping via mtgo_id and mtgo_foil_id.
      - name: Magic Arena
        description: Identifier mapping via arena_id.
      - name: EDHREC
        description: Commander-format recommendation data linked from card.related_uris.
      - name: Anthropic Claude (MCP)
        description: Multiple community MCP servers expose Scryfall to Claude Desktop and other MCP
          clients.
      - name: Google Sheets
        description: Official Scryfall =SCRYFALL() custom function for spreadsheet card lookups.
      - name: Alfred (macOS)
        description: Official Scryfall Scion workflow for fast card search from Alfred.
  - type: Solutions
    data:
      - name: Community software
        description: Powering thousands of fan-built deck builders, collection trackers, and tools.
      - name: Magic content creators
        description: Source of authoritative card data and imagery for podcasts, articles, and video
          content.
      - name: Researchers
        description: Bulk-data exports enabling longitudinal analysis of Magic's design and economy.
maintainers:
  - FN: Kin Lane
    email: [email protected]