Hearthstone Oracle

io.github.gregarioPublished by GitHub account gregariov0.1.0Updated Nov 3, 2026

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

VerifiedSTDIODesktop only

Server details

Identifier: io.github.gregario/hearthstone-oracle
Transport: STDIO
Runtime: Desktop only
Trust: Verified
Published: Sep 16, 2026

Security note

MCP servers receive tool arguments from a conversation and may perform external actions. Review what a server can do before you enable it, and give it only the access it needs.

The registry verified the GitHub account gregario for this listing. That does not show the account is the product's maker.

SourceWeft's checks cover whether the listing is complete and the endpoint answered; they do not review the server's code or what its tools do.

Add a badge to your README

Show readers this MCP server is listed on SourceWeft. The badge links to this page.

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.github.gregario%2Fhearthstone-oracle.svg)](https://sourceweft.com/mcp/io.github.gregario%2Fhearthstone-oracle?utm_source=readme&utm_medium=badge)

Overview

AI-generated overview

Local MCP server that gives an assistant a full Hearthstone card database plus deck decoding, archetype analysis and strategy coaching.

What you can do: Search and look up cards by name, text, class, cost, type, rarity, set or keyword, and read keyword definitions with related cards
Decode deck codes into full card lists with mana curves
Analyze decks for archetype, gameplan, strengths and matchup profile
Explain archetypes, class identities, matchup dynamics and core game concepts
When to use it: Useful when you want an assistant to answer Hearthstone card questions, break down a deck code, or give deck-building and gameplay advice without leaving the chat.
Requirements: Runs locally via npx (Node.js required) and is configured in the desktop client. Card data is downloaded from HearthstoneJSON on first run and stored in a local folder under the user's home directory. No API key is needed.

Before you install

On first run it downloads card data from a third-party source (HearthstoneJSON) and keeps a local database on disk; it needs network access for that initial fetch and for updates. No credentials are requested.

Installation

In SourceWeft

Open Hearthstone Oracle in the dashboard and add it to a workspace.
Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

[npm version] [npm downloads] [Node.js 18+] [MCP Compatible] [MIT License] [Sponsor] [hearthstone-oracle MCP server]

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

Quick Start

Card 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):

json

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

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

Tools

Tool	Description
`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

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

Source: README.md at commit 7b676e7

Tools

SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

v0.1.0LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

Reached in the last 30 days25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
DescriptionRequired15 pts
Logo10 pts
Documentation15 pts
License10 pts