Vinkius
Scryfall

Scryfall MCP for AI. Search rulings, check legality, or pull specific card data.

Claude Claude
ChatGPT ChatGPT
Cursor Cursor
Gemini Gemini
Windsurf Windsurf
VS Code VS Code
JetBrains JetBrains
Vercel Vercel
See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

Scryfall MCP on Cursor AI Code EditorScryfall MCP on Claude Desktop AppScryfall MCP on OpenAI Agents SDKScryfall MCP on Visual Studio CodeScryfall MCP on GitHub Copilot AI AgentScryfall MCP on Google Gemini AIScryfall MCP on Lovable AI DevelopmentScryfall MCP on Mistral AI AgentsScryfall MCP on Amazon AWS Bedrock

How this MCP server connects to your AI agent

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 AI agents can do with Scryfall Automation

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.

+ 16 more capabilities included
Advanced Card Search

Run complex queries across the entire card database using specialized syntax (e.g., filtering by color, cost, or type).

Official Ruling Retrieval

Fetch judge rulings and official oracle text for specific cards or sets to resolve game legality issues.

Targeted Card Lookup

Retrieve a card's full details using precise identifiers like its Scryfall ID, Multiverse ID, or MTGO ID.

Collection Data Management

Get bulk data for multiple cards at once by passing a list of various identifiers (names, IDs, etc.).

Game History Mapping

List all existing Magic sets or retrieve details on specific expansions using set codes and names.

Included with Plan

Waiting for input…

AI Agent

What AI agents can do with 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.

Make your AI actually useful.

Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.

Start using Scryfall on Vinkius

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.

Get Card By Id

Gets a card's full data set when you provide its Scryfall internal ID.

Get Card By Mtgo Id

Retrieves card details using the specific MTGO identifier for that game version of...

Get Card By Multiverse Id

Fetches a card's data when you provide its Multiverse unique ID.

Get Card By Set Number

Gets a card by providing both the set code and the collector number (e.g., Alpha 1).

Get Catalog

Provides an overview and catalog of all available Magic data points the API tracks.

Get Cards Collection

Retrieves a group of cards by listing multiple identifiers like names or IDs in one...

List Bulk Data

Lists all available bulk data files, helping you find what data is downloadable.

List Sets

Provides a list of every official Magic set that has been released into the database.

List Symbology

Returns a complete list of all symbols used on cards (e.g., legendary, artifact).

Get Card Named

Finds cards using their name, supporting fuzzy matching so you don't need exact spelling.

Parse Mana

Converts a string that looks like mana costs into structured data your agent can...

Get Rulings By Id

Gets official ruling text for a card using its specific Scryfall ID.

Get Rulings By Set Number

Retrieves rulings by specifying the set code and collector number for accuracy.

Search Cards

Runs comprehensive searches across all cards, supporting advanced filtering by type...

Get Set By Code

Fetches all data for a game expansion when you provide its unique code (e.g., alpha).

Get Set By Id

Retrieves set details using the set's specific Scryfall ID.

Security and governance baked right in.

Pick your AI client below to get set up. Just create a Vinkius account, subscribe, and you're instantly up and running. We handle the entire backend infrastructure, delivering out-of-the-box support for HTTPS Streamable, SSE, and OAuth2—zero messy routing required.

Claude AI

Claude AI

1

Open Claude Settings

Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.

2

Add Custom Connector

Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL:

https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. For OAuth-protected servers, expand Advanced settings to add credentials.

3

Start a conversation

Open a new chat. The Scryfall integration is available immediately — no restart needed.

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
Start building

Make Your AI Do More

Start with Scryfall, then connect any of our 5,100+ other servers whenever your AI needs more. One click, no limits.

  • Use this MCP plus 5,100+ 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
Scryfall MCP server cover

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

Your data is protected. See how we built it.

Built on the Model Context Protocol (MCP) for 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 connection provides 19 powerful capabilities that interface natively with Claude, ChatGPT, Cursor, and other compatible AI platforms. No middleware. No custom integration required.

Checking card rules shouldn't require opening five different websites., Solved with Vinkius AI Gateway

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.

What your AI can actually do with this

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.

Built · Hosted · Managed by Vinkius Scryfall MCP Server - Search Magic Cards & Rulings
Server ID 019e5d53-9ea5-702c-a169-8f8f1e72f76f
Vinkius Inspector
Compliance Grade F
Score 3.6/100
Vinkius Inspector Badge — Score 3.6/100

Questions you might have

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.

Built & Managed by Vinkius 30s setup 19 tools

We've already built the connector for Scryfall. Just plug in your AI agents and start using Vinkius.

No hosting. No infrastructure. No complex setup.
All 19 tools are live and waiting. You're up and running in seconds.

Vinkius runs on Claude Claude
Vinkius runs on ChatGPT ChatGPT
Vinkius runs on Cursor Cursor
Vinkius runs on Gemini Gemini
Vinkius runs on Windsurf Windsurf
Vinkius runs on VS Code VS Code
Vinkius runs on JetBrains JetBrains
Vinkius runs on Vercel Vercel
+ other MCP clients

Vinkius gives your AI agents access to the full catalog of app connectors, all fully managed, secure, and enterprise-ready. One subscription, every tool you need.

Zero hosting required Full MCP catalog included Enterprise-grade security Auto-updated by Vinkius

Built, hosted, and secured by Vinkius. You just connect and go.