lorcana-oracle
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
Related MCP server: lorcana-mcp
Installation
Quick start
npx lorcana-oracleCard 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-oracleTools
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.
License
Available Tools
7 toolsanalyze_ink_curveAnalyze Ink CurveA
Analyze a Disney Lorcana deck list for ink cost distribution, inkable ratio, and color balance. Paste a deck list to get curve analysis.
Inputs: deck_list (required).
analyze_loreAnalyze LoreA
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.
Inputs: deck_list, ink, cost_min, cost_max, +1 more.
browse_franchiseBrowse FranchiseA
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.
Inputs: franchise.
browse_setsBrowse SetsA
List all Disney Lorcana sets, or drill into a specific set to see its metadata and cards. Provide a set_code to see cards in that set.
Inputs: set_code.
character_versionsCharacter VersionsA
Show all printings/versions of a Disney Lorcana character across sets. Useful for comparing different versions of the same character.
Inputs: character_name (required).
find_song_synergiesFind Song SynergiesA
Find Disney Lorcana song synergies. Given a Song, find characters that can sing it (cost >= song cost). Given a Character, find songs they can sing (cost <= character cost). With no input, browse all songs with singer counts.
Inputs: card_name, ink.
search_cardsSearch CardsA
Search Disney Lorcana cards by name, rules text, or filters (ink color, type, rarity, set, cost range). Returns paginated results.
Inputs: query, ink, type, rarity, +5 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Each tool has a clear, distinct purpose. Even though analyze_ink_curve and analyze_lore both accept deck lists, they analyze different dimensions (ink curve vs. lore). browse_franchise and browse_sets browse by different facets. No substantial overlap exists.
Most tools use a verb_noun pattern (analyze_, browse_, find_, search_). The exception is 'character_versions', which is a noun phrase. This minor inconsistency lowers the score slightly.
With 7 tools, the server is well-scoped for a card game reference. Each tool serves a meaningful purpose without redundancy, and the number feels balanced for the domain.
The tool set covers core needs: card search, browsing by set/franchise, deck analysis (ink curve and lore), character versions, and song synergies. Minor gaps like collection tracking or meta analysis exist but are outside the stated purpose.
Maintenance
Related MCP Connectors
Official Score VI MCP server: intrinsic value, fundamentals, and a stock screener.
1Official remote MCP server for Archivist AI TTRPG campaign memory: characters, sessions, and more.
Market data tools for the MCP ecosystem: server stats, events, search, leaderboards, package trends.
Official MCP server for Lovable, the AI-powered full-stack app builder.
Related MCP Servers
- AlicenseAqualityDmaintenanceMagic: The Gathering MCP server with card search, rules lookup, deck analysis, and Commander intelligence145MIT
- AlicenseAqualityBmaintenanceAn MCP server for searching and aggregating Disney Lorcana cards, enabling card lookup, deck building, and statistical analysis.1029 PyPI1MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server that lets AI assistants look up Disney Lorcana TCG events, stores, and tournament data via the Ravensburger Play API.80 npm-
- AlicenseNot gradedqualityCmaintenanceMCP server for searching Flesh and Blood TCG cards, retrieving print variations, and browsing product catalogs via the CardVault API.MIT