About lorcana-oracle
lorcana-oracle is an MCP server for Disney Lorcana card search, deck analysis, and franchise browsing. It uses bundled LorcanaJSON card data and offers tools for examining card versions, deck metrics, and song synergies.
Key features
- 01Search cards with text and attribute filters
- 02Browse sets and franchise cards
- 03Compare character printings across sets
- 04Analyze deck ink curves and lore
- 05Find song and character synergies
Use cases
- 01Find cards by rules text, cost, or rarity
- 02Review ink balance in a deck list
- 03Identify cards with high lore generation
- 04Check which characters can sing a song
MCP support
Exposes Disney Lorcana card search, browsing, deck analysis, and synergy tools to MCP clients.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMElorcana-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.
License
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.