Log inSubmit server
Lorcana Oracle logo

Lorcana Oracle

by gregario

Search and analyze Disney Lorcana cards and decks locally through seven MCP tools backed by 2,710 bundled cards.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Lorcana Oracle

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "gregario-lorcana-oracle": {
      "command": "npx",
      "args": [
        "-y",
        "lorcana-oracle"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

We couldn’t confirm it starts correctly

We ran the install command but it didn't respond within our test window — this can mean a slow first-time install rather than a real problem.

npx -y lorcana-oracle

No response to initialize.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 1mo ago.

Overview

The gregario/lorcana-oracle MCP server exposes Disney Lorcana card search, set and franchise browsing, character version comparisons, deck analysis, and song-singer lookups. It uses card data bundled from LorcanaJSON, so setup requires no downloads or API keys after installation. Reach for it when an agent needs structured Lorcana card details, deck ink-curve or lore analysis, or relationships between songs and characters. The package runs through Node.js and can be configured for Claude Desktop.

Use cases

  • Search Lorcana cards by rules text, color, rarity, set, or cost
  • Analyze a deck's ink curve and color balance
  • Compare character printings across Lorcana sets
  • Find characters who can sing a selected song
  • Browse cards by Disney franchise

Key features

  • Card search with filters and pagination
  • Set and franchise browsing
  • Character version comparison
  • Ink-curve and lore analysis
  • Song and character synergy lookup
  • Bundled data with no API key

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

5/5 checks healthy over the last 79d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 9d ago via OSV.dev · lorcana-oracle (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars4Stargazers on the source repository.
npm downloads234Package downloads in the last 30 days.
Last commit4mo agoMost recent push to the default branch.
Install checkInconclusiveDidn't respond in our test window — often a slow first install.
Directory activity4 viewsConfig copies, upvotes, and views on AllMCPs.

How Lorcana Oracle works

What gregario/lorcana-oracle MCP server does

The gregario/lorcana-oracle MCP server provides seven tools for working with Disney Lorcana Trading Card Game data. Its data set contains about 2,710 cards bundled with the npm package and sourced from LorcanaJSON. The package is intended for local MCP use rather than access to a remote card API, and it does not require an API key or a separate data download.

Card discovery is handled by search_cards, which accepts free-text searches and filters such as ink color, card type, rarity, set, and cost bounds. browse_sets lists available sets or returns the cards and metadata for a selected set. character_versions groups a character’s printings across sets, while browse_franchise lists Disney franchises or shows cards and statistics for a selected franchise.

The remaining tools work with deck and card relationships. analyze_ink_curve examines a supplied deck list for ink-cost distribution, the proportion of inkable cards, and color balance. analyze_lore either evaluates lore potential and efficiency in a deck list or identifies high-lore cards with optional filters. find_song_synergies looks up characters who can sing a specified song, songs a specified character can sing, or all songs with singer counts.

How it works

The gregario/lorcana-oracle MCP server is distributed as the lorcana-oracle npm package. Running it with npx starts the MCP server locally. Its tools accept structured arguments, including card names, set codes, franchise names, colors, minimum or maximum costs, and multiline deck lists. Search results are paginated, according to the project documentation.

Deck-analysis tools expect card entries in a deck-list format such as a quantity followed by a card name. The examples use entries like 4 Elsa - Snow Queen and 4 Let It Go. Song lookup can be used with a card name or with no card name to browse songs.

Setup and configuration

Node.js 18 or later is required. The documented quick-start command is:

Terminal
npx -y lorcana-oracle

For Claude Desktop, add a server entry with npx as the command and -y lorcana-oracle as its arguments. The project also documents an equivalent Claude Code registration command. No environment variables, credentials, or paid service account are specified.

The package is licensed under MIT. LorcanaJSON is also identified as MIT-licensed in the data-source notes. The project states that Disney Lorcana belongs to Ravensburger and that the project is not affiliated with or endorsed by Ravensburger or The Walt Disney Company.

Tools and capabilities

  • Search cards by text and card attributes, including color, type, rarity, set, and cost range.
  • List sets or inspect the cards associated with a set code.
  • Compare a character’s versions across released sets.
  • Browse franchise groupings and franchise card statistics.
  • Calculate deck ink curves, inkable ratios, and color balance.
  • Analyze deck lore potential or find cards with high lore values.
  • Find song and character singing relationships.

Limitations and notes

The gregario/lorcana-oracle MCP server is focused on the card data and analyses exposed by its seven tools. Its card inventory is the data bundled from LorcanaJSON, covering approximately 2,710 cards at the time described by the project.

The tools depend on correctly formatted names and deck lists for useful results. The README provides examples for common inputs but does not specify a full deck-list grammar or describe how frequently the bundled data is updated.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Lorcana Oracle

Install and run it with Node.js 18 or later using `npx -y lorcana-oracle`. The package includes its card data and does not require an API key.

Yes. The README provides a Claude Desktop configuration using `npx` with `-y lorcana-oracle` as the arguments.

Its `search_cards` tool searches by name or rules text and can filter by ink color, type, rarity, set, and cost range.

Yes. `analyze_ink_curve` reports ink-cost distribution, inkable ratio, and color balance, while `analyze_lore` evaluates lore potential or finds high-lore cards.

Related MCP servers

All in Gaming All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewLorcana Oracle AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/gregario-lorcana-oracle?style=directory)](https://allmcps.com/mcp/gregario-lorcana-oracle)
HTML Embed
<a href="https://allmcps.com/mcp/gregario-lorcana-oracle"><img src="https://allmcps.com/api/badge/gregario-lorcana-oracle?style=directory" alt="Lorcana Oracle on AllMCPs" /></a>