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

lorcana oracle