{
  "markdown": "<!-- mcp-name: io.github.gregario/hearthstone-oracle -->\n\n<p align=\"center\">\n  <a href=\"https://www.npmjs.com/package/hearthstone-oracle\"><img src=\"https://img.shields.io/npm/v/hearthstone-oracle.svg\" alt=\"npm version\"></a>\n  <a href=\"https://www.npmjs.com/package/hearthstone-oracle\"><img src=\"https://img.shields.io/npm/dm/hearthstone-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/hearthstone-oracle\"><img src=\"https://glama.ai/mcp/servers/gregario/hearthstone-oracle/badges/score.svg\" alt=\"hearthstone-oracle MCP server\"></a>\n</p>\n\n# hearthstone-oracle\n\nHearthstone MCP server with card search, deck analysis, and strategy coaching. Gives LLMs access to every Hearthstone card plus built-in strategy knowledge for deck building and gameplay advice.\n\n## Features\n\n- **Complete card database** from HearthstoneJSON — every collectible card, auto-updated\n- **Deck decoding and analysis** — paste a deck code, get full card list, mana curve, and archetype breakdown\n- **Strategy knowledge** — archetypes, class identities, matchup dynamics, and game concepts\n- **9 MCP tools** — search, lookup, decode, analyze, coach\n\n## Quick Start\n\n```bash\nclaude mcp add hearthstone-oracle -- npx -y hearthstone-oracle\n```\n\nCard data is downloaded automatically from HearthstoneJSON on first run and stored locally in `~/.hearthstone-oracle/`. No API key required.\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    \"hearthstone-oracle\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"hearthstone-oracle\"]\n    }\n  }\n}\n```\n\n## Tools\n\n| Tool | Description |\n|------|-------------|\n| `search_cards` | Search cards by name, text, class, cost, type, rarity, set, or keyword |\n| `get_card` | Get complete details for a specific card with fuzzy matching |\n| `get_keyword` | Look up keyword/mechanic definitions with related cards |\n| `decode_deck` | Decode a deck code into full card list with mana curve |\n| `analyze_deck` | Analyze a deck's archetype, gameplan, strengths, and matchup profile |\n| `get_archetype` | Learn about deck archetypes (aggro, control, combo, midrange, tempo, value) |\n| `get_class_identity` | Strategic identity of each Hearthstone class |\n| `get_matchup` | Theoretical matchup dynamics between archetypes |\n| `explain_concept` | Fundamental game concepts explained for Hearthstone |\n\n## How It Works\n\nTwo-layer architecture:\n\n1. **Card data layer** — Full card database from HearthstoneJSON, stored in a local SQLite database with FTS5 full-text search. Cards are fetched on first run and updated when newer game builds are available.\n2. **Strategy layer** — Built-in strategy knowledge covering archetypes, class identities, matchup theory, and core game concepts. Enables the server to provide coaching and analysis, not just raw card data.\n\n## Data Source\n\nCard data provided by [HearthstoneJSON](https://hearthstonejson.com) by [HearthSim](https://hearthsim.info). Auto-extracted from game files. Unrestricted use.\n\n## License\n\nMIT\n",
  "bytes": 3583,
  "sha": "8ec1784dda84b58d7a8b41e6f214a5b6dec1142f6d52d4cb4562a18371c3882d",
  "repo_slug": "gregario/hearthstone-oracle",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_gregario_hearthstone_oracle_d37fb73f/readme"
}