An astronaut overseeing a futuristic data hub
Download PDFMarkdown Version

Connect Scryfall to ChatGPT, Claude and Gemini

Set it up once and it works in ChatGPT, Claude, Cursor, and any other client you love. It all runs safely in the background, so you can relax and focus on what really matters. Query the entire Magic card history through your AI client.

Ask AI about this Connector

Developed, maintained, and hosted by Vinkius.

MCP VERIFIED · PRODUCTION READY · VINKIUS GUARANTEED

Waiting for input…

Works with modern AI clients that support MCP, including ChatGPT, Claude, Cursor, and more.

ChatGPTClaudeCursorPerplexityGeminiMicrosoft CopilotRaycastMeta AI

Your AI does the work. We keep it safe and sound.

No other AI tool gives you this. Your workflow runs in the client you already love, your account stays protected, and you decide what the agent can and cannot do. It is the whole reason to make the switch.

Each Connector lives inside our infrastructure, the same place where your workflow runs. The three things below are already part of it, working quietly in the background so you never have to think about them. Nothing to add, nothing to set up, nothing to worry about.

A futuristic MCP client docking bay
V8 Isolate01

Each Connector runs inside its own sealed environment.

Each Connector runs inside its own sealed V8 runtime — no access to your files, your system, or other servers. A Connector never sees past its own request.

Kill Switch02

One switch stops every agent. Instantly.

One action deactivates every Connector, revokes every token, and ends every session at once. AI Governance keeps the record.

FinOps per User03

Spending limits that pause instead of surprise.

Every user keeps their own connections and credentials, isolated from everyone else. Anything that would cross your spending limit is held for your approval, not billed.

Three controls, built into the layer your AI connects through.

Curated set · 19 capabilities

We ship only the actions that matter.

Capability set01 / 05

01-04

4 capabilities in this set.

Part of 19 available through Scryfall.

  1. 01

    Get set by code

    Retrieves a specific Magic set using its unique set code.

  2. 02

    Get set by ID

    Fetches set details using a Scryfall ID.

  3. 03

    List bulk data

    Provides a list of all available bulk data files.

  4. 04

    List sets

    Returns a list of all Magic: The Gathering sets.

Capability set02 / 05

05-08

4 capabilities in this set.

Part of 19 available through Scryfall.

  1. 05

    List symbology

    Lists all available card symbols used in the game.

  2. 06

    Get rulings by ID

    Fetches official judge rulings for a specific card via its Scryfall ID.

  3. 07

    Parse mana

    Converts mana strings into a structured format.

  4. 08

    Get bulk data by type

    Retrieves a specific type of bulk data file.

Capability set03 / 05

09-12

4 capabilities in this set.

Part of 19 available through Scryfall.

  1. 09

    Autocomplete cards

    Suggests card names as you type to help find the right match.

  2. 10

    Get card by arena ID

    Finds card data using a specific Arena ID.

  3. 11

    Get card by ID

    Fetches full card details using a Scryfall ID.

  4. 12

    Get card by mtgo ID

    Retrieves card information using an MTGO ID.

Capability set04 / 05

13-16

4 capabilities in this set.

Part of 19 available through Scryfall.

  1. 13

    Get card by multiverse ID

    Gets card data using a Multiverse ID.

  2. 14

    Get card by set number

    Locates a specific card using its set code and collector number.

  3. 15

    Get card named

    Finds a card using an exact or fuzzy name match.

  4. 16

    Get cards collection

    Gathers a group of cards based on various identifiers.

Capability set05 / 05

17-19

3 capabilities in this set.

Part of 19 available through Scryfall.

  1. 17

    Get catalog

    Accesses a catalog of various Magic data points.

  2. 18

    Get rulings by set number

    Retrieves rulings for cards within a specific set.

  3. 19

    Search cards

    Performs advanced searches for Magic cards using Scryfall syntax.

Real work

What teams actually run

01

Deck Optimization

Ask your agent to find all red creatures with flying to fill out a deck's requirements.

02

Rule Clarification

Check how a specific card's ability works during a complex game interaction.

03

Inventory Management

Retrieve specific collector numbers and set codes for a collection.

04

Data Integration

Use card identifiers to pull data into custom development projects.

Automate a task

Put Scryfall to work on one thing.

Step-by-step automations your AI runs through this Connector: the workflow, the prompts to start with, and the exact capabilities behind each move.

One connector, every AI

Scryfall works with the most popular AI clients.

These are the most popular clients, each with a step-by-step guide: one link, set up once, with governance and visibility built in. And because everything runs on the MCP standard, the same connection also works in any other compatible client — nothing to rebuild.

ClaudeClaudeChatGPTChatGPTGeminiGeminiPerplexityPerplexityGrokGrokMicrosoft CopilotMicrosoft CopilotCursorCursorVS CodeVS CodeWindsurfWindsurfJetBrainsJetBrainsClineClineLangChainLangChainVercel AI SDKVercel AI SDKLovableLovableZ.aiZ.aiRaycastRaycastQwen CodeQwen CodeKimi CodeKimi CodeLe ChatLe Chat

Building your own app? The connector is yours to use.

You don't need a client to put Scryfall to work: the same hosted connection plugs into your own applications and agent code, with the same governance on every request. Build with it, chat with it — one connection for both.

Observed, not estimated

1126ms average. Fast in production.

Scryfall is checked daily against the live service.

Daily averagePeak 1438ms
Oct 3Today
Fastest day
809ms
Slowest day
1438ms
14-day trend
Stable+2%

Connect your client

One URL. Every client.

Activate the Connector, copy your link, and paste it into the client you already use. 19 capabilities arrive ready to run.

Preview access · not provider authentication

The vk_preview_* token belongs to Vinkius preview infrastructure. It lets Claude discover and display the capabilities of Scryfall, so you can see the experience inside your AI.

It does not authenticate your account with Scryfall. Actions requiring credentials or live account data may not run until you activate the Connector and authorize the service.

Scryfall Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_YHXafJdvSmcoUPj7QX6uZC3nK3HUnHYIwLkewVdQ/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Scryfall capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "scryfall-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_YHXafJdvSmcoUPj7QX6uZC3nK3HUnHYIwLkewVdQ/mcp"
    }
  }
}
  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Step-by-step instructions for each client are in the guide. How to connect

Guided setup for Claude? Set up Scryfall in Claude and other AIs

See all the AI clients this connector works with ↑

Who it's for

Built for the work Scryfall owners hand off.

This MCP is built for anyone who interacts with the Magic: The Gathering ecosystem and needs fast, accurate data.

  • 01

    Deck Builders

    They ask the AI to find card synergies and check legality.

  • 02

    Collectors

    They use the AI to find collector numbers and set information for inventory.

  • 03

    Developers

    They pull card data directly into their coding environments via the IDE.

FAQ

Questions Scryfall owners ask.

  • 01

    What AI clients can I use with this Scryfall MCP?

    You can use this with any MCP-compatible client, including Claude, Cursor, Windsurf, and VS Code.

  • 02

    Do I need to know Scryfall syntax to search?

    No. While the capabilities support full Scryfall syntax, you can just talk to your agent in plain English and it will handle the search for you.

  • 03

    Can I find specific card rulings?

    Yes. The MCP includes capabilities to fetch official judge rulings and oracle text for specific cards.

  • 04

    How do I find cards from a specific set?

    You can ask your agent to list sets or use the capabilities to find cards by their set code and collector number.

  • 05

    Is this hosted by Vinkius?

    Yes. Vinkius hosts and manages the MCP, so you don't have to worry about running it locally or managing credentials.

  • 06

    Does the search capability support complex Scryfall syntax like 't:creature c:g cmc=3'?

    Yes! The search_cards capability accepts any valid Scryfall search query, allowing you to filter by type, color, mana cost, power/toughness, and more.

  • 07

    Can I find a card even if I don't remember the exact spelling of its name?

    Absolutely. Use the get_card_named capability with the fuzzy parameter. Scryfall's engine will suggest the closest match to your input.

  • 08

    How do I get the official rulings for a specific card interaction?

    You can use the get_rulings_by_id capability. By providing the card's Scryfall ID, the agent will return all official judge rulings and timing notes associated with that card.

Explore

More in Databases

Suggestions

Connect Scryfall to Claude, Cursor, ChatGPT & more