English Français العربية

io.github.gregario/lorcana-oracle

Official registry Search and web

Disney Lorcana TCG MCP server with card search, deck analysis, ink curves, and set browsing

Source code Documentation

What can you do with io.github.gregario/lorcana-oracle?

  • 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

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package lorcana-oracle
Claude Code 
claude mcp add lorcana-oracle -- npx -y lorcana-oracle@0.1.0
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "lorcana-oracle": {
            "command": "npx",
            "args": [
                "-y",
                "lorcana-oracle@0.1.0"
            ]
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. lorcana-oracle
  2. Features
  3. Installation
  4. Tools
  5. Data Source
  6. License

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

Frequently asked questions

What is io.github.gregario/lorcana-oracle?

Disney Lorcana TCG MCP server with card search, deck analysis, ink curves, and set browsing

How do I install io.github.gregario/lorcana-oracle?

It runs on your machine. In Claude Code: claude mcp add lorcana-oracle -- npx -y lorcana-oracle@0.1.0. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.gregario/lorcana-oracle need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is io.github.gregario/lorcana-oracle open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.gregario/lorcana-oracle?

It is published by gregario. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.