cryppadotta/scryfall-mcp

A Model Context Protocol (MCP) server for interacting with the Scryfall API. It provides tools to look up Magic: The Gathering card details, card rulings, and price information.
## Features
searchcards
Perform a text-based search on Scryfall. Returns a list of matching cards.
getcardbyid
Retrieve a card directly via its Scryfall UUID.
getcardbyname
Retrieve a card by exact English name.
randomcard
Get a random card from the entire Scryfall database.
getrulings
Retrieve official rulings for a card, which may clarify card interactions or rules.
getpricesbyid
Retrieve current pricing information (USD, USD foil, EUR, TIX) for a given card by Scryfall ID.
getpricesbyname
Retrieve current pricing information (USD, USD foil, EUR, TIX) for a given card by exact name.
## Usage
The server can be run in two modes:
1. Standard stdio mode (default)
2. Server-Sent Events (SSE) mode with HTTP endpoints
### Using NPX
If you have Node.js installed locally:
bash
# Stdio mode
npx scryfall-mcp-server
# SSE mode
npx scryfall-mcp-server --sse
### Connecting to the Server
#### Stdio Mode
Your application or environment (like Claude Desktop) can communicate directly via stdio with the server.
#### SSE Mode
When running in SSE mode (with --sse), you can connect using the MCP CLI:
bash
npx @wong2/mcp-cli --sse http://localhost:3000/sse
The server will be available at:
SSE endpoint: http://localhost:3000/sse
Message endpoint: http://localhost:3000/messages
### Integration in claudedesktopconfig.json
Example snippet for stdio mode:
json
"mcpServers": {
"scryfall": {
"command": "docker",
"args": ["run", "-i", "--rm", "mcp/scryfall"]
Or with npx:
json
"mcpServers": {
"scryfall": {
"command": "npx",
"args": ["scryfall-mcp-server"]
### Building from Docker
bash
docker build -t mcp/scryfall .
Then you can run in stdio mode:
bash
docker run -i --rm mcp/scryfall
Or in SSE mode: