Hearthstone

Provides deck code parsing, card search, card details, and cover image URLs via MCP with HTTP SSE and stdio transports.

javascript

0

GitHub Stars

javascript

Language

5 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "yinshawnrao-hearthstone-decks-mcp": {
      "command": "npx",
      "args": [
        "hearthstone-decks-mcp"
      ],
      "env": {
        "HTTP_HOST": "localhost",
        "HTTP_PORT": "3000",
        "CARD_DATA_TTL": "24"
      }
    }
  }
}

This MCP server lets you parse Hearthstone deck codes, search cards, fetch card details, and obtain card cover images. It exposes a simple, MCP-compliant interface so you can perform deck analysis, card lookups, and statistics generation from any MCP client.

How to use

You run the server locally using a standard MCP client and connect via the MCP protocol. The server supports a straightforward stdio (standard input/output) mode by default, and you can enable HTTP Server-Sent Events (SSE) mode if you need a streaming HTTP interface.

From your MCP client, point to the configured command to start the server and select the desired transport. In most cases you will start the server using the stdio workflow and the default transport. If you prefer an HTTP-based flow, you can run with the transport flag to enable SSE, and then send requests through the HTTP endpoints provided by the server when available.

How to install

# Global installation (recommended)
npm install -g hearthstone-decks-mcp

# Local installation
npm install hearthstone-decks-mcp

Prerequisites you need before installing: Node.js and npm. Ensure you have network access to fetch dependencies and the card data sources.

Install steps in sequence, then start the server using the stdio workflow shown below.

Additional notes

MCP command for stdio mode and how to launch from a client is shown in the following configuration snippet.

{
  "mcpServers": {
    "hearthstone_mcp": {
      "command": "npx",
      "args": ["hearthstone-decks-mcp"]
    }
  }
}

Environment variables you may configure for the HTTP server include the port and host, and a cache TTL for card data. Examples shown are HTTP_PORT, HTTP_HOST, and CARD_DATA_TTL.

Available tools

parse_deck_code

Parses a Hearthstone deck code and returns detailed deck information, including cards and statistics.

search_cards

Searches Hearthstone cards by name and returns a list of matching results.

get_card_info

Fetches detailed information for a specific card by its ID.