Log inSubmit server
Hearthstone Oracle logo

Hearthstone Oracle

by gregario

Search Hearthstone cards, decode and analyze decks, and get archetype, matchup, class, and gameplay guidance.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Hearthstone Oracle

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "gregario-hearthstone-oracle": {
      "command": "npx",
      "args": [
        "-y",
        "hearthstone-oracle"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

We couldn’t confirm it starts correctly

We ran the install command but it didn't respond within our test window — this can mean a slow first-time install rather than a real problem.

npx -y hearthstone-oracle

No response to initialize.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 22d ago.

Overview

gregario/hearthstone-oracle MCP server provides Hearthstone card search, deck decoding, deck analysis, and strategy guidance through nine MCP tools. It downloads HearthstoneJSON card data on first run, stores it locally in SQLite with FTS5 search, and combines that data with built-in strategy knowledge. Use it when an agent needs card details, deck composition analysis, archetype information, matchup theory, or explanations of Hearthstone concepts. No API key is required.

Use cases

  • Search cards by class, cost, set, rarity, type, text, or keyword
  • Decode a Hearthstone deck code into cards and a mana curve
  • Analyze a deck’s archetype, gameplan, strengths, and matchups
  • Explain class identities, card mechanics, and gameplay concepts
  • Compare theoretical matchup dynamics between archetypes

Key features

  • HearthstoneJSON card database with local SQLite and FTS5 search
  • Card search with multiple filters and fuzzy card lookup
  • Deck-code decoding with card lists and mana curves
  • Deck archetype and gameplan analysis
  • Built-in archetype, class, matchup, and gameplay knowledge
  • Automatic first-run card-data download without an API key

Tools9

What Hearthstone Oracle lets your agent do. Expand a tool for its parameters.

Self-reported~159 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 2d ago

Recent health check succeeded.

19/19 checks healthy over the last 79d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 12d ago via OSV.dev · hearthstone-oracle (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars2Stargazers on the source repository.
npm downloads205Package downloads in the last 30 days.
Last commit5mo agoMost recent push to the default branch.
Install checkInconclusiveDidn't respond in our test window — often a slow first install.
Tools exposed9Callable tools this server registers over MCP.
Directory activity6 viewsConfig copies, upvotes, and views on AllMCPs.

How Hearthstone Oracle works

What gregario/hearthstone-oracle does

gregario/hearthstone-oracle MCP server gives an MCP-compatible client access to a Hearthstone card database and a collection of strategy references. Its nine tools cover card discovery, individual card lookup, keyword explanations, deck-code decoding, deck analysis, archetypes, class identities, matchup theory, and general game concepts.

Card queries can be filtered by fields such as name, card text, class, mana cost, type, rarity, set, and keyword. Individual cards can also be retrieved with fuzzy matching. Keyword lookups return mechanic definitions and related cards, which is useful when an agent needs to explain unfamiliar terminology or connect a mechanic to examples.

Deck tools address both structure and interpretation. decode_deck turns a Hearthstone deck code into a card list and mana curve. analyze_deck adds an archetype assessment, likely gameplan, strengths, and matchup profile. The strategy tools provide reference material for aggro, control, combo, midrange, tempo, and value archetypes, along with class identities and theoretical relationships between archetypes.

How it works

On its first run, gregario/hearthstone-oracle MCP server fetches card data from HearthstoneJSON and saves it locally under ~/.hearthstone-oracle/. The card layer uses a local SQLite database with FTS5 full-text search. When newer game builds are available, the card data can be updated.

A separate strategy layer contains the server’s built-in knowledge about archetypes, class strategy, matchup dynamics, and core Hearthstone concepts. This lets the tools support explanatory and coaching-style requests in addition to returning card records. The source data is provided by HearthstoneJSON, which is described as being extracted from Hearthstone game files.

Setup and configuration

The gregario/hearthstone-oracle MCP server runs through Node.js and requires Node.js 18 or newer. The documented quick-start command uses npx:

Terminal
claude mcp add hearthstone-oracle -- npx -y hearthstone-oracle

For Claude Desktop, add an MCP entry whose command is npx and whose argument list is ["-y", "hearthstone-oracle"]. Card data is downloaded automatically on first launch, so no separate database setup is needed. The documentation states that no API key is required.

Tools and capabilities

  • search_cards: Find cards using card attributes, text, or keywords.
  • get_card: Retrieve full details for a named card with fuzzy matching.
  • get_keyword: Explain a keyword or mechanic and show related cards.
  • decode_deck: Expand a deck code into its cards and mana curve.
  • analyze_deck: Describe a deck’s archetype, gameplan, strengths, and matchup profile.
  • get_archetype: Explain common Hearthstone archetypes.
  • get_class_identity: Describe the strategic identity of a Hearthstone class.
  • get_matchup: Provide theoretical dynamics between archetypes.
  • explain_concept: Explain fundamental Hearthstone gameplay concepts.

Limitations and notes

The strategy results are based on built-in knowledge and theoretical matchup information, while card records come from HearthstoneJSON. The server is licensed under MIT.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Hearthstone Oracle

gregario/hearthstone-oracle is an MCP server that connects AI clients to HearthstoneJSON card data and built-in Hearthstone strategy knowledge. Its main tools search and retrieve cards, explain keywords, decode and analyze decks, and provide archetype, class identity, matchup, and gameplay concept guidance.

Install it with `claude mcp add hearthstone-oracle -- npx -y hearthstone-oracle` using Node.js 18 or newer. Claude Desktop can be configured with an `npx` command and the `-y hearthstone-oracle` arguments.

No, gregario/hearthstone-oracle does not require an API key. It downloads card data from HearthstoneJSON automatically on first run and stores it locally in `~/.hearthstone-oracle/`.

Yes, gregario/hearthstone-oracle works with Claude Desktop through its documented MCP configuration. Add a server entry that runs `npx` with `-y` and `hearthstone-oracle` as the arguments.

Related MCP servers

All in Gaming All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewHearthstone Oracle AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/gregario-hearthstone-oracle?style=directory)](https://allmcps.com/mcp/gregario-hearthstone-oracle)
HTML Embed
<a href="https://allmcps.com/mcp/gregario-hearthstone-oracle"><img src="https://allmcps.com/api/badge/gregario-hearthstone-oracle?style=directory" alt="Hearthstone Oracle on AllMCPs" /></a>