Scryfall

Provides access to Scryfall card data, rulings, and prices via MCP endpoints.

javascript

18

GitHub Stars

javascript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

You can run a Scryfall MCP Server to look up card data, rulings, and prices from within your own applications. This server exposes practical actions you’ll use to query the Scryfall database and integrate card information into your workflows or chat tools.

How to use

Use an MCP client to connect to the Scryfall MCP Server. The server supports stdio (local) and SSE access modes. In stdio mode, your client communicates directly with the server process. In SSE mode, you connect over HTTP endpoints to receive and send messages in real time.

How to install

Prerequisites: ensure you have Node.js installed if you plan to use npx commands, and Docker if you prefer running the server as a container.

Option A — Run via npm/npx (stdio mode) using npx.

# Stdio mode
npx scryfall-mcp-server

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

Connect to the server

In stdio mode, connect directly from your MCP client using the process’s standard input/output channels.

In SSE mode, use the MCP CLI to connect to the server’s SSE endpoint.

Example for SSE connection via MCP CLI (when the server is running with --sse):

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

Configuration examples for running the server locally

The following local configurations show two common ways to run the MCP server in stdio mode.

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

Alternative local run with NPX

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

Available tools

search_cards

Performs a text-based search on Scryfall and returns a list of matching cards.

get_card_by_id

Retrieves a card directly via its Scryfall UUID.

get_card_by_name

Retrieves a card by exact English name.

random_card

Returns a random card from the entire Scryfall database.

get_rulings

Fetches official rulings for a card to clarify interactions or rules.

get_prices_by_id

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

get_prices_by_name

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