# gregario/hearthstone-oracle [Health: Active]

**Category:** 🎮 Gaming  
**Repository:** https://github.com/gregario/hearthstone-oracle  
**GitHub Stars:** 2  
**npm Downloads (last month):** 205  
**Views:** 6  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/gregario-hearthstone-oracle

## Description
Hearthstone card search, deck analysis, and strategy coaching. 9 tools covering card lookup, deck decoding, archetype classification, class identities, matchup theory, and game concepts. HearthstoneJSON data.

## Tools
Capabilities this server exposes over MCP:

- **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

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

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

## Documentation

## 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`:

```bash
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.

_Full upstream README: https://allmcps.com/mcp/gregario-hearthstone-oracle/readme_