Scryfall

by cryppadotta

2 stars

Not rated

GitHub

About

Integrates with the Scryfall Magic: The Gathering API to enable card searches, retrieval of card details, rulings, and pricing information for deck building and game analysis.

Details

Author: cryppadotta
Repository: cryppadotta/scryfall-mcp
GitHub stars: 2
Categories: Search, Other, API, AI, Design, Developer Tools, Knowledge Base, Database, Infrastructure
Tags: #mobile

- search_cards
Perform a text-based search on Scryfall. Returns a list of matching cards.
- get_card_by_id
Retrieve a card directly via its Scryfall UUID.
- get_card_by_name
Retrieve a card by exact English name.
- random_card
Get a random card from the entire Scryfall database.
- get_rulings
Retrieve official rulings for a card, which may clarify card interactions or rules.
- get_prices_by_id
Retrieve current pricing information (USD, USD foil, EUR, TIX) for a given card by Scryfall ID.
- get_prices_by_name
Retrieve current pricing information (USD, USD foil, EUR, TIX) for a given card by exact name.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below
Plugin Name Scryfall

Command (node, npx, python, etc.) npx
Arguments
- Argument 1 scryfall-mcp-server
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "scryfall": {
            "command": "npx",
            "args": [
                "scryfall-mcp-server"
            ],
            "env": {},
            "shell": false
        }
    }
}

JSON

{
    "mcpServers": {
        "scryfall": {
            "command": "cmd",
            "args": [
                "/c",
                "npx",
                "scryfall-mcp-server"
            ],
            "env": {},
            "shell": true
        }
    }
}

JSON

{
    "mcpServers": {
        "scryfall": {
            "command": "npx",
            "args": [
                "scryfall-mcp-server"
            ],
            "env": {},
            "shell": false
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "scryfall": {
            "command": "npx",
            "args": [
                "scryfall-mcp-server"
            ],
            "env": {},
            "shell": false
        }
    }
}

JSON

{
    "mcpServers": {
        "scryfall": {
            "command": "cmd",
            "args": [
                "/c",
                "npx",
                "scryfall-mcp-server"
            ],
            "env": {},
            "shell": true
        }
    }
}

JSON

{
    "mcpServers": {
        "scryfall": {
            "command": "npx",
            "args": [
                "scryfall-mcp-server"
            ],
            "env": {},
            "shell": false
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "scryfall": {
            "command": "npx",
            "args": [
                "scryfall-mcp-server"
            ],
            "env": {},
            "shell": false
        }
    }
}

JSON

{
    "mcpServers": {
        "scryfall": {
            "command": "cmd",
            "args": [
                "/c",
                "npx",
                "scryfall-mcp-server"
            ],
            "env": {},
            "shell": true
        }
    }
}

JSON

{
    "mcpServers": {
        "scryfall": {
            "command": "npx",
            "args": [
                "scryfall-mcp-server"
            ],
            "env": {},
            "shell": false
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "scryfall": {
            "command": "npx",
            "args": [
                "scryfall-mcp-server"
            ],
            "env": {},
            "shell": false
        }
    }
}

JSON

{
    "mcpServers": {
        "scryfall": {
            "command": "cmd",
            "args": [
                "/c",
                "npx",
                "scryfall-mcp-server"
            ],
            "env": {},
            "shell": true
        }
    }
}

JSON

{
    "mcpServers": {
        "scryfall": {
            "command": "npx",
            "args": [
                "scryfall-mcp-server"
            ],
            "env": {},
            "shell": false
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "scryfall": {
            "command": "npx",
            "args": [
                "scryfall-mcp-server"
            ],
            "env": {},
            "shell": false
        }
    }
}

JSON

{
    "mcpServers": {
        "scryfall": {
            "command": "cmd",
            "args": [
                "/c",
                "npx",
                "scryfall-mcp-server"
            ],
            "env": {},
            "shell": true
        }
    }
}

JSON

{
    "mcpServers": {
        "scryfall": {
            "command": "npx",
            "args": [
                "scryfall-mcp-server"
            ],
            "env": {},
            "shell": false
        }
    }
}

From the repository

The server can be run in two modes:

1. Standard stdio mode (default)
2. Server-Sent Events (SSE) mode with HTTP endpoints

Example snippet for stdio mode:

{
  "mcpServers": {
    "scryfall": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "mcp/scryfall"]
    }
  }
}

Or with npx:

{
  "mcpServers": {
    "scryfall": {
      "command": "npx",
      "args": ["scryfall-mcp-server"]
    }
  }
}

`search_cards`

Perform a text-based search on Scryfall. Returns a list of matching cards.

`get_card_by_id`

Retrieve a card directly via its Scryfall UUID.

`get_card_by_name`

Retrieve a card by exact English name.

`random_card`

Get a random card from the entire Scryfall database.

`get_rulings`

Retrieve official rulings for a card, which may clarify card interactions or rules.

`get_prices_by_id`

Retrieve current pricing information (USD, USD foil, EUR, TIX) for a given card by Scryfall ID.

`get_prices_by_name`

Retrieve current pricing information (USD, USD foil, EUR, TIX) for a given card by exact name.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "scryfall": {
            "command": "npx",
            "args": [
                "scryfall-mcp-server"
            ],
            "env": {},
            "shell": false
        }
    }
}

Macos

{
    "command": "npx",
    "args": [
        "scryfall-mcp-server"
    ],
    "env": [],
    "shell": false
}

Windows

{
    "command": "cmd",
    "args": [
        "/c",
        "npx",
        "scryfall-mcp-server"
    ],
    "env": [],
    "shell": true
}

Linux

{
    "command": "npx",
    "args": [
        "scryfall-mcp-server"
    ],
    "env": [],
    "shell": false
}

AModel Context Protocol (MCP)server for interacting with the ScryfallAPI. It provides tools to look up Magic: The Gathering card details, card rulings, and price information.

# Stdio mode npx scryfall-mcp-server # SSE mode npx scryfall-mcp-server --sse

Your application or environment (like Claude Desktop) can communicate directly via stdio with the server.

When running in SSE mode (with--sse), you can connect using the MCP CLI:

npx @wong2/mcp-cli --sse http://localhost:3000/sse

- SSE endpoint:http://localhost:3000/sse
- Message endpoint:http://localhost:3000/messages

Integration in claude_desktop_config.json

{ "mcpServers": { "scryfall": { "command": "docker", "args": ["run", "-i", "--rm", "mcp/scryfall"] } } }

{ "mcpServers": { "scryfall": { "command": "npx", "args": ["scryfall-mcp-server"] } } }

docker run -i --rm -p 3000:3000 mcp/scryfall --sse

Search global news using natural language. Webz.io News Search API returns the most relevant articles and content, with filters for source, country, language, date, sentiment, and category.

Search and display Pokemon Trading Card Game cards using the Pokemon TCG API.

Search the web using Kagi's search API

Unlock geospatial intelligence through Mapbox APIs like geocoding, POI search, directions, isochrones and more.

Interact & query with Meilisearch (Full-text & semantic search API)

One API for Search, Crawling, and Sitemaps

Discover public A2A agents on the Agently platform using its public API.

Integrate with the Amazon Product Advertising API to search for products and access product information.

Multi-provider search broker for AI agents. Routes across SearXNG, Brave, Serper, Tavily, and Exa with automatic fallback, RRF ranking, content extraction, and budget enforcement.

An MCP server using the AviationStack API to fetch real-time flight data including airline flights, airport schedules, future flights and aircraft types.

A search server for the Model Context Protocol (MCP) that uses the Baidu Wenxin API.

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

Scryfall

About

Details

Jump to

Setting up with Highlight

Setting up with Cursor

JSON

JSON

JSON

Setting up with Claude Desktop

JSON

JSON

JSON

Setting up with Windsurf

JSON

JSON

JSON

Setting up with Cline

JSON

JSON

JSON

Setting up with Goose

JSON

JSON

JSON

From the repository

`search_cards`

`get_card_by_id`

`get_card_by_name`

`random_card`

`get_rulings`

`get_prices_by_id`

`get_prices_by_name`

Claude Desktop / Cursor

Macos

Windows

Linux

Integration in claude_desktop_config.json

Install

About

Details

Jump to

Setting up with Highlight

From the repository

search_cards

get_card_by_id

get_card_by_name

random_card

get_rulings

get_prices_by_id

get_prices_by_name

Claude Desktop / Cursor

Macos

Windows

Linux

Integration in claude_desktop_config.json

Install

More like this

Sequential Thinking

Brave Search

Filesystem

EverArt

Google Drive

GitLab

`search_cards`

`get_card_by_id`

`get_card_by_name`

`random_card`

`get_rulings`

`get_prices_by_id`

`get_prices_by_name`