HOI4 Agent Tools MCP Server

HOI4 Agent Tools is an MCP server for coding agents to understand Hearts of Iron IV event chains, technology systems, AI weights, and MTTH timing and to inspect, create, or clean up focus trees, scripted GUIs, and maps. It produces source-linked structural and visual evidence that agents can use inside a larger modding workflow. Its 23 documented tools cover hoi4, probability, inspect, render.

People who work with hoi4, probability and inspect and want it reachable from Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-09-08 · ★ 5 · #35 OF 229 MAINTAINED CODING AGENT · VERIFIED 2026-09-18

Apache-2.0 · TypeScript servers · how we verify → /methodology

01 · Install HOI4 Agent Tools

Claude Code

claude mcp add klimpaskov-hoi4-agent-tools -- npx -y hoi4-agent-tools

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "klimpaskov-hoi4-agent-tools": {
      "command": "npx",
      "args": [
        "-y",
        "hoi4-agent-tools"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license Apache-2.0 - declared in the repository

npm package hoi4-agent-tools - unscoped; check the name against the project README before installing

registry namespace io.github.klimPaskov is GitHub-verified and matches the repo owner

03 · What HOI4 Agent Tools can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can read focus trees, continuous-focus placement, and structural or reference problems, create or update a focus tree, read a scripted GUI and its linked assets and logic, and create or update a GUI source package.

The 23 tools it gives your agent

Extracted from the project's README - what HOI4 Agent Tools lets an agent do.

hoi4.focus_inspect: - Read focus trees, continuous-focus placement, and structural or reference problems.
hoi4.focus_render: - Produce fast HTML, SVG, JSON, and source-linked layout artifacts.
hoi4.focus_raster: - Produce a high-fidelity PNG review with decoded source icons.
hoi4.focus_rewrite: - Create or update a focus tree.
hoi4.gui_inspect: - Read a scripted GUI and its linked assets and logic.
hoi4.gui_render: - Render generated and explicit GUI scenarios, states, resolutions, and layout diagnostics.
hoi4.gui_rewrite: - Create or update a GUI source package.
hoi4.map_inspect: - Search, click, navigate, and inspect the complete rendered map and its linked data.
hoi4.map_render: - Render full-map layers, overlays, names, IDs, coordinates, and source-linked catalogs.
hoi4.map_rewrite: - Create or update states, provinces, IDs, networks, positions, and connected map data.
hoi4.event_inspect: - Scan, trace, explain, lint, or assess event chains and their state flow.
hoi4.event_render: - Render source-linked event routes, options, timing, state, scope, and unresolved edges.

show all 23 tools

hoi4.event_compare: - Compare event-chain topology and diagnostics between revisions.
hoi4.tech_inspect: - Scan, trace, explain, lint, and assess technology and doctrine systems.
hoi4.tech_render: - Render source layouts with real item sizes and year guides, plus dependencies and assets.
hoi4.tech_compare: - Compare technology graphs, placements, references, diagnostics, and source overlays.
hoi4.probability_inspect: - Locate weighted logic and discover compatible adapters, candidates, and required inputs.
hoi4.probability_evaluate: - Evaluate exact values, probabilities, timing, bounds, and unresolved inputs.
hoi4.probability_sweep: - Find sensitivity, breakpoints, cliffs, and rank reversals across declared ranges.
hoi4.probability_simulate: - Run deterministic sampled analysis with confidence and convergence data.
hoi4.probability_sequence: - Analyze declared recovery, caps, cooldowns, resets, timers, and terminal states.
hoi4.probability_compare: - Attribute AI-weight and MTTH changes between real or proposed source.
hoi4.probability_render: - Render cached rankings, matrices, timing, sensitivity, sequence, and comparisons.

Latest releases

v3.0.9 · 2026-09-08

Unreleased · No unreleased changes. · 3.0.9 - 2026-09-08 · Evaluate GUI scripted-localisation branches through the shared structured condition evaluator instead of regex threshold guesses. · Correct inclusive…

04 · Who maintains HOI4 Agent Tools

HOI4 Agent Tools is maintained by klimpaskov. It's the only MCP server we track from this author; the repo dates to Jul 2026.

05 · Facts

repository: github.com/klimpaskov/hoi4-agent-tools
website: https://github.com/klimPaskov/hoi4-agent-tools#readme
category: coding agent - ranked #35 of 229 actively-maintained coding agent servers as of 2026-09-18.
release cadence: 1 release in the last 90 days (latest 2026-09-08)
registry: io.github.klimPaskov/hoi4-agent-tools (active, first published 2026-07-11 · 47 versions)
packages: npm:hoi4-agent-tools

06 · HOI4 Agent Tools FAQ

Is HOI4 Agent Tools still maintained?

Yes - as of 2026-09-18, its last commit was 2026-09-08 and it shipped 1 release in the last 90 days. We re-verify nightly.

What can HOI4 Agent Tools do?

How do I install HOI4 Agent Tools?

Run `npx -y hoi4-agent-tools`. You can also paste the ready-made client config above.

Does HOI4 Agent Tools run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to HOI4 Agent Tools

Alternatives to HOI4 Agent Tools

Maintained coding agent servers if HOI4 Agent Tools isn't the fit.

Pairs well with

Servers that cover what HOI4 Agent Tools doesn't - only shown when the pairing reason fits the companion.

More coding agent MCP servers · Excel MCP Server (FsOpenXmlDsl) · Koragraph · Topos · CLEO MCP Server · True Memory Fragments

More TypeScript MCP servers · Wigolo · GIA - Governed Intelligence Architecture · World Monitor · MoldSim MCP Server · Kolonie AI · see all