Helldivers2 Mcp

io.github.xerno42Published by GitHub account xerno42v1.0.2Updated Oct 24, 2026

MCP server exposing live Helldivers 2 galactic war data.

VerifiedStreamable HTTPWeb executable

Server details

Identifier: io.github.xerno42/helldivers2-mcp
Transport: Streamable HTTP
Runtime: Web executable
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 xerno42 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.xerno42%2Fhelldivers2-mcp.svg)](https://sourceweft.com/mcp/io.github.xerno42%2Fhelldivers2-mcp?utm_source=readme&utm_medium=badge)

Overview

AI-generated overview

Read-only MCP server that gives an assistant live Helldivers 2 galactic war data: war stats, Major Orders, planets, dispatches, Steam news and the DSS.

What you can do: Read war-wide statistics and active planets, including kills by faction, missions won and lost, accuracy and impact multiplier
Read active Major Orders with briefing, decoded task list, progress, rewards and time until expiry
List all planets and fetch detailed data for up to five at a time: biome, hazards, owner, health, events and regions
Read the in-game dispatch feed and Steam news, with an optional limit on how many items are returned
Read Democracy Space Station details: host planet, time until the next election and active tactical actions
When to use it: Useful when you want an assistant to answer questions about the current state of the Helldivers 2 galactic war, summarize Major Orders or news, or compare planets and plan where to play, without opening the game.
Requirements: Either the hosted endpoint or a local run: Node.js 22+ or Docker for the npm package or container image. Self-hosting requires an X_SUPER_CONTACT environment variable holding a contact email, which is forwarded to the upstream community API. Optional settings cover port, bind host, allowed browser origins and rate limits.

Before you install

Self-hosted runs must supply a real contact email in X_SUPER_CONTACT, which is forwarded to the third-party community API at api.helldivers2.dev. All tools only read data; nothing is written or changed. The hosted instance is a public third-party service, so requests and queries go to it.

Installation

In SourceWeft

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

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.xerno42%2Fhelldivers2-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "helldivers2": {
      "type": "http",
      "url": "https://mcp.avengersofsuperearth.com/mcp"
    }
  }
}

README

helldivers2-mcp

[npm version] [CI] [Docker Hub] [License: MIT]

A stateless Model Context Protocol (MCP) server that exposes live Helldivers 2 galactic war data to LLMs.

Data is sourced from the community API at api.helldivers2.dev.

Packages

Tools

Tool	Description
`get_war_status`	Galaxy-wide war statistics (kills by faction, missions won/lost, accuracy, deaths, impact multiplier) and active planets with owner, player count, active events, attack vectors, and region health
`get_assignments`	Active Major Orders with title, briefing, decoded task list (faction, difficulty, target planet), current progress numbers, reward type and amount, and time until expiry
`get_all_planets`	Full planet list with IDs, names, and sectors
`get_planet_details`	Detailed per-planet info: biome, hazards, initial/current owner, health, waypoints, active events, full combat statistics, attacking planets, and regions (up to 5 planets per call)
`get_dispatches`	In-game dispatch feed — High Command broadcasts with published date (relative time) and message text; optional `limit` parameter (default 20, max 50)
`get_steam_news`	Steam news for Helldivers 2 with title, URL, publish date (relative time), and full article content; optional `limit` parameter (default 10, max 30)
`get_space_station_details`	DSS details: current host planet (full planet info), time until next election, and active tactical actions with name, description, status, planet effects, and resource costs

Quickstart

Prerequisites

Node.js 22+ or Docker
A contact email for the X-Super-Contact header (required by the upstream API)

Local dev

bash

cp .env.example .env   # set [email protected]npm installnpm run dev               # hot-reload via tsx watch on :3000

cp .env.example .env   # set [email protected]npm installnpm run dev               # hot-reload via tsx watch on :3000

Production build

Docker

Image is available on Docker Hub and GitHub Container Registry.

bash

docker pull xerno42/helldivers2-mcp        # pull from Docker Hub# ordocker pull ghcr.io/xerno42/helldivers2-mcp # pull from GHCR# ordocker build -t helldivers2-mcp . # build locally
#then run with:docker run -p 3000:3000 -e [email protected] helldivers2-mcp

docker pull xerno42/helldivers2-mcp        # pull from Docker Hub# ordocker pull ghcr.io/xerno42/helldivers2-mcp # pull from GHCR# ordocker build -t helldivers2-mcp . # build locally
#then run with:docker run -p 3000:3000 -e [email protected] helldivers2-mcp

Configuration

All configuration is via environment variables.

Variable	Default	Description
`X_SUPER_CONTACT`	(required)	Forwarded as `X-Super-Contact` to the upstream API per their usage guidelines
`PORT`	`3000`	HTTP port to listen on
`BIND_HOST`	`127.0.0.1`	Interface to bind (`0.0.0.0` for Docker/containers)
`MCP_ALLOWED_ORIGINS`	(unset)	Comma-separated list of allowed browser `Origin` headers. Unset means browser-originated requests are blocked; server-to-server calls (no `Origin` header) are always allowed
`MCP_RATE_LIMIT_PER_MIN`	`60`	Sustained request rate limit (requests per minute)
`MCP_RATE_LIMIT_BURST`	`= MCP_RATE_LIMIT_PER_MIN`	Burst capacity for the token-bucket rate limiter

Endpoints

The server uses the stateless Streamable HTTP transport. Each POST /mcp request creates a fresh McpServer + transport pair, handles the request, then tears them down. There is no session state.

Usage in Code

Call the MCP server directly over HTTP using the Streamable HTTP transport. Each request is a JSON-RPC tools/call message sent to POST /mcp.

JavaScript / TypeScript

Using the official MCP TypeScript SDK:

typescript

import { Client } from "@modelcontextprotocol/sdk/client/index.js";import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
const client = new Client({ name: "my-app", version: "1.0.0" });
const transport = new StreamableHTTPClientTransport(  new URL("https://mcp.avengersofsuperearth.com/mcp"));
await client.connect(transport);
// List available toolsconst { tools } = await client.listTools();console.log(tools.map((t) => t.name));
// Get current war statusconst warStatus = await client.callTool({  name: "get_war_status",  arguments: {},});console.log(warStatus.content[0].text);
// Get details for specific planets by index (up to 5)const planets = await client.callTool({  name: "get_planet_details",  arguments: { planetindices: [57, 153] },});console.log(planets.content[0].text);
await client.close();

import { Client } from "@modelcontextprotocol/sdk/client/index.js";import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
const client = new Client({ name: "my-app", version: "1.0.0" });
const transport = new StreamableHTTPClientTransport(  new URL("https://mcp.avengersofsuperearth.com/mcp"));
await client.connect(transport);
// List available toolsconst { tools } = await client.listTools();console.log(tools.map((t) => t.name));
// Get current war statusconst warStatus = await client.callTool({  name: "get_war_status",  arguments: {},});console.log(warStatus.content[0].text);
// Get details for specific planets by index (up to 5)const planets = await client.callTool({  name: "get_planet_details",  arguments: { planetindices: [57, 153] },});console.log(planets.content[0].text);
await client.close();

Without the SDK — raw JSON-RPC over fetch:

typescript

async function callTool(name: string, args: Record<string, unknown> = {}) {  const res = await fetch("https://mcp.avengersofsuperearth.com/mcp", {    method: "POST",    headers: {      "Content-Type": "application/json",      "Accept": "application/json, text/event-stream",    },    body: JSON.stringify({      jsonrpc: "2.0",      id: 1,      method: "tools/call",      params: { name, arguments: args },    }),  });  const text = await res.text();  // The response is an SSE frame ("event: message\ndata: {json}\n\n");  // concatenate its data line(s) to recover the JSON-RPC payload.  const json = text    .split("\n")    .filter((line) => line.startsWith("data:"))    .map((line) => line.slice(5).trim())    .join("");  const data = JSON.parse(json);  return data.result.content[0].text;}
const status = await callTool("get_war_status");const assignments = await callTool("get_assignments");const dispatches = await callTool("get_dispatches", { limit: 5 });const planets = await callTool("get_planet_details", { planetindices: [57, 153] });

async function callTool(name: string, args: Record<string, unknown> = {}) {  const res = await fetch("https://mcp.avengersofsuperearth.com/mcp", {    method: "POST",    headers: {      "Content-Type": "application/json",      "Accept": "application/json, text/event-stream",    },    body: JSON.stringify({      jsonrpc: "2.0",      id: 1,      method: "tools/call",      params: { name, arguments: args },    }),  });  const text = await res.text();  // The response is an SSE frame ("event: message\ndata: {json}\n\n");  // concatenate its data line(s) to recover the JSON-RPC payload.  const json = text    .split("\n")    .filter((line) => line.startsWith("data:"))    .map((line) => line.slice(5).trim())    .join("");  const data = JSON.parse(json);  return data.result.content[0].text;}
const status = await callTool("get_war_status");const assignments = await callTool("get_assignments");const dispatches = await callTool("get_dispatches", { limit: 5 });const planets = await callTool("get_planet_details", { planetindices: [57, 153] });

Python

Using the official MCP Python SDK:

python

import asynciofrom mcp import ClientSessionfrom mcp.client.streamable_http import streamablehttp_client
async def main():    async with streamablehttp_client("https://mcp.avengersofsuperearth.com/mcp") as (read, write, _):        async with ClientSession(read, write) as session:            await session.initialize()
            # List available tools            tools = await session.list_tools()            print([t.name for t in tools.tools])
            # Get current war status            result = await session.call_tool("get_war_status", {})            print(result.content[0].text)
            # Get details for specific planets by index (up to 5)            result = await session.call_tool(                "get_planet_details",                {"planetindices": [57, 153]},            )            print(result.content[0].text)
asyncio.run(main())

import asynciofrom mcp import ClientSessionfrom mcp.client.streamable_http import streamablehttp_client
async def main():    async with streamablehttp_client("https://mcp.avengersofsuperearth.com/mcp") as (read, write, _):        async with ClientSession(read, write) as session:            await session.initialize()
            # List available tools            tools = await session.list_tools()            print([t.name for t in tools.tools])
            # Get current war status            result = await session.call_tool("get_war_status", {})            print(result.content[0].text)
            # Get details for specific planets by index (up to 5)            result = await session.call_tool(                "get_planet_details",                {"planetindices": [57, 153]},            )            print(result.content[0].text)
asyncio.run(main())

Without the SDK — raw JSON-RPC over httpx:

python

import httpx
MCP_URL = "https://mcp.avengersofsuperearth.com/mcp"
def call_tool(name: str, arguments: dict = {}) -> str:    payload = {        "jsonrpc": "2.0",        "id": 1,        "method": "tools/call",        "params": {"name": name, "arguments": arguments},    }    headers = {        "Content-Type": "application/json",        "Accept": "application/json, text/event-stream",    }    response = httpx.post(MCP_URL, json=payload, headers=headers)    response.raise_for_status()    import json    # The response is an SSE frame ("event: message\ndata: {json}\n\n");    # concatenate its data line(s) to recover the JSON-RPC payload.    text = "".join(        line[5:].strip()        for line in response.text.splitlines()        if line.startswith("data:")    )    return json.loads(text)["result"]["content"][0]["text"]
status = call_tool("get_war_status")assignments = call_tool("get_assignments")planets = call_tool("get_planet_details", {"planetindices": [57, 153]})

import httpx
MCP_URL = "https://mcp.avengersofsuperearth.com/mcp"
def call_tool(name: str, arguments: dict = {}) -> str:    payload = {        "jsonrpc": "2.0",        "id": 1,        "method": "tools/call",        "params": {"name": name, "arguments": arguments},    }    headers = {        "Content-Type": "application/json",        "Accept": "application/json, text/event-stream",    }    response = httpx.post(MCP_URL, json=payload, headers=headers)    response.raise_for_status()    import json    # The response is an SSE frame ("event: message\ndata: {json}\n\n");    # concatenate its data line(s) to recover the JSON-RPC payload.    text = "".join(        line[5:].strip()        for line in response.text.splitlines()        if line.startswith("data:")    )    return json.loads(text)["result"]["content"][0]["text"]
status = call_tool("get_war_status")assignments = call_tool("get_assignments")planets = call_tool("get_planet_details", {"planetindices": [57, 153]})

Connecting to Claude Desktop

Hosted server (easiest)

A public instance is available at https://mcp.avengersofsuperearth.com/mcp. No setup required — just add it to your claude_desktop_config.json:

json

{  "mcpServers": {    "helldivers2": {      "url": "https://mcp.avengersofsuperearth.com/mcp"    }  }}

{  "mcpServers": {    "helldivers2": {      "url": "https://mcp.avengersofsuperearth.com/mcp"    }  }}

Self-hosted (local binary)

json

{  "mcpServers": {    "helldivers2": {      "command": "node",      "args": ["/path/to/helldivers2-mcp/dist/index.js"],      "env": {        "X_SUPER_CONTACT": "[email protected]"      }    }  }}

{  "mcpServers": {    "helldivers2": {      "command": "node",      "args": ["/path/to/helldivers2-mcp/dist/index.js"],      "env": {        "X_SUPER_CONTACT": "[email protected]"      }    }  }}

Self-hosted (HTTP server)

Development

bash

npm run test              # Jest (ESM mode)npm run test:watchnpm run test:coveragenpm run lint              # ESLint

npm run test              # Jest (ESM mode)npm run test:watchnpm run test:coveragenpm run lint              # ESLint

Run a single test file:

Adding a tool

Create src/tools/your-tool.ts and export a Tool object with .definition and .handler.
Import it and add it to the TOOLS array in src/index.ts.
Return textResponse(...) on success or errorResponse(...) on failure — never throw from a handler.
All upstream calls must go through hd2Fetch (in-memory 2-minute cache + rate-limit-aware queue).

License

MIT

Source: README.md at commit e7c9201

Tools

get_war_status

Get War Status

Fetch the current war status and active planets. Returns aggregated war statistics (impact multiplier, total missions won, total missions lost, total mission time, total terminid kills, total automaton kills, total illuminate kills, total bullets fired, total bullets hit, total deaths, total revives, total friendly fire casualties, overall mission success rate, overall accuracy), and a list of active planets (planets with active players or ownership change) with their name, sector, initial owner, current owner, player count, active event information if any (Event: faction, current health, max health, start and end time), the planets each active planet is currently attacking (id and name), and active regions (Region: name, health, max health, regen per second, size, active players).

Takes no parameters.

get_assignments

Get Assignments

Fetch the currently active assignments (Major Orders) issued by Super Earth high command. Returns each assignment with title, briefing, task description, decoded task list (type and value information including races, difficulties, and target planet names), current progress numbers, reward (type and amount), and expiration (seconds until expiry).

Takes no parameters.

get_all_planets

Get All Planets

Fetch a list of all planets in the current galactic war. Returns a list of planets with their id (index), name, and sector.

Takes no parameters.

get_planet_details

Get Planet Details

Fetch detailed information about one or more planets by providing their planet index/indices. Requires: planetindices parameter (array of integers of planet indices, maximum of 5) Returns: For each planet - index, name, sector, biome (Biome: name, description), hazards (Hazard: name, description), position, list of waypoints (planet indices) the planet is connected to, max health, current health, initial owner, current owner, regen per second, event information if one is active (faction who initiated the event, current health, max health, start and end time), statistics (Statistics: missions won, missions lost, mission time, terminid kills, automaton kills, illuminate kills, bullets fired, bullets hit, time played, deaths, revives, friendly fire casualties, mission success rate, accuracy, player count), attacking (a list of planet indices this planet is currently attacking), regions (Region: name, description, health, max health, size, regen per second, active players).

Parametersplanetindicesrequired

get_dispatches

Get Dispatches

Fetch the latest dispatches (news feed) from Super Earth high command. Returns recent dispatches with their published date (relative time) and message text. Optional `limit` parameter caps how many items to return (default 20, max 50).

Parameterslimit

get_steam_news

Get Steam News

Fetch the latest Steam news for Helldivers 2. Returns recent items with title, URL, published date (relative time), and content. Optional `limit` parameter caps how many items to return (default 10, max 30).

Parameterslimit

get_space_station_details

Get Space Station Details

Fetch the current Democracy Space Station (DSS) details. Returns the planet the DSS is currently supporting (full planet details), election end (relative time until the next planet vote ends), and a list of active tactical actions (Tactical action: name, description, strategic description, status, status expire, effects (Effect: name, description), costs (Cost: item name, current value, delta per second, max donation amount)).

Takes no parameters.

Version history

v1.0.2LatestSep 26, 2026
v1.0.1Sep 16, 2026

Score

100% 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 daysRequired25 pts
Auth declaredRequired10 pts
Tools listedRequired15 pts
DescriptionRequired15 pts
Logo10 pts
Documentation15 pts
License10 pts

Method	Path	Description
`POST`	`/mcp`	MCP Streamable HTTP transport endpoint
`GET`	`/health`	Liveness check — returns `{ "ok": true }`

Registry	Package
npm	`helldivers2-mcp`
Docker Hub	`xerno42/helldivers2-mcp`
GitHub Container Registry	`ghcr.io/xerno42/helldivers2-mcp`
MCP Registry	`io.github.xerno42/helldivers2-mcp`