lorcana-oracle is an MCP server for the Disney Lorcana TCG, powered by data from LorcanaJSON. Its main purposes are card search, deck analysis, and browsing Disney franchises.
Main capabilities
- search_cards: Search for cards by name, rules text, ink color, type, rarity, set, or cost range, returning paginated results.
- browse_sets: List all sets, or drill into a specific set to view its metadata and cards.
- character_versions: View all printed versions of a character across different sets, making it easy to compare different versions of the same character.
- browse_franchise: Browse cards by Disney franchise (such as Frozen, Moana, etc.); when no franchise name is provided, list all franchises and their card counts; when a franchise name is provided, show cards and statistics.
- analyze_ink_curve: Analyze a deck's ink cost distribution, playable ink ratio, and color balance; paste a deck list to get curve analysis.
- analyze_lore: Analyze Lore generation in a deck, or find the cards with the highest Lore generation. In deck mode, show total Lore potential and efficiency rankings; in query mode, show top Lore generation cards, with optional filters.
- find_song_synergies: Find song synergies. Given a song, find the characters that can sing it; given a character, find the songs it can sing; with no input, browse all songs and their singer counts.
How to use Card data (about 2,710 cards) is bundled with the package, with no download or API key required. It can be added to your Claude Desktop configuration file for use, with the configuration file path at ~/Library/Application Support/Claude/claude_desktop_config.json.
Use cases Suitable for Lorcana players doing card lookup, deck-building analysis (ink curve, Lore efficiency, color balance), character version comparison, browsing cards by Disney franchise, and finding synergy relationships between songs and singing characters.
Data sources and limitations Card data comes from LorcanaJSON (MIT License). Disney Lorcana is a product of Ravensburger, and this project is not affiliated with Ravensburger or The Walt Disney Company, nor is it endorsed by them. Use of card data follows the Ravensburger community guidelines policy.
