Lorcana Mcp

Name: Lorcana Mcp
Author: IcaroBichir

@IcaroBichir

About Lorcana Mcp

MCP server for Disney Lorcana TCG — enrich TCGPlayer collection exports, look up card stats and format legality, and filter by Core / Infinity / Poorcana

#lorcana #disney-lorcana #tcg #claude #claude-mcp

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

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

Tools

Enriches a raw TCGPlayer export with Ink, Cost, Type, Subtypes, STR/WIL/Lore, Inkable, Keywords, and Abilities. Writes an enriched CSV and a dreamborn.ink-ready import file next to the input.

Looks up any card by name. Returns full stats, ability text, format legality, and card image URL.

Filters your collection to cards legal in a given format: `core`, `infinity`, `core_zh`, `core_ja`, or `poorcana`.

Compares an enriched collection against live API data and reports any stale or wrong fields.

Overview

What is Lorcana Mcp?

An MCP server that connects Claude to Disney Lorcana card data. It enriches raw TCGPlayer exports with ink cost, stats, keywords, abilities, and format legality, and produces a ready-to-import file for dreamborn.ink.

How to use Lorcana Mcp?

Install via pip install lorcana-mcp, then add it to Claude Desktop or Claude Code using lorcana-mcp serve as the command. Once connected, use natural language to invoke the four tools: enrich_csv, lookup_card, filter_collection, and audit_csv. No slash commands are needed.

Key features of Lorcana Mcp

Enriches TCGPlayer exports with 10 additional card data columns
Looks up any Lorcana card by name for full stats and image URL
Filters collections by format legality (core, infinity, regionals, poorcana)
Audits enriched files against live API data for stale fields
Produces a dreamborn.ink‑compatible import file
Caches API responses locally for 24 hours

Use cases of Lorcana Mcp

Enrich a raw TCGPlayer collection export with detailed card attributes
Look up card stats, ability text, and format legality during deckbuilding
Filter your collection to cards legal in a specific tournament format
Audit an existing enriched collection after a new set release
Import a collection into dreamborn.ink after enrichment

FAQ from Lorcana Mcp

What data sources does Lorcana Mcp use?

It combines LorcanaJSON (primary for Set 12+), lorcana-api.com (preferred for Sets 1–11), and duels.ink for format legality and card images.

How does caching work?

Card data is cached in ~/.cache/lorcana-mcp/ for 24 hours. You can inspect or clear the cache with lorcana-mcp cache stats and lorcana-mcp cache clear.

Does Lorcana Mcp support new card sets?

New sets are automatically picked up via LorcanaJSON as long as the set name is added to the internal mapping. Open an issue if a new set isn’t resolving.

Are promo cards included in the dreamborn.ink export?

No. Promo cards are skipped in the dreamborn output because dreamborn uses internal promo set numbers that don’t match TCGPlayer’s format. Add them manually after import.

What formats are supported for filtering?

Valid formats: core, infinity, core_zh, core_ja, and poorcana. Poorcana filtering uses the Rarity column (Common + Uncommon only) and requires no API call.