{
  "markdown": "# lorcana-oracle\n\nDisney Lorcana TCG MCP server -- card search, deck analysis, and franchise browsing powered by LorcanaJSON.\n\n<p align=\"center\">\n  <a href=\"https://www.npmjs.com/package/lorcana-oracle\"><img src=\"https://img.shields.io/npm/v/lorcana-oracle.svg\" alt=\"npm version\"></a>\n  <a href=\"https://www.npmjs.com/package/lorcana-oracle\"><img src=\"https://img.shields.io/npm/dm/lorcana-oracle.svg\" alt=\"npm downloads\"></a>\n  <a href=\"https://nodejs.org\"><img src=\"https://img.shields.io/badge/node-%3E%3D18-brightgreen.svg\" alt=\"Node.js 18+\"></a>\n  <a href=\"https://modelcontextprotocol.io\"><img src=\"https://img.shields.io/badge/MCP-compatible-purple.svg\" alt=\"MCP Compatible\"></a>\n  <a href=\"LICENSE\"><img src=\"https://img.shields.io/badge/license-MIT-blue.svg\" alt=\"MIT License\"></a>\n  <a href=\"https://github.com/sponsors/gregario\"><img src=\"https://img.shields.io/badge/sponsor-♥-ea4aaa.svg\" alt=\"Sponsor\"></a>\n  <a href=\"https://glama.ai/mcp/servers/gregario/lorcana-oracle\"><img src=\"https://glama.ai/mcp/servers/gregario/lorcana-oracle/badges/score.svg\" alt=\"lorcana-oracle MCP server\"></a>\n</p>\n\n<!-- mcp-name: io.github.gregario/lorcana-oracle -->\n\n## Features\n\n- **search_cards** -- Search cards by name, rules text, ink color, type, rarity, set, or cost range\n- **browse_sets** -- List all sets or drill into a specific set to see its cards\n- **character_versions** -- Compare all printings of a character across sets\n- **browse_franchise** -- Browse cards by Disney franchise (Frozen, Moana, etc.)\n- **analyze_ink_curve** -- Analyze a deck list for ink cost distribution, inkable ratio, and color balance\n- **analyze_lore** -- Analyze lore generation in a deck or find top lore-generating cards\n- **find_song_synergies** -- Find which characters can sing a song, or which songs a character can sing\n\n## Installation\n\n### Quick start\n\n```bash\nnpx lorcana-oracle\n```\n\nCard data (~2,710 cards) is bundled with the package. No downloads or API keys needed.\n\n### Claude Desktop\n\nAdd to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"lorcana-oracle\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"lorcana-oracle\"]\n    }\n  }\n}\n```\n\n### Claude Code\n\n```bash\nclaude mcp add lorcana-oracle -- npx -y lorcana-oracle\n```\n\n## Tools\n\n### search_cards\n\nSearch Disney Lorcana cards by name, rules text, or filters (ink color, type, rarity, set, cost range). Returns paginated results.\n\n```\nsearch_cards({ query: \"Elsa\", color: \"Amethyst\" })\nsearch_cards({ type: \"Song\", cost_max: 3 })\nsearch_cards({ query: \"draw a card\", rarity: \"Legendary\" })\n```\n\n### browse_sets\n\nList all Disney Lorcana sets, or drill into a specific set to see its metadata and cards.\n\n```\nbrowse_sets({})\nbrowse_sets({ set_code: \"1\" })\n```\n\n### character_versions\n\nShow all printings/versions of a Disney Lorcana character across sets. Useful for comparing different versions of the same character.\n\n```\ncharacter_versions({ character_name: \"Elsa\" })\ncharacter_versions({ character_name: \"Mickey Mouse\" })\n```\n\n### browse_franchise\n\nBrowse Disney Lorcana cards by franchise (story). Without a franchise name, lists all franchises with card counts. With a franchise name, shows cards and statistics.\n\n```\nbrowse_franchise({})\nbrowse_franchise({ franchise: \"Frozen\" })\n```\n\n### analyze_ink_curve\n\nAnalyze a Disney Lorcana deck list for ink cost distribution, inkable ratio, and color balance. Paste a deck list to get curve analysis.\n\n```\nanalyze_ink_curve({ deck_list: \"4 Elsa - Snow Queen\\n4 Let It Go\\n2 Hades - King of Olympus\" })\n```\n\n### analyze_lore\n\nAnalyze 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.\n\n```\nanalyze_lore({ deck_list: \"4 Elsa - Snow Queen\\n4 Mickey Mouse - Brave Little Tailor\" })\nanalyze_lore({ color: \"Amber\", min_lore: 3 })\n```\n\n### find_song_synergies\n\nFind 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.\n\n```\nfind_song_synergies({ card_name: \"Let It Go\" })\nfind_song_synergies({ card_name: \"Elsa - Snow Queen\" })\nfind_song_synergies({})\n```\n\n## Data Source\n\nCard data is sourced from [LorcanaJSON](https://lorcanajson.org/) (MIT license). LorcanaJSON provides comprehensive card data for all released Disney Lorcana sets.\n\nDisney 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](https://www.ravensburger.us/lorcana/community-code).\n\n## License\n\n[MIT](LICENSE)\n",
  "bytes": 4776,
  "sha": "6dd9c1997c855612302230b03b15240859d694fff93950cf184a228abd2365ce",
  "repo_slug": "gregario/lorcana-oracle",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_gregario_lorcana_oracle_2af238dc/readme"
}