lorcana-mcp 0.1.0

MCP server for enriching Disney Lorcana TCG card collections from TCGPlayer exports

lorcana-mcp

MCP server that connects Claude to Disney Lorcana card data. Give Claude your TCGPlayer collection export and it will enrich it with ink cost, stats, keywords, and abilities fetched from LorcanaJSON and lorcana-api.com.

What it does

Three tools are available in Claude once the server is running:

Tool	What it does
enrich_csv	Takes a raw TCGPlayer export and adds Ink, Cost, Type, Subtypes, STR/WIL/Lore, Inkable, Keywords, Abilities. Also outputs a dreamborn.ink-ready import file.
lookup_card	Look up any card by name — returns full stats and ability text.
audit_csv	Compare an enriched collection CSV against live API data and report stale or wrong fields.

Install

pip install lorcana-mcp

Or from source:

git clone https://github.com/IcaroBichir/lorcana-claude-tools
cd lorcana-claude-tools
pip install .

Add to Claude

Claude Code (CLI):

claude mcp add lorcana -- lorcana-mcp serve

Claude Desktop — add to claude_desktop_config.json:

{
  "mcpServers": {
    "lorcana": {
      "command": "lorcana-mcp",
      "args": ["serve"]
    }
  }
}

Usage

Once added, just talk to Claude naturally:

"Enrich my collection at /Users/me/Downloads/Lorcana_export.csv"

"Look up Will o' the Wisp - Forest Spirit"

"Audit my collection at /Users/me/lorcana/enriched_collection.csv and tell me what's wrong"

Data sources

• LorcanaJSON (lorcanajson.org) — all sets including Set 12+
• lorcana-api.com — Sets 1–11 (preferred for those sets; better body text formatting)

Card data is cached locally for 24 hours (~/.cache/lorcana-mcp/). Force a refresh:

lorcana-mcp cache clear

Supported sets

The First Chapter · Rise of the Floodborn · Into the Inklands · Ursula's Return · Shimmering Skies · Azurite Sea · Archazia's Island · Reign of Jafar · Fabled · Whispers in the Well · Winterspell · Wilds Unknown · Attack of the Vine! · Hyperia City

TCGPlayer export format

Export your collection from TCGPlayer → My Collection → Export. The raw export has columns like Product Name, Set Name, Number, Rarity, Condition, Printing, Add to Quantity. The enricher adds 10 card-data columns and also outputs a dreamborn.ink-compatible CSV.

Note: Promo cards are skipped in the dreamborn output since they use internal promo numbers that don't match TCGPlayer's format. Add them manually via dreamborn.ink's card search.