Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| NODE_ENV | No | Node environment (development or production) | development |
| LOG_LEVEL | No | Logging level (trace, debug, info, warn, error, fatal) | info |
| RATE_LIMIT_MS | No | Minimum milliseconds between API requests | 100 |
| HEALTHCHECK_DEEP | No | Enable deep health checks | false |
| SCRYFALL_TIMEOUT_MS | No | Timeout for Scryfall API requests in milliseconds | 15000 |
| SCRYFALL_USER_AGENT | No | User agent string for Scryfall API requests | ScryfallMCPServer/1.0 |
| RATE_LIMIT_QUEUE_MAX | No | Maximum size of the rate limiter queue | 500 |
Schema
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| analyze_card | Generate a comprehensive analysis of a Magic: The Gathering card including competitive viability, format positioning, synergies, and deck building suggestions |
| build_deck | Generate a deck building guide centered around a specific Magic: The Gathering card, including strategy, supporting cards, manabase, and sideboard suggestions |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| Card Database | Complete Scryfall bulk card database with daily updates |
| Set Database | Complete Magic: The Gathering sets database with metadata and icons |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| search_cards | Search for Magic: The Gathering cards using Scryfall search syntax. Supports complex queries with operators like color:, type:, set:, etc. |
| get_card | Get detailed information about a specific Magic: The Gathering card by name, set code+number, or Scryfall ID |
| get_card_prices | Get current price information for a Magic: The Gathering card by name, set/number, or Scryfall ID |
| random_card | Get a random Magic: The Gathering card, optionally filtered by format or search criteria |
| search_sets | Search for Magic: The Gathering sets with optional filtering by name, type, and release dates |
| query_rules | Search Magic: The Gathering comprehensive rules for specific interactions and rule clarifications |
| search_format_staples | Find format staples, meta cards, and role-specific cards for competitive play |
| search_alternatives | Find budget alternatives, upgrades, or functionally similar cards |
| find_synergistic_cards | Find cards that synergize with a specific card, theme, or archetype |
| batch_card_analysis | Analyze multiple cards for legality, prices, synergies, or deck composition |
| validate_brawl_commander | Validate if a card can be a legal commander in Brawl or Standard Brawl formats |
| build_scryfall_query | Convert natural language requests into optimized Scryfall search queries with explanations and alternatives |
| analyze_deck_composition | Analyze deck composition, mana curve, card types, and provide balance recommendations |
| suggest_mana_base | Suggest optimal mana base composition and land recommendations for a deck |