Scryfall Connector for AI agents.

19 live capabilities

Search Magic: The Gathering cards and rulings instantly.

Live agent request Scryfall / Connector

Waiting for input…

AI Agent

Why people use Scryfall

Scryfall for Magic: The Gathering Card Search

With this Connector, that process disappears. Your AI agent acts as a master librarian. You just ask a question like 'Is this card legal in Commander?' and the agent pulls the ruling instantly. You get the answer you need in seconds without ever leaving your workspace.

What Vinkius changes

Your AI becomes a real-time Magic: The Gathering database.

Use it from Claude, ChatGPT, Cursor or another AI client you already have.

One account · 5,900+ Connectors

Real-world use case 01

Finding specific card synergies

A player wants to find all red dragons with 5 mana or less.
Real-world use case 02

Settling a rules dispute

A player asks about a weird interaction between two cards.
Real-world use case 03

Verifying collector numbers

A collector wants to know the exact set code for a vintage card.

Complete set · 19capabilities

The complete Scryfall capability set.

These are the exact actions your AI can choose when you ask it to work with Scryfall.

Capability set01 / 05

01—04

4 capabilities in this set.

Part of 19 available through Scryfall.

01 Capability
Get card by mtgo id
Retrieve card data using its MTGO ID. This helps players who primarily use the MTGO platform.
02 Capability
Search cards
Run complex searches for cards using full Scryfall syntax. You can filter by color, type, rarity, and more.
03 Capability
Get set by code
Get all details for a specific set using its code. This provides a quick overview of an entire expansion.
04 Capability
Get set by id
Fetch set information using its unique Scryfall ID. Use this to get deep data on a specific set.

Capability set02 / 05

05—08

4 capabilities in this set.

Part of 19 available through Scryfall.

05 Capability
Get card by multiverse id
Get details for a card using its Multiverse ID. This is great for tracking specific card instances.
06 Capability
Get card by set number
Find a card using its set code and collector number. This is the most precise way to find a specific printing.
07 Capability
Get catalog
View a full list of available Magic data points. Use this to see what kind of information the database holds.
08 Capability
Get cards collection
Pull a group of cards based on various identifiers. This is great for checking multiple cards at once.

Capability set03 / 05

09—12

4 capabilities in this set.

Part of 19 available through Scryfall.

09 Capability
List bulk data
See all available bulk data files for the database. It's a good starting point for data mining.
10 Capability
List sets
View every Magic: The Gathering set in history. Use this to browse through the game's entire release timeline.
11 Capability
List symbology
See all the different card symbols used in the game. This helps you identify specific expansion marks.
12 Capability
Get card named
Find a card using its exact or fuzzy name. It handles typos so you don't have to worry about perfect spelling.

Capability set04 / 05

13—16

4 capabilities in this set.

Part of 19 available through Scryfall.

13 Capability
Parse mana
Convert a mana string into a structured format. This is useful for processing card costs in code.
14 Capability
Get rulings by id
Get the official judge rulings for a specific Scryfall ID. This settles arguments about complex card interactions.
15 Capability
Get rulings by set number
Fetch rulings for a card using its set code and collector number. This ensures you get the correct ruling for that version.
16 Capability
Autocomplete cards
Get card name suggestions as you type a title. This helps you find the right card quickly without perfect spelling.

Capability set05 / 05

17—19

3 capabilities in this set.

Part of 19 available through Scryfall.

17 Capability
Get bulk data by type
Download specific bulk data files for large scale analysis. It's useful for developers needing massive datasets.
18 Capability
Get card by arena id
Look up a card's details using its Arena ID. This is perfect for players using the Arena platform.
19 Capability
Get card by id
Fetch specific card info using its Scryfall ID. Use this when you have a direct link to a card's data.

Set up in minutes

One URL. Then ask Scryfall to work.

Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use Scryfall from the conversation.

Choose your client

Live preview

Advanced clients IDE · CLI

Claude · Web + desktop

Official guide ↗

Connector URL · ready to paste

Streamable HTTP

https://edge.vinkius.com/vk_preview_YHXafJdvSmcoUPj7QX6uZC3nK3HUnHYIwLkewVdQ/mcp

Step 01

Open Connectors

In Claude Web or Claude Desktop, open Settings and choose Connectors.
Step 02

Add the URL

Choose Add custom connector, name it Scryfall, and paste the URL above.
Step 03

Turn it on in chat

Select +, open Connectors, and enable Scryfall for the conversation.

ChatGPT · Web + desktop

Official guide ↗

Connector URL · ready to paste

Streamable HTTP

https://edge.vinkius.com/vk_preview_YHXafJdvSmcoUPj7QX6uZC3nK3HUnHYIwLkewVdQ/mcp

Step 01

Open MCP settings

On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
Step 02

Add the URL

Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the Scryfall URL.
Step 03

Save and start

Save the connection and enable Scryfall in your conversation. Desktop may ask you to restart once.

Cursor · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "scryfall": {
      "url": "https://edge.vinkius.com/vk_preview_YHXafJdvSmcoUPj7QX6uZC3nK3HUnHYIwLkewVdQ/mcp"
    }
  }
}

Step 01

Open MCP Settings

Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
Step 02

Add the server config

Paste the JSON configuration above into the mcp.json file that opens
Step 03

Save the file

Cursor will automatically detect the new Connector
Step 04

Start using Scryfall

Open Agent mode in chat and ask: "Using Scryfall, help me...". 19 tools available

VS Code Copilot · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "scryfall": {
      "url": "https://edge.vinkius.com/vk_preview_YHXafJdvSmcoUPj7QX6uZC3nK3HUnHYIwLkewVdQ/mcp"
    }
  }
}

Step 01

Create MCP config

Create a .vscode/mcp.json file in your project root
Step 02

Add the server config

Paste the JSON configuration above
Step 03

Enable Agent mode

Open GitHub Copilot Chat and switch to Agent mode using the dropdown
Step 04

Start using Scryfall

Ask Copilot: "Using Scryfall, help me...". 19 tools available

Windsurf · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "scryfall": {
      "url": "https://edge.vinkius.com/vk_preview_YHXafJdvSmcoUPj7QX6uZC3nK3HUnHYIwLkewVdQ/mcp"
    }
  }
}

Step 01

Open MCP Settings

Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
Step 02

Add the server

Paste the JSON configuration above into mcp_config.json
Step 03

Save and reload

Windsurf will detect the new server automatically
Step 04

Start using Scryfall

Open Cascade and ask: "Using Scryfall, help me...". 19 tools available

Cline · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "scryfall": {
      "url": "https://edge.vinkius.com/vk_preview_YHXafJdvSmcoUPj7QX6uZC3nK3HUnHYIwLkewVdQ/mcp"
    }
  }
}

Step 01

Open Cline MCP Settings

Click the Connectors icon in the Cline sidebar panel
Step 02

Add remote server

Click "Add Connector" and paste the configuration above
Step 03

Enable the server

Toggle the server switch to ON
Step 04

Start using Scryfall

Ask Cline: "Using Scryfall, help me...". 19 tools available

Claude Code · Terminal command

Official guide ↗

Advanced setup

claude mcp add scryfall --transport http "https://edge.vinkius.com/vk_preview_YHXafJdvSmcoUPj7QX6uZC3nK3HUnHYIwLkewVdQ/mcp"

Step 01

Install Claude Code

Run npm install -g @anthropic-ai/claude-code if not already installed
Step 02

Add the Connector

Run the command above in your terminal
Step 03

Verify the connection

Run claude mcp to list connected servers, or type /mcp inside a session
Step 04

Start using Scryfall

Ask Claude: "Using Scryfall, show me...". 19 tools are ready

Where the request belongs

Work Scryfall can move forward.

Built around the request

This is for the MTG player who spends too much time in browser tabs or the collector trying to verify large inventories.

01

Deck Builder

Checks card synergies and official rulings while drafting new strategies in a chat window.

02

TCG Collector

Verifies set codes and collector numbers for inventory management without manual searching.

03

Game Developer

Pulls card data into custom capabilities or coding projects directly via an AI interface.

Build the capability set

Each Connector adds new actions and data without changing how you work.

Browse Connectors

01 6 capabilities

Yu-Gi-Oh

Access the ultimate Yu-Gi-Oh! database. search for cards, explore archetypes, and check set lists directly from your AI agent.

02 8 capabilities

Pokemon TCG

Search and browse the entire Pokemon Trading Card Game database. find specific cards, explore sets, and filter by types or rarities.

03 12 capabilities

Open5e

Access the comprehensive Open5e database for D&D 5th Edition. search monsters, spells, classes, and magic items directly from your AI agent.

04 6 capabilities

TarotAPI

Draw tarot cards, get readings, and explore card meanings via AI.

05 3 capabilities

Tarot Card Drawer

A cryptographically secure random generator for Tarot card draws, spreads, and deck analysis.

06 4 capabilities

Card Draw Probability Calculator

Calculate the mathematical likelihood of drawing specific cards in TCGs like Magic: The Gathering or Yu-Gi-Oh.

Bring your own AI

Change the model, client or framework. Keep Scryfall connected.

Before you connect

Questions about Scryfall.

The practical details behind the request, access and result.

Can Scryfall MCP find cards even if I misspell the name?

Yes, it uses fuzzy matching to find cards. Even if you have a typo, the agent will look for the closest match in the database to give you the right info.

Does Scryfall MCP include official judge rulings?

Yes, it can pull official rulings for specific cards. This is helpful for settling complex gameplay questions or verifying card interactions.

Can I use Scryfall MCP to build a deck?

It's excellent for deck building. You can ask your agent to find cards based on specific attributes like mana cost, color, or card type to help you brainstorm.

Does Scryfall MCP cover the entire history of Magic: The Gathering?

Yes, it provides access to the history of the game, including set data and card information from both vintage and modern releases.

Can Scryfall MCP retrieve cards using different IDs like Arena or MTGO?

Yes, it can fetch card data using several different identifiers, including Scryfall IDs, Arena IDs, and MTGO IDs.

Is Scryfall MCP good for checking collector numbers?

Yes, it can retrieve specific set codes and collector numbers. This makes it a great capability for collectors who need to verify exact card printings.

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.

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.

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.

One connection away

Give your agent a direct line to Scryfall.

Connect Scryfall once. Keep it beside 5,900+ managed Connectors when the next task needs more.

Explore every Connector No credit card required · Free tier available