MCP.Market

Hearthstone Oracle MCP server

by gregario·io.github.gregario/hearthstone-oracle·v0.1.0·2 stars
No reviews yet

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

B82/100grade B
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
B82/100

full report

Adoption
New

2 stars52 downloads/wk

Reviews

Write one

Nobody has reviewed Hearthstone Oracle yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Hearthstone Oracle tools (9)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • analyze_deck

    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.

  • decode_deck

    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.

  • explain_concept

    Explain a fundamental Hearthstone game concept like card advantage, tempo, value, board control, or mana curve. Includes how the concept applies specifically to Hearthstone.

  • get_archetype

    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.

  • get_card

    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.

  • get_class_identity

    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.

  • get_keyword

    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.

  • get_matchup

    Get the theoretical matchup dynamics between two Hearthstone archetypes. Explains who is favoured, why, the key strategic tension, and what each side should prioritise.

  • search_cards

    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.

Public scan report

scanner v0.1.10 · 2026-09-27 · same rubric, same numbers if you re-run it

no findings
  • Code scan33 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitylocal package, no credentials required12/15
  • Maintenancelast push 148 days ago8/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Overall 82/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Hearthstone Oracle compares

Against every graded Web search MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
82/100
higher than 68% of 3,470 Web search servers
Tools
9
the typical Web search server has 5
Tools that change things
0%
typical: 0%. Fewer write tools means less an agent can break
GitHub stars
2
more than 70% of 1,786 Web search servers
Downloads a week
52
more than 36% of 827 Web search servers with a package

What its tools let an agent do: 9 read

Install Hearthstone Oracle in Claude Code, Cursor or VS Code

Runs npx -y hearthstone-oracle on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add hearthstone-oracle -- npx -y hearthstone-oracle
Add to Cursor

What the publisher says

From the Hearthstone Oracle repository's README, as published. We do not edit it. Read it on GitHub

<!-- mcp-name: io.github.gregario/hearthstone-oracle -->

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

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

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/claudedesktopconfig.json):

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

Tools

How It Works

Two-layer architecture:

  1. 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.
  2. 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

Nothing above is checked by us. What we check is on the safety report.

Hearthstone Oracle: common questions

Is Hearthstone Oracle MCP server safe?
Mostly: it is graded B (82/100). Read the Hearthstone Oracle safety report
How do I install Hearthstone Oracle?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Hearthstone Oracle need an API key?
Not as far as the registry entry and our scan can tell: no credentials are declared or required.
Is Hearthstone Oracle maintained?
The last commit was 186 days ago (2026-05-02). The latest release is v0.1.0.
What can I use instead of Hearthstone Oracle?
Servers from other publishers that do the same job: Reddit Buddy MCP server and MCP FreeScout MCP server.
How does Hearthstone Oracle compare with other Web search MCP servers?
safety score 82/100 (higher than 68% of 3,470 Web search servers); tools 9 (the typical Web search server has 5); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to Hearthstone Oracle

Same job from other publishers: the closest match first, then the best rated.

  • Reddit Buddy
    Browse Reddit RSS; approved API access for search, analysis, and optional posting.
    A
  • MCP FreeScout
    FreeScout ticket management with AI-powered analysis, search filters, and structured outputs.
    A

More from gregario →