Scryfall MCP. Search rulings, check legality, or pull specific card data.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
Scryfall gives you instant access to the entire Magic: The Gathering card database through an open API. Your AI agent can search for cards, fetch official rulings, list all sets, and pull deep data points using over a dozen specialized tools—all without leaving your workflow.
What your AI agents can do
Autocomplete cards
Suggests possible card names as you type them into the agent prompt.
Get bulk data by type
Retrieves a specific bulk data file based on its defined file type.
Get card by arena id
Fetches card details using the unique Arena ID associated with that card.
Run complex queries across the entire card database using specialized syntax (e.g., filtering by color, cost, or type).
Fetch judge rulings and official oracle text for specific cards or sets to resolve game legality issues.
Retrieve a card's full details using precise identifiers like its Scryfall ID, Multiverse ID, or MTGO ID.
Get bulk data for multiple cards at once by passing a list of various identifiers (names, IDs, etc.).
List all existing Magic sets or retrieve details on specific expansions using set codes and names.
Ask AI about this MCP
Supported MCP Clients
Gemini Waiting for input…
Scryfall MCP Server: 19 Tools for MTG Data Retrieval
These tools allow your AI client to perform every kind of search or lookup imaginable within the Magic: The Gathering card database.
019e5d53autocomplete cards
Suggests possible card names as you type them into the agent prompt.
019e5d53get bulk data by type
Retrieves a specific bulk data file based on its defined file type.
019e5d53get card by arena id
Fetches card details using the unique Arena ID associated with that card.
019e5d53get card by id
Gets a card's full data set when you provide its Scryfall internal ID.
019e5d53get card by mtgo id
Retrieves card details using the specific MTGO identifier for that game version of the card.
019e5d53get card by multiverse id
Fetches a card's data when you provide its Multiverse unique ID.
019e5d53get card by set number
Gets a card by providing both the set code and the collector number (e.g., Alpha 1).
019e5d53get card named
Finds cards using their name, supporting fuzzy matching so you don't need exact spelling.
019e5d53get cards collection
Retrieves a group of cards by listing multiple identifiers like names or IDs in one call.
019e5d53get catalog
Provides an overview and catalog of all available Magic data points the API tracks.
019e5d53get rulings by id
Gets official ruling text for a card using its specific Scryfall ID.
019e5d53get rulings by set number
Retrieves rulings by specifying the set code and collector number for accuracy.
019e5d53get set by code
Fetches all data for a game expansion when you provide its unique code (e.g., alpha).
019e5d53get set by id
Retrieves set details using the set's specific Scryfall ID.
019e5d53list bulk data
Lists all available bulk data files, helping you find what data is downloadable.
019e5d53list sets
Provides a list of every official Magic set that has been released into the database.
019e5d53list symbology
Returns a complete list of all symbols used on cards (e.g., legendary, artifact).
019e5d53parse mana
Converts a string that looks like mana costs into structured data your agent can read.
019e5d53search cards
Runs comprehensive searches across all cards, supporting advanced filtering by type, color, and text.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Scryfall, then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,700+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
What you can do with this MCP connector
Scryfall MCP Server: Your Deep Dive into Magic: The Gathering Data
You're talking to your agent about Magic? This server hooks up your AI client directly to Scryfall's massive card database. You won't waste time jumping between tabs or wrestling with limited APIs; you just ask, and the data shows up structured for your workflow.
Advanced Card Searching and Lookups
Your agent can run complex queries across every card in existence using search_cards, letting you filter results by color, cost, type, or specific text. You never need the exact spelling when searching because get_card_named handles fuzzy matching for cards by name. If you're just typing a prompt and need suggestions, autocomplete_cards pops up possible card names as you go.
To get full card details using precise identifiers, you've got several options. You can fetch a card's entire data set if you know its internal Scryfall ID using get_card_by_id. If you have the card's MTGO identifier for that specific game version, use get_card_by_mtgo_id; or if you only have the Multiverse unique number, get_card_by_multiverse_id gets it for you.
You can also pinpoint a card using its Arena ID with get_card_by_arena_id, or by knowing both the set code and collector number via get_card_by_set_number. When you need details on a specific expansion, simply call get_set_by_code (like 'alpha') or use the unique Scryfall ID with get_set_by_id to pull all that data.
Managing Collections and Bulk Data
Need info on more than one card? You don't gotta run a query for each one. Use get_cards_collection to pass in a list of various identifiers—names or IDs—and get them all back in one go. If you need an overview of what data Scryfall tracks, get_catalog gives you the full rundown of available API points.
To map out game history, list_sets provides a complete roster of every official set that’s ever been released into the database.
Official Rules and Set Details
Determining legality is where this server shines. For judge rulings or official oracle text on a card, use get_rulings_by_id with the Scryfall ID; alternatively, you can get rules by specifying the set code and collector number using get_rulings_by_set_number. The system also lets you retrieve all data for an entire game expansion using get_set_by_code, or just fetch its details with get_set_by_id.
Utility Tools for Deep Analysis
The server provides several mechanical tools to help your agent structure raw data. To understand what symbols are on cards (like 'Legendary' or 'Artifact'), call list_symbology, which returns a complete list of all known symbols. If you're dealing with cost strings, parse_mana converts that text into structured data your agent can actually read and process.
For downloadable file lists, run list_bulk_data to see everything available; then use get_bulk_data_by_type to retrieve a specific bulk data file based on its defined type.
When you need to know what data is even possible to download in bulk, list_bulk_data shows all options. Finally, if your agent needs to check the raw list of available Magic sets before running any searches, it can call list_sets. That's everything you need right there.
How Scryfall MCP Works
- 1 Subscribe to the Scryfall server. Your agent now recognizes its 19 specialized tools.
- 2 Prompt your AI client with a query (e.g., 'What are the rulings for Black Lotus in Alpha?').
- 3 The agent determines it needs
get_rulings_by_set_number, calls that tool, and receives structured card data back.
The bottom line is: Your AI client executes complex database queries using dedicated tools, so you get clean JSON output instead of a webpage.
Who Is Scryfall MCP For?
Game Designers who need to verify card legality before publishing; Software Developers building companion apps; and serious Collectors who manage large digital inventories. If your job involves knowing detailed, verifiable rules about Magic: The Gathering, this is for you.
Builds applications that need to pull card data (names, mana costs, text) and structure it into a database or script.
Needs to check if two specific cards interact legally under current official rules, requiring ruling lookups via tools like get_rulings_by_id.
Manages large personal collections and needs to quickly pull set details or card counts using identifiers.
What Changes When You Connect
- You get structured JSON output for every request. Instead of parsing messy web pages, your agent receives clean, machine-readable data directly from tools like
get_card_by_idandsearch_cards. - The server handles complex searching using specialized syntax. You can filter cards by type, color, or mana value in one shot with the robust
search_cardstool—no guessing needed. - You don't need to memorize multiple IDs. The tools allow you to look up data via name (
get_card_named), specific set codes (get_set_by_code), or collection numbers (get_card_by_set_number). - Rule checking is instant and accurate. Tools like
get_rulings_by_idpull the official judge rulings, solving complex interactions that would otherwise require manual cross-referencing. - You can build powerful data pipelines by fetching multiple records at once. Use
get_cards_collectionto analyze entire groups of cards using various identifiers.
Real-World Use Cases
Verifying Deck Legality for Publishing
A game designer is creating a new set and needs to ensure every card interacts correctly. They ask their agent: 'What are the official rulings for Card A interacting with Card B in Set X?' The agent uses get_rulings_by_set_number, which returns precise, verifiable text, confirming if the interaction breaks game rules.
Building a Digital Inventory Tool
A collector wants to track their entire physical collection's value and details. They ask: 'Get me all cards with the name 'Lightning Bolt' from sets Alpha, Beta, and Unlimited.' The agent uses get_cards_collection to batch-pull data for every instance, structuring it for a database.
Creating Card Synergy Checkers
A player is building a deck and needs to find all legendary creatures that cost 3 mana or less in red. They ask: 'Search for red legendary cards costing three mana.' The agent uses search_cards with multiple filters, providing a list of viable options instantly.
Cross-Reference Data for Development
A developer is building an app that needs to display card history. They ask: 'What were the original details for Sol Ring?' The agent uses get_card_by_mtgo_id or get_card_by_multiverse_id to pull historical data, ensuring their app has accurate source material.
The Tradeoffs
Searching by a partial name
Asking the agent: 'Show me cards that are like Black Lotus.' This is vague and doesn't tell the agent which tool to use, often leading to generic results or errors.
→
Don't guess. Use get_card_named for fuzzy searching by name (e.g., 'Black L...'), or if you know the exact ID, use get_card_by_id. Specificity is key.
Ignoring set context
Asking: 'What are the rules for this card?' without specifying which version of the game. This leaves the agent guessing and might pull outdated or incorrect ruling text.
→
Always provide context. Use get_rulings_by_set_number and pass both the set code AND the collector number to get definitive, accurate rulings.
Trying to combine too many filters manually
Telling the agent: 'Find me a card that is rare, costs 5 mana, is blue, and has an artifact type.' This is often too much for natural language parsing.
→
Use search_cards but structure your request around its known syntax (e.g., searching by color AND cost) or break the search into two steps: first list_sets, then narrow down using specific tools.
When It Fits, When It Doesn't
You should use this server if your core need is accessing structured, verifiable data about Magic: The Gathering cards and rules. It handles complex filtering (like searching by color AND type) better than anything else.
Don't use it if you are trying to analyze non-MTG card games or if you just need general internet search results; this is a deep database tool, not a web scraper. If your query involves multiple distinct attributes across different game types (e.g., 'Compare the stats of three video game characters'), you'll need a different data connector.
When querying: Use search_cards for broad, filtered searches; use get_card_by_id when you have an absolute ID; and always use ruling tools (get_rulings_by_set_number) if legality is the question.
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Scryfall. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 19 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Available Capabilities
Checking card rules shouldn't require opening five different websites.
Today, checking a card’s full legal standing feels like detective work. You start on one site for its basic text, jump to another for the official rulings, and then check a third just to confirm if it was printed in your specific set version. It's tedious copy-pasting across multiple browser tabs.
With this MCP server, your agent handles all that cross-referencing in seconds. You ask about an interaction—for instance, 'How does Card X interact with the rules of Set Y?'—and the agent runs `get_rulings_by_set_number`. It hands you one clean answer based on verifiable data.
Scryfall MCP Server: Pulling card details and rulings.
Manual lookups force you to remember every ID, set code, or unique identifier. You spend time figuring out the right URL just to see if a card was printed in Alpha vs. Beta.
The server abstracts all that complexity away. Whether you use `get_card_by_id` or `search_cards`, you simply ask your agent what you need, and it uses its 19 specialized tools to return the data directly into your workflow.
Common Questions About Scryfall MCP
How do I search for cards using Scryfall's advanced syntax with `search_cards`? +
You include complex filters directly in your prompt. For example, 'Search for red legendary dragons that cost 5 mana or less.' The search_cards tool handles the full syntax mapping automatically.
I need rulings for a card. Should I use `get_rulings_by_id` or `get_rulings_by_set_number`? +
Use get_rulings_by_set_number if you care about the specific set version (e.g., Alpha). Use get_rulings_by_id if you just need the general, universal ruling for that card's existence.
What is the best tool to get a card by name? +
The get_card_named tool handles this. It supports fuzzy matching, meaning you don't have to type the name perfectly; it still finds the right card.
How do I list every available MTG set? Do I need a special tool? +
You just use the list_sets tool. It queries and returns a complete, current list of all known Magic sets in the database for you to work with.
If I have multiple cards, how do I get them all at once? Which tool should I use? +
Use get_cards_collection. This tool accepts a list of identifiers—like names or IDs—and fetches the data for the entire group in one go.
If I know a card's Multiverse ID, should I use `get_card_by_multiverse_id` instead of searching? +
Yes, using get_card_by_multiverse_id is the most direct approach. This tool bypasses general search syntax and pulls the full card record immediately, regardless of its name or set number.
I'm not sure of a card's spelling; how can I check potential names using `autocomplete_cards`? +
autocomplete_cards quickly generates suggestions as you type. This saves time when the exact name isn't available and helps narrow down the possibilities before running a full search.
I have a mana cost string that I need to validate; should I use `parse_mana`? +
You should absolutely use parse_mana. This tool isolates mana text, allowing you to programmatically check or interpret the exact resources required by a card without needing to fetch the entire record.
Does the search tool support complex Scryfall syntax like 't:creature c:g cmc=3'? +
Yes! The search_cards tool accepts any valid Scryfall search query, allowing you to filter by type, color, mana cost, power/toughness, and more.
Can I find a card even if I don't remember the exact spelling of its name? +
Absolutely. Use the get_card_named tool with the fuzzy parameter. Scryfall's engine will suggest the closest match to your input.
How do I get the official rulings for a specific card interaction? +
You can use the get_rulings_by_id tool. By providing the card's Scryfall ID, the agent will return all official judge rulings and timing notes associated with that card.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
Snowtrace (Avalanche Explorer)
Explore the Avalanche C-Chain — check AVAX balances, track ERC-20/NFT transfers, and inspect smart contract data directly from your AI agent.
Blockchain.com Data
Access real-time Bitcoin blockchain data via Blockchain.com — query blocks, transactions, and addresses directly from any AI agent.
4D
Standard REST API for 4D Database — explore catalogs, query DataClasses, and manage entities via AI.
You might also like
Weatherbit Alternative
Access real-time weather data, 16-day forecasts, air quality metrics, and severe weather alerts globally.
JSONPlaceholder
Access fake online REST API for testing and prototyping — manage posts, comments, albums, photos, and todos directly from your AI agent.
Google Books Alternative
Search the world's most comprehensive index of full-text books, manage personal bookshelves, and retrieve detailed literary metadata.