Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| PORT | No | Port for SSE server | 3000 |
| CORS_ORIGIN | No | CORS origin for SSE server (optional) | |
| SCRYFALL_BASE_URL | No | Override the base API URL (defaults to https://api.scryfall.com) | https://api.scryfall.com |
Schema
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| search_cards | Search cards using Scryfall's powerful full-text syntax. |
| search_by_colors | Find cards by colors or color identity. |
| search_by_cmc | Find cards within a mana value range, optionally filtered by color and type. |
| search_by_format | Find cards by legality in a given format. |
| get_card | Get a single card by Scryfall UUID or by name (exact/fuzzy). |
| random_card | Fetch a random card, optionally filtered by a 'q' search query. |
| autocomplete | Autocomplete card names based on a partial query. |
| list_sets | List all sets available on Scryfall. |
| get_rulings | Get official rulings for a card by Scryfall UUID. |
| list_tagger_tags | Fetches Scryfall Tagger tag names from the public docs page. |
| read_tagger_cache | Read tags from local cache file without network. |
| refresh_tagger_tags | Force refresh Tagger tags from docs and write local cache. |
| search_by_function_tag | Find cards using Tagger function (oracle) tags, e.g. removal, ramp. |
| search_by_art_tag | Find cards using Tagger artwork tags, e.g. squirrel, dragon, wizard. |
| csb_parse_deck_text | Parse a plain-text decklist into cards using Commander Spellbook. |
| csb_find_combos_by_card_ids | Find combos that the provided cards enable (exact and almost-included). |
| csb_variants_search | Search Commander Spellbook variants (combos) by filters like uses/produces. |
| csb_card | Fetch Commander Spellbook card by numeric ID. |
| csb_build_card_index | Rebuild oracleId→CSB id index and write cache. |
| csb_read_card_index | Read oracleId→CSB id index from local cache. |
| csb_lookup_by_oracle_ids | Map Scryfall oracle_id UUIDs to Commander Spellbook numeric IDs using the local index (builds if stale). |
| csb_find_combos_by_names | Resolve names via Scryfall → oracle_id, map to CSB IDs via cached index, then call find-my-combos. |