HOI4 Agent Tools MCP Server

Give your coding agent one MCP server for Hearts of Iron IV modding. It can find local documentation and vanilla examples, inspect a mod, render its trees and interfaces, compare source behavior, and make focused edits to focus trees, GUIs and maps.

People who work with coding agents, hearts of iron iv and hoi4 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-27 · ★ 6 · #22 OF 250 MAINTAINED CODING AGENT · VERIFIED 2026-09-30

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.

Latest releases

v3.6.0 · 2026-09-27

HOI4 Agent Tools 3.6.0 · Give your coding agent one MCP server for Hearts of Iron IV modding. Point it at a mod and an installed copy of the game to find relevant rules, trace content through source files, and preview…

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 #22 of 250 actively-maintained coding agent servers as of 2026-09-30.
release cadence: 1 release in the last 90 days (latest 2026-09-27)
registry: io.github.klimPaskov/hoi4-agent-tools (active, first published 2026-07-11 · 55 versions)
packages: npm:hoi4-agent-tools

06 · HOI4 Agent Tools FAQ

What is HOI4 Agent Tools?

Is HOI4 Agent Tools still maintained?

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

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 · World Monitor · MoldSim MCP Server · Kolonie AI · Komnet · see all