gregario/lorcana-oracle
๐ ๐ - Disney Lorcana TCG card search, deck analysis, ink curves, lore generation, and franchise browsing. 7 tools, 2,710 cards embedded.
Quick Install
{
"mcpServers": {
"gregario-lorcana-oracle": {
"command": "npx",
"args": [
"-y",
"gregario-lorcana-oracle"
]
}
}
}Using an AI coding agent (Claude Code, Cursor, etc.)? Copy a ready-made prompt that tells it to fetch the setup instructions and install this server for you.
Documentation Overview
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
npx lorcana-oracle
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):
{
"mcpServers": {
"lorcana-oracle": {
"command": "npx",
"args": ["-y", "lorcana-oracle"]
}
}
}
Claude Code
claude mcp add lorcana-oracle -- npx -y lorcana-oracle
Tools
search_cards
Search Disney Lorcana cards by name, rules text, or filters (ink color, type, rarity, set, cost range). Returns paginated results.
search_cards({ query: "Elsa", color: "Amethyst" })
search_cards({ type: "Song", cost_max: 3 })
search_cards({ query: "draw a card", rarity: "Legendary" })
browse_sets
List all Disney Lorcana sets, or drill into a specific set to see its metadata and cards.
browse_sets({})
browse_sets({ set_code: "1" })
character_versions
Show all printings/versions of a Disney Lorcana character across sets. Useful for comparing different versions of the same character.
character_versions({ character_name: "Elsa" })
character_versions({ character_name: "Mickey Mouse" })
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.
browse_franchise({})
browse_franchise({ franchise: "Frozen" })
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_ink_curve({ deck_list: "4 Elsa - Snow Queen\n4 Let It Go\n2 Hades - King of Olympus" })
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.
analyze_lore({ deck_list: "4 Elsa - Snow Queen\n4 Mickey Mouse - Brave Little Tailor" })
analyze_lore({ color: "Amber", min_lore: 3 })
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.
find_song_synergies({ card_name: "Let It Go" })
find_song_synergies({ card_name: "Elsa - Snow Queen" })
find_song_synergies({})
Data Source
Card data is sourced from LorcanaJSON (MIT license). LorcanaJSON provides comprehensive card data for all released Disney Lorcana sets.
Disney Lorcana is a product of Ravensburger. This project is not affiliated with or endorsed by Ravensburger or The Walt Disney Company. Card data usage follows the Ravensburger Community Code Policy.