io.github.gregario/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

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

MIT