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.
URL: Visit APIs.json URL
Run: Capabilities Using Naftiko
- Games And Comics, Magic The Gathering, Card Data, Open Data, Free, Community Funded, Public APIs
- Created: 2026-05-28
- Modified: 2026-05-29
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.
Human URL: https://scryfall.com/docs/api
Base URL: https://api.scryfall.com
- Cards, Sets, Rulings, Symbology, Catalogs, Bulk Data, Magic The Gathering
- Documentation
- APIReference
- OpenAPI
- JSONSchema — Card
- JSONSchema — CardFace
- JSONSchema — RelatedCard
- JSONSchema — ImageUris
- JSONSchema — Legalities
- JSONSchema — Prices
- JSONSchema — Set
- JSONSchema — Ruling
- JSONSchema — CardSymbol
- JSONSchema — Catalog
- JSONSchema — BulkData
- JSONSchema — Migration
- JSONSchema — List
- JSONSchema — Error
- JSONStructure — Card
- JSONStructure — Set
- JSONStructure — Ruling
- JSONStructure — CardSymbol
- JSONStructure — Catalog
- JSONStructure — BulkData
- JSONStructure — Migration
- JSONLD
- Example — Card
- Example — CardList
- Example — Set
- Example — Ruling
- Example — CardSymbol
- Example — Catalog
- Example — BulkData
- Example — Migration
- Example — Error
- NaftikoCapability — Cards
- NaftikoCapability — Sets
- NaftikoCapability — Rulings
- NaftikoCapability — Symbology
- NaftikoCapability — Catalogs
- NaftikoCapability — Bulk Data
- NaftikoCapability — Migrations
- RateLimits
- Errors
- Website
- Documentation
- APIReference
- GettingStarted
- Blog
- ChangeLog
- Support
- Contact
- Plans
- RateLimits
- SpectralRules
- Vocabulary
- JSONLD
- GitHubOrganization
- GitHubRepository — scryfall/api-types
- GitHubRepository — scryfall/google-sheets
- GitHubRepository — scryfall/manamoji-slack
- GitHubRepository — scryfall/manamoji-discord
- GitHubRepository — scryfall/thopter
- GitHubRepository — scryfall/servo
- GitHubRepository — scryfall/scion
- GitHubRepository — scryfall/gatherer-bugs
- GitHubRepository — scryfall/art-game
- SDK — scryfall-client (JavaScript)
- SDK — scryfall-sdk (TypeScript)
- SDK — scrython (Python)
- SDK — scryfall (Rust)
- Tools — cryppadotta/scryfall-mcp
- Tools — bmurdock/scryfall-mcp
- Tools — andershaig/mcp-scryfall
- Tools — JoeMoCode/Scryfall-MCP
- Tools — artillect/mtg-mcp-servers
- Pricing — Community Funding
- TermsOfService
- PrivacyPolicy
| Name | Description |
|---|---|
| Comprehensive card database | Every Magic - The Gathering printing across paper, MTGO, and Arena with localized translations. |
| Fulltext search query language | Powerful Scryfall search syntax supporting color, type, format legality, set, price, oracle text, and more. |
| Daily bulk-data exports | Five daily JSON exports - oracle_cards, unique_artwork, default_cards, all_cards, and rulings - for offline ingestion. |
| Multi-resolution card imagery | Six image renderings per card - small, normal, large, png, art_crop, border_crop. |
| Up-to-date market prices | USD / EUR / MTGO Tix pricing across normal, foil, and etched finishes. |
| Oracle rulings | Wizards of the Coast Oracle rulings plus Scryfall editorial notes per card. |
| Symbology with SVG renderings | All Magic mana and text symbols with parser endpoint and downloadable SVG art. |
| Catalogs of in-game data points | Canonical lists of card names, creature types, supertypes, keyword abilities, and more for autocomplete and validation. |
| Free with attribution | No API key, no paid tier - usage is governed by attribution and a documented rate-limit policy. |
| Name | Description |
|---|---|
| Deck building applications | Powering search, autocomplete, and legality checks in deck-builder web and mobile apps. |
| Price tracking and portfolio tools | Aggregating USD / EUR / Tix prices across reprints for collection valuation. |
| Discord and Slack card-lookup bots | Inline card images, prices, and rulings inside team chat channels. |
| LLM and AI agent integrations | MCP servers exposing card data, rulings, and search to Claude and other agents. |
| Research and dataset publishing | Bulk-data exports feed academic and journalistic research on Magic's design history and card economy. |
| Spoiler and set-release coverage | Tracking newly-spoiled cards into and through release day via the Sets and Cards endpoints. |
| Custom card-rendering and proxy printing | High-resolution PNG and SVG art for personal-use proxies and educational content. |
| Tournament-legality verification | Format-legality checks for Standard, Pioneer, Modern, Legacy, Vintage, Pauper, Commander, Brawl, Alchemy, and historic formats. |
| Name | Description |
|---|---|
| TCGplayer | Cross-referenced card identifiers and purchase links via tcgplayer_id. |
| Cardmarket | Cross-referenced card identifiers and purchase links via cardmarket_id. |
| Cardhoarder | MTGO price feed integration and purchase links. |
| Wizards of the Coast Gatherer | Cross-referenced via multiverse_ids for canonical Oracle text. |
| Magic Online (MTGO) | Identifier mapping via mtgo_id and mtgo_foil_id. |
| Magic Arena | Identifier mapping via arena_id. |
| EDHREC | Commander-format recommendation data linked from card.related_uris. |
| Anthropic Claude (MCP) | Multiple community MCP servers expose Scryfall to Claude Desktop and other MCP clients. |
| Google Sheets | Official Scryfall =SCRYFALL() custom function for spreadsheet card lookups. |
| Alfred (macOS) | Official Scryfall Scion workflow for fast card search from Alfred. |
| Name | Description |
|---|---|
| Community software | Powering thousands of fan-built deck builders, collection trackers, and tools. |
| Magic content creators | Source of authoritative card data and imagery for podcasts, articles, and video content. |
| Researchers | Bulk-data exports enabling longitudinal analysis of Magic's design and economy. |
Machine-readable API specifications organized by format.
- Card
- CardFace
- RelatedCard
- ImageUris
- Legalities
- Prices
- Set
- Ruling
- CardSymbol
- Catalog
- BulkData
- Migration
- List
- Error
Naftiko capabilities for each Scryfall resource surface.
| Capability | File | Operations | Adapters |
|---|---|---|---|
| Scryfall Cards | scryfall-cards.yaml | 11 | REST + MCP |
| Scryfall Sets | scryfall-sets.yaml | 4 | REST + MCP |
| Scryfall Rulings | scryfall-rulings.yaml | 5 | MCP |
| Scryfall Symbology | scryfall-symbology.yaml | 2 | MCP |
| Scryfall Catalogs | scryfall-catalogs.yaml | 17 | MCP |
| Scryfall Bulk Data | scryfall-bulk-data.yaml | 3 | MCP |
| Scryfall Migrations | scryfall-migrations.yaml | 2 | MCP |
- Scryfall Plans & Pricing — free public API plus optional Patreon/Ko-fi community funding (no paid tier).
- Scryfall Rate Limits — under 10 RPS sustained, 50–100 ms delay between calls, /cards/collection capped at 2 RPS with up to 75 identifiers per batch, bulk-data preferred for large ingestion. Required headers: User-Agent (descriptive) and Accept.
- Scryfall Domain Vocabulary — Magic - The Gathering domain terms covering resources, layouts, formats, identifiers, and headers used across the API.
- Scryfall Spectral Rules — Spectral ruleset enforcing Scryfall conventions (HTTPS-only, Title-Case summaries, required
objectdiscriminator on response schemas, paginated List shape).
FN: Kin Lane
Email: kin@apievangelist.com