gregario/lorcana-oracle

Disney Lorcana TCG MCP server -- card search, deck analysis, and franchise browsing powered by LorcanaJSON.
Features
- **search_cards** -- Search cards by name, rules text, ink color, type, rarity, set, or cost range
- **browse_sets** -- List all sets or drill into a specific set to see its cards
- **character_versions** -- Compare all printings of a character across sets
- **browse_franchise** -- Browse cards by Disney franchise (Frozen, Moana, etc.)
- **analyze_ink_curve** -- Analyze a deck list for ink cost distribution, inkable ratio, and color balance
- **analyze_lore** -- Analyze lore generation in a deck or find top lore-generating cards
- **find_song_synergies** -- Find which characters can sing a song, or which songs a character can sing
Installation
Quick start
Card data (~2,710 cards) is bundled with the package. No downloads or API keys needed.
Claude Desktop
Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):
Claude Code
Tools
search_cards
Search Disney Lorcana cards by name, rules text, or filters (ink color, type, rarity, set, cost range). Returns paginated results.
browse_sets
List all Disney Lorcana sets, or drill into a specific set to see its metadata and cards.
character_versions
Show all printings/versions of a Disney Lorcana character across sets. Useful for comparing different versions of the same character.
browse_franchise
Browse Disney Lorcana cards by franchise (story). Without a franchise name, lists all franchises with card counts. With a franchise name, shows cards and statistics.
analyze_ink_curve
Analyze a Disney Lorcana deck list for ink cost distribution, inkable ratio, and color balance. Paste a deck list to get curve analysis.
analyze_lore
Analyze lore generation in a deck list, or find the top lore-generating cards. In deck mode, shows total lore potential and efficiency ranking. In query mode, shows top lore generators with optional filters.
find_song_synergies
Find Disney Lorcana song synergies. Given a Song, find characters that can sing it. Given a Character, find songs they can sing. With no input, browse all songs with singer counts.