Hearthstone MCP Server

Hearthstone card search, deck analysis, strategy coaching, and archetype classification

Local serverstdio

What is the Hearthstone MCP server?

If you already use Hearthstone, the hearthstone mcp server is the piece that lets your assistant work with it directly. Hearthstone card search, deck analysis, strategy coaching, and archetype classification.

What the server does

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.

  • 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

Available tools

The toolset is worth reading before you wire it up, because it tells you what the integration is really for:

  • search_cards — Search cards by name, text, class, cost, type, rarity, set, or keyword
  • get_card — Get complete details for a specific card with fuzzy matching
  • get_keyword — Look up keyword/mechanic definitions with related cards
  • decode_deck — Decode a deck code into full card list with mana curve
  • analyze_deck — Analyze a deck's archetype, gameplan, strengths, and matchup profile
  • get_archetype — Learn about deck archetypes (aggro, control, combo, midrange, tempo, value)
  • get_class_identity — Strategic identity of each Hearthstone class
  • get_matchup — Theoretical matchup dynamics between archetypes
  • explain_concept — Fundamental game concepts explained for Hearthstone

Installation

Installation goes through your MCP client rather than a global install: point it at hearthstone-oracle on npm and it is fetched when the client starts. The copy-paste blocks for Claude Desktop, Claude Code and Cursor are further down this page.

Where it fits

Among the developer tooling options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. Hearthstone's toolset — search_cards, get_card, get_keyword and 6 more — is a fair guide to whether it matches your workflow. It is maintained by gregario; worth a glance at recent repository activity before you build anything load-bearing on it.

SyncDev reviews every entry in this directory against the project's own documentation before publishing, and revisits them as servers change.

Worth knowing first

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • With 9 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch Hearthstone.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

Available tools

ToolWhat it does
search_cardsSearch cards by name, text, class, cost, type, rarity, set, or keyword
get_cardGet complete details for a specific card with fuzzy matching
get_keywordLook up keyword/mechanic definitions with related cards
decode_deckDecode a deck code into full card list with mana curve
analyze_deckAnalyze a deck's archetype, gameplan, strengths, and matchup profile
get_archetypeLearn about deck archetypes (aggro, control, combo, midrange, tempo, value)
get_class_identityStrategic identity of each Hearthstone class
get_matchupTheoretical matchup dynamics between archetypes
explain_conceptFundamental game concepts explained for Hearthstone

How to install the Hearthstone MCP server

{
  "mcpServers": {
    "hearthstone-oracle": {
      "command": "npx",
      "args": ["-y", "hearthstone-oracle"]
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Example prompts to try

  • Use Hearthstone to search cards.
  • Use Hearthstone to get card.
  • Use Hearthstone to get keyword.

Frequently asked questions

It connects Hearthstone to MCP-compatible AI assistants such as Claude and Cursor, exposing 9 tools (search_cards, get_card, get_keyword, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Hearthstone directly.