hearthstone-oracle
The hearthstone-oracle server provides a complete Hearthstone card database with built-in strategy knowledge for deck building, analysis, and gameplay coaching.
Search cards — Find cards by name, text, class, mana cost, type, rarity, set, tribe, or keyword with flexible filtering
Get card details — Retrieve complete stats, text, and keywords for a specific card using exact or fuzzy matching
Look up keywords/mechanics — Get definitions for mechanics like Battlecry or Deathrattle, plus all cards with that mechanic
Decode deck codes — Convert a deck code into a full card list with mana curve and type breakdown
Analyze decks — Classify a deck's archetype, explain its gameplan, and identify strengths, weaknesses, and matchup predictions
Explore archetypes — Learn about aggro, control, combo, midrange, tempo, and value archetypes including win conditions and example decks
Understand class identities — Get the strategic identity of any Hearthstone class, including hero power implications and historical archetypes
Get matchup dynamics — Understand the theoretical matchup between two archetypes and key strategic tensions
Explain game concepts — Get clear explanations of concepts like tempo, card advantage, board control, and mana curve
Card data is stored locally in SQLite (sourced from HearthstoneJSON) with full-text search — no external API required.
hearthstone-oracle
Hearthstone 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.
Features
Complete card database from HearthstoneJSON — every collectible card, auto-updated
Deck decoding and analysis — paste a deck code, get full card list, mana curve, and archetype breakdown
Strategy knowledge — archetypes, class identities, matchup dynamics, and game concepts
9 MCP tools — search, lookup, decode, analyze, coach
Related MCP server: lorcana-oracle
Quick Start
claude mcp add hearthstone-oracle -- npx -y hearthstone-oracleCard data is downloaded automatically from HearthstoneJSON on first run and stored locally in ~/.hearthstone-oracle/. No API key required.
Claude Desktop
Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"hearthstone-oracle": {
"command": "npx",
"args": ["-y", "hearthstone-oracle"]
}
}
}Tools
Tool | Description |
| Search cards by name, text, class, cost, type, rarity, set, or keyword |
| Get complete details for a specific card with fuzzy matching |
| Look up keyword/mechanic definitions with related cards |
| Decode a deck code into full card list with mana curve |
| Analyze a deck's archetype, gameplan, strengths, and matchup profile |
| Learn about deck archetypes (aggro, control, combo, midrange, tempo, value) |
| Strategic identity of each Hearthstone class |
| Theoretical matchup dynamics between archetypes |
| Fundamental game concepts explained for Hearthstone |
How It Works
Two-layer architecture:
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.
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.
Data Source
Card data provided by HearthstoneJSON by HearthSim. Auto-extracted from game files. Unrestricted use.
License
MIT
Available Tools
9 toolsanalyze_deckA
Analyze a Hearthstone deck code to classify its archetype, explain its gameplan, identify strengths and weaknesses, and predict matchup dynamics. Use this for strategic deck coaching — it combines card data with strategy knowledge.
Inputs: deck_code (required).
decode_deckA
Decode a Hearthstone deck code into its full card list with mana curve and card type breakdown. Use this when a user shares a deck code and wants to see what's in it.
Inputs: deck_code (required).
explain_conceptA
Explain a fundamental Hearthstone game concept like card advantage, tempo, value, board control, or mana curve. Includes how the concept applies specifically to Hearthstone.
Inputs: name (required).
get_archetypeA
Get a detailed explanation of a Hearthstone deck archetype (aggro, control, combo, midrange, tempo, value). Includes gameplan, win conditions, strengths, weaknesses, and example decks. Use this when explaining deck building strategy.
Inputs: name (required).
get_cardA
Get complete details for a specific Hearthstone card including stats, text, keywords, and type. Use this when you know the card name (or close to it) and need full information. Supports fuzzy matching.
Inputs: name (required).
get_class_identityA
Get the strategic identity of a Hearthstone class — hero power implications, historical archetypes, strengths, weaknesses, and how the class approaches each game phase. Omit the class name to get an overview of all 11 classes.
Inputs: class_name.
get_keywordA
Look up a Hearthstone keyword or mechanic (e.g., Battlecry, Deathrattle, Discover) and see all cards that have it. Use this to explain what a keyword does or find all cards with a specific mechanic.
Inputs: name (required), player_class.
get_matchupA
Get the theoretical matchup dynamics between two Hearthstone archetypes. Explains who is favoured, why, the key strategic tension, and what each side should prioritise.
Inputs: archetype_a (required), archetype_b (required).
search_cardsA
Search for Hearthstone cards by name, text, class, mana cost, type, rarity, set, or keyword. Use this when you need to find cards matching specific criteria. Returns a summary list — use get_card for full details on a specific card.
Inputs: query, player_class, mana_cost, cost_op, +7 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 9 tools
Each tool targets a distinct aspect of Hearthstone knowledge: deck analysis vs decoding, card search vs details, archetype vs concept vs matchup, class identity vs keyword. No overlapping purposes.
All tools follow a consistent verb_noun snake_case pattern (e.g., analyze_deck, get_card, search_cards). No mixing of conventions or vague verbs.
9 tools cover a comprehensive yet focused set of Hearthstone oracle functions. The count is well-scoped for the domain—neither too sparse nor too heavy.
The tool surface covers card details, deck decoding and analysis, concepts, archetypes, matchups, keywords, and class identities. No obvious gaps for a knowledge-oriented Hearthstone assistant.
Maintenance
Related MCP Connectors
Free, read-only MCP server to search and compare AI tools for making video games. No API key.
MCP server for building and testing AI agents with multi-model experimentation and insights.
Official remote MCP server for Archivist AI TTRPG campaign memory: characters, sessions, and more.
Related MCP Servers
- AlicenseAqualityDmaintenanceMagic: The Gathering MCP server with card search, rules lookup, deck analysis, and Commander intelligence145MIT
- AlicenseAqualityDmaintenanceDisney Lorcana TCG MCP server -- card search, deck analysis, and franchise browsing powered by LorcanaJSON.74MIT
- AlicenseAqualityBmaintenanceAn MCP server for searching and aggregating Disney Lorcana cards, enabling card lookup, deck building, and statistical analysis.1029 PyPI1MIT
- AlicenseNot gradedqualityBmaintenanceUnified MCP server for Magic: The Gathering, combining Scryfall card search and pricing, EDHRec commander recommendations, Archidekt deck reading, and decklist validation into a single service.MIT