# Scryfall MCP for AI Agents AI Agent Connect

> Scryfall MCP gives your AI agent direct access to the most complete Magic: The Gathering database. You can search for specific cards, check judge rulings, and pull set data instantly. It's the go-to tool for anyone who needs accurate MTG information without leaving their chat interface.

## Overview
- **Category:** databases
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_YHXafJdvSmcoUPj7QX6uZC3nK3HUnHYIwLkewVdQ/ai-agent-connect
- **Tags:** magic-the-gathering, mtg, card-database, trading-card-game, scryfall

## Description

Scryfall is the gold standard for Magic: The Gathering data. When you connect this Connector, your AI agent gains the ability to browse the entire history of the game without you having to leave your workspace. Instead of hunting through browser tabs to find a specific card's mana cost or checking if a card is legal in a certain format, you just ask. The agent pulls the info directly from the source. This is a massive win for deck builders who need to check synergies on the fly or collectors who need to verify specific collector numbers and set codes. It even handles official judge rulings to settle arguments during a game. Because Vinkius hosts this, you can get it running in minutes and have a master librarian for the multiverse at your fingertips. It handles the complex syntax of card searches so you can focus on the game. You won't have to worry about manual lookups or keeping a separate spreadsheet of card IDs. Whether you're trying to find a specific card from a 2023 release or looking for the oracle text of a vintage card, the agent does the digging for you. It turns a tedious research process into a simple conversation.

## Tools

### get_card_by_mtgo_id
Retrieve card data using its MTGO ID. This helps players who primarily use the MTGO platform.

### search_cards
Run complex searches for cards using full Scryfall syntax. You can filter by color, type, rarity, and more.

### get_set_by_code
Get all details for a specific set using its code. This provides a quick overview of an entire expansion.

### get_set_by_id
Fetch set information using its unique Scryfall ID. Use this to get deep data on a specific set.

### get_card_by_multiverse_id
Get details for a card using its Multiverse ID. This is great for tracking specific card instances.

### 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.

### get_catalog
View a full list of available Magic data points. Use this to see what kind of information the database holds.

### get_cards_collection
Pull a group of cards based on various identifiers. This is great for checking multiple cards at once.

### list_bulk_data
See all available bulk data files for the database. It's a good starting point for data mining.

### list_sets
View every Magic: The Gathering set in history. Use this to browse through the game's entire release timeline.

### list_symbology
See all the different card symbols used in the game. This helps you identify specific expansion marks.

### 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.

### parse_mana
Convert a mana string into a structured format. This is useful for processing card costs in code.

### get_rulings_by_id
Get the official judge rulings for a specific Scryfall ID. This settles arguments about complex card interactions.

### 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.

### autocomplete_cards
Get card name suggestions as you type a title. This helps you find the right card quickly without perfect spelling.

### get_bulk_data_by_type
Download specific bulk data files for large scale analysis. It's useful for developers needing massive datasets.

### get_card_by_arena_id
Look up a card's details using its Arena ID. This is perfect for players using the Arena platform.

### 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.

## Prompt Examples

**Prompt:** 
```
Search for all legendary dragons that are red and cost 5 mana or less.
```

**Response:** 
```
I found several cards matching your criteria, including **Lathliss, Dragon Queen** and **Rith, Liberated Primeval**. 

Here are some details:
* **Lathliss, Dragon Queen**: A powerful red legendary dragon.
* **Rith, Liberated Primeval**: A high-impact legendary dragon.

Would you like to see the full details for any of these?
```

**Prompt:** 
```
Get the card details for 'Sol Ring'.
```

**Response:** 
```
**Sol Ring** is a legendary artifact that costs 1 generic mana. 

**Abilities:**
* {T}: Add {C}{C}

**Sets:** It has been printed in many sets, including Alpha and Commander editions. It is one of the most iconic pieces of mana acceleration in the game.
```

**Prompt:** 
```
List all Magic: The Gathering sets released in 2023.
```

**Response:** 
```
In 2023, Scryfall records several major releases:

| Set Name | Code |
| :--- | :--- |
| **Phyrexia: All Will Be One** | ONE |
| **March of the Machine** | MOM |
| **Wilds of Eldraine** | WOE |

Would you like more details on any of these specific expansions?
```

## Capabilities

### Search cards with complex filters
Find specific cards using criteria like color, mana cost, type, or oracle text.

### Retrieve official judge rulings
Get the official word on card interactions and complex gameplay rules.

### Fetch expansion and set data
Pull details on specific Magic sets, codes, and historical release info.

### Find cards by multiple IDs
Get card data using Scryfall, Arena, MTGO, or Multiverse identifiers.

### Identify card symbols and types
Access a full catalog of card symbols and data points from the database.

## Use Cases

### Finding specific card synergies
A player wants to find all red dragons with 5 mana or less. The agent uses search_cards to provide a list of matching options.

### Settling a rules dispute
A player asks about a weird interaction between two cards. The agent uses get_rulings_by_id to provide the official judge ruling.

### Verifying collector numbers
A collector wants to know the exact set code for a vintage card. The agent uses get_card_by_set_number to pull the data.

### Exporting set data
A developer needs a list of all Magic sets released in 2023. The agent uses list_sets to pull the full list of releases.

## Benefits

- Stop tab-switching by using search_cards to find specific cards with complex filters like color, mana cost, or card type.
- Resolve tricky gameplay questions immediately by using get_rulings_by_id to fetch official judge rulings.
- Build better decks by using get_cards_collection to pull multiple cards at once for analysis.
- Manage your inventory accurately by using get_card_by_set_number to find specific collector numbers and set codes.
- Streamline development by using list_bulk_data to access large datasets for custom projects or apps.
- Verify card identities quickly using get_card_named to handle typos or fuzzy matches in your queries.

## How It Works

The bottom line is your AI becomes a real-time Magic: The Gathering database.

1. Subscribe to the Scryfall MCP on Vinkius.
2. Enter your optional User-Agent in the configuration.
3. Ask your AI client to find cards, rulings, or set information.

## Frequently Asked Questions

**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 tool for collectors who need to verify exact card printings.

**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.