danielenricocahall/lorcana-mcp

An MCP server that lets Claude (or any MCP client) search, analyze, and build decks for the
**Disney Lorcana TCG**. Ask for cards in plain English, get rules-checked deck validation, ink
curves and keyword breakdowns, and round-trip deck lists with Dreamborn/Pixelborn.
**2,506 unique cards** (3,192 printings including alternate arts and promos), refreshed daily.
No API key, no database, no rate limits — the server ships against a snapshot published from
our own pipeline, so it never depends on a third-party API being up at query time.
Tools
| Tool | What it does |
|---|---|
| search_cards | Filter and retrieve cards by name, color, cost, rarity, type, keyword, stats, set, and body text. Supports response_format="toon" for ~10% fewer tokens |
| count_cards | Count cards matching a filter without paying for the card objects |
| aggregate_cards | Group counts by cost (ink curve), rarity, color, set_code, or type |
| resolve_card | Fuzzy-match an informal, partial, or misspelled card name to the closest cards |
| top_traits | Most common traits (Storyborn, Hero, Villain, Ally, ...) across all cards |
| validate_deck | Check a deck against format rules (≥60 cards, max 4 copies, ≤2 inks, dual-ink requirements); returns {legal, total_cards, inks, violations} |
| deck_stats | Ink curve, color split, inkable count, type breakdown, keyword counts, subtype counts, and per-card keyword tags |
| import_deck | Parse a Dreamborn/Pixelborn deck list into resolved cards, with fuzzy candidates for unresolved lines |
| export_deck | Render a deck back out as a Dreamborn/Pixelborn-compatible text list |
| server_status | Startup metadata (card count, configuration) |
Install
uvx (recommended — no clone, no Docker)
Claude Desktop / claude_desktop_config.json:
Claude CLI:
pip / pipx
Docker
The server is also published to GHCR
and the MCP Registry.
To persist the card cache across container restarts, mount a volume:
From a clone
No port is exposed; MCP communication is over stdio.
Example questions
Once connected to an MCP client, you can ask natural language questions like:
**Card lookup**
- "Show me all cards named Moana"
- "What does the card Maui - Hero to All do?"
- "Find all legendary amber cards"
**Deck building**
- "What are the cheapest ruby characters with at least 3 strength?"
- "Show me inkable sapphire cards that cost 4 or less"
- "Find steel characters with 5 or more willpower"
- "What 3-lore characters exist in emerald?"
**Keyword & ability search**
- "How many Singer cards cost exactly 5?"
- "How many Evasive characters are there in the first set?"
- "How many ruby cards have Reckless?"
- "Find all cards with Ward in their text"
- "Show me Shift cards in amethyst"
**Stats & aggregations**
- "How many cards are in each set?"
- "What's the color distribution across all cards?"
- "What are the most common traits?"
- "Show me the ink curve — how many cards exist at each cost?"
- "How many legendary cards are inkable?"
**Cross-filter queries**
- "How many amber characters have 3 or more lore?"
- "Find cheap (cost 2-3) characters with high strength (4+) in steel"
- "How many cards in set 1 have Evasive and cost less than 4?"
> **Note:** For plain keyword queries (Evasive, Bodyguard, Shift, etc.) use the keyword parameter — it filters against the structured ability list and is more reliable than substring search. For value-specific queries like Singer 5 or Resist +2, use body_text (keyword values live in the card's full text, not the ability list).
MCP prompts
- build_deck(colors, playstyle="balanced") — guides the model through assembling a legal Lorcana deck (60-card minimum, ≤2 inks, max 4 copies of any card) for the requested color(s) and playstyle (aggressive / control / lore-race / balanced). Uses the search/aggregate tools above plus the rules embedded in the server instructions.