Skip to content
Agentmart
Submit a tool

HOI4 Agent Tools

Build HOI4 mods: focus trees, events, decisions, worlds, GUI previews, docs and AI balance.

Connector by klimPaskov · GitHub account verified by the MCP Registry

IndexedApache-2.0Local (stdio)★ 6
Write a review

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/klimpaskov-hoi4-agent-tools

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

We use your email only for this newsletter. Privacy

About

Build HOI4 mods: focus trees, events, decisions, worlds, GUI previews, docs and AI balance.

Reviews

Write a review

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 25, 2026.

Tools
20 read · 6 write · 4 delete
Secrets
None asked for
Install scripts
None found
Runs as
Node.js package

Tools by what they do 30

Read from the source code; the running server may list different tools.

Read 20 · Look things up without changing anything.

  • chaosx.visual_revision
  • hoi4.decision_inspect
  • hoi4.error_log
  • hoi4.event_inspect
  • hoi4.event_render
  • hoi4.impact_inspect
  • hoi4.job_inspect
  • hoi4.mechanic_test
  • hoi4.mod_index
  • hoi4.package_check
  • hoi4.probability_analyze
  • hoi4.probability_inspect
Show 8 more tools
  • hoi4.reference_context
  • hoi4.reference_read
  • hoi4.reference_search
  • hoi4.scenario_test
  • hoi4.script_validate
  • hoi4.source_lookup
  • hoi4.tech_inspect
  • hoi4.tech_render

Write 6 · Create, change, send or run things.

  • chaosx.focus_country_assets
  • hoi4.focus_inspect
  • hoi4.focus_render
  • hoi4.gui_inspect
  • hoi4.gui_render
  • hoi4.map_inspect

Delete 4 · Delete, drop, revoke or wipe things.

  • hoi4.focus_rewrite
  • hoi4.gui_rewrite
  • hoi4.job_cancel
  • hoi4.map_rewrite

Network hosts it talks to 15

  • api.github.com · found in code
  • feross.org · found in code
  • ghcr.io · found in code
  • github.com · found in code
  • in-toto.io · found in code
  • mobyproject.org · found in code
  • opencollective.com · found in code
  • patreon.com · found in code
  • paulmillr.com · found in code
  • public-install.example.test · found in code
  • slsa-framework.github.io · found in code
  • slsa.dev · found in code
  • spdx.dev · found in code
  • tidelift.com · found in code
  • token.actions.githubusercontent.com · found in code

Files it touches

  • Your home directory (~)

Tools (30)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

  • chaosx.focus_country_assetsRender ChaosX focus country assets

    Private ChaosX Discord integration endpoint. Returns country flags and leader portraits to accompany a focus-tree raster; it is not intended for coding-agent workflows.

  • chaosx.visual_revisionCheck ChaosX visual revisionsread-only

    Private ChaosX cache-coherency endpoint. Computes exact scripted-GUI source revisions without rendering PNG artifacts.

  • hoi4.decision_inspectInspect decisions and missionsread-only

    Explain why a decision or mission is hidden, unavailable or unaffordable. Inspect conditions, costs and lifecycle for declared actors and targets, or compare proposed source. Example: {"mode":"inspect","id":"my_decision","scenarios":[{"id":"base","actor":"GER","state":{}}]}. Returns each scenario outcome inline; full evidence is linked.

  • hoi4.error_logRead the game error logread-only

    Find errors from the last game launch and group them by category, with source files, lines and fix hints. Show which files changed since the log and which errors appeared after a relaunch; mod entries come first. Example: {"scope":"mod","category":"effect"}. Returns at most 20 entries (limit 50) with fix hints and which entries are new since the previous launch.

  • hoi4.event_inspectInspect event chainsread-only

    Follow event chains and explain their options, conditions, timing and state changes. Find broken calls, inspect affected events or compare revisions with mode compare. Example: {"mode":"trace","selector":"my_mod.1","direction":"downstream"}; a selector is an event ID, a namespace, my_mod.* or a file. Returns counts and the main findings inline; the full source-linked report is a resource.

  • hoi4.event_renderPreview event chainsread-only

    Preview event routes, options, timing, state and scope as JSON, SVG and PNG. Example: {"view":"overview","selector":"my_mod"}. Images are linked artifacts; calls that cannot be resolved statically stay explicit unresolved edges.

  • hoi4.focus_inspectInspect focus trees

    Find focus branches, prerequisites, layout problems and missing references in national trees and continuous-focus palettes. Example: {"treeId":"my_focus_tree"}. Returns counts and the main diagnostics inline; the full report is a linked resource.

  • hoi4.focus_renderPreview a focus tree or continuous palette

    Preview a focus tree or palette with its icons. Export PNG, HTML, SVG and JSON source maps; png:false skips the PNG and cropFocusIds adds close-ups. Example: {"relativePath":"common/national_focus/my_tree.txt","treeId":"my_focus_tree"}. Images are linked artifacts, not inline.

  • hoi4.focus_rewriteBuild or arrange a focus treecan change or delete data

    Create focus trees and continuous-focus palettes, or rearrange existing branches. Use createIfMissing with a complete plan to create content, or layoutMode to arrange an existing tree. Example: {"relativePath":"common/national_focus/my_tree.txt","treeId":"my_focus_tree","layoutMode":"compact"}. Returns the changed files.

  • hoi4.gui_inspectInspect a window

    Find the elements, assets and script behind a window, including layout problems, localisation and fonts. Example: {"windowName":"my_window"}. Returns element counts and fidelity inline; the full scene is a linked resource.

  • hoi4.gui_renderPreview a window

    Preview a window at different resolutions and states. Shows control regions, element hierarchy and layout problems; unknown visibility stays unresolved. Example: {"windowName":"my_window","scenario":{"id":"normal","flags":{"my_flag":true}}}. Images and reports are linked resources.

  • hoi4.gui_rewriteCreate or edit a windowcan change or delete data

    Create or edit a window using complete source, structured helpers or exact patches. Include related text files with additionalFiles; binary art must already be in the mod. Example: {"mode":"helpers","relativePath":"interface/my_window.gui","windowName":"my_window","scenario":{"id":"normal"},"helper":{...}}. Returns the changed files.

  • hoi4.impact_inspectFind what a script change affectsread-only

    Find what a script change affects across focuses, events, decisions, ideas, windows and helpers. Trace definitions and their uses, including proposed source. Example: {"symbols":[{"kind":"scripted_effect","id":"my_effect"}]}. Returns consumer counts inline; the revision-bound graph is a linked resource.

  • hoi4.job_cancelStop a background taskcan change or delete data

    Stop a background task by jobId. A result that has already completed stays available. Example: {"jobId":"job_<64 hex characters>"}.

  • hoi4.job_inspectCheck a background taskread-only

    Check progress on a background task or retrieve its completed result. Pass jobId from the task handle. Example: {"jobId":"job_<64 hex characters>"}. Returns task status or the completed result.

Show 15 more tools
  • hoi4.map_inspectExplore and preview the map

    Explore and preview the map. Find provinces, states and regions by name, ID or coordinates, inspect map problems and script references, or render a layer, tile or area. Use lookupOnly for a quick lookup and references:true for script references. Example: {"query":"Brandenburg","lookupOnly":true}. Returns counts and matches inline; PNG, HTML and the catalog are artifacts.

  • hoi4.map_rewriteBuild a world or edit the mapcan change or delete data

    Build a world from a reference image or a geography model (geography, geographyPath), or edit provinces, states, regions and supply. Example: {"preview":true,"operations":[{"kind":"create_world","reference":{"imagePath":"references/world.png"}}]}. Preview first to check coastlines, terrain and countries, or a model overlay and report; omit preview to write the generated map and starting scenario (models with biomes or climate are blocked until that stage exists). Returns counts, diagnostics and linked PNGs.

  • hoi4.mechanic_testTest scripted effectsread-only

    Test what an effect, event option, decision or focus reward does to a declared state. Run steps and check assertions; unsupported effects stay unresolved. See docs/mechanics.md. Example: {"test":{"id":"t","scenario":{"schemaVersion":"1.0","id":"t","state":{"treasury":10}},"steps":[...],"assertions":[...]}}.

  • hoi4.mod_indexExplore mod content and find free IDsread-only

    Summarize the content in a mod or find a free event ID across the mod, game and dependencies. Use overview for descriptors, folders and definitions, or next_id with a namespace or prefix. Example: {"mode":"next_id","kind":"event","namespace":"my_mod"}. Returns a compact summary; the first call indexes the mod, which takes seconds on a large one.

  • hoi4.package_checkCheck package connectionsread-only

    Find missing pieces of a feature by checking its package manifest against definitions, calls, registrations, localisation, assets and required test cases. Example: {"manifest":{"schemaVersion":"1.0","id":"my_package","definitions":[{"kind":"scripted_effect","id":"my_effect"}]}}. Returns present, absent, shadowed and unresolved counts inline.

  • hoi4.probability_analyzeCompare AI choices and random outcomesread-only

    Compare AI weights before and after an edit, find where a choice changes, or explore uncertain inputs and choices over time. Select compare, sweep, simulate, sequence or render with analysis. Example: {"analysis":"sweep","source":"common/decisions/my_decisions.txt","candidatePool":["my_decision"],"scenarioSet":[{"actor":"GER","state":{"variable.pressure":10}}],"sweep":{"paths":["variable.pressure"],"steps":10}}.

  • hoi4.probability_inspectExplain AI choices and event timingread-only

    Explain why the AI favours an option, decision, focus or technology. Find ai_will_do, ai_chance, MTTH, random_list or strategy factors by path, ID or candidate IDs and evaluate them under declared scenarios. Show weights, supported probabilities and missing facts. Example: {"candidatePool":["my_decision"],"scenarioSet":[{"actor":"GER","state":{"has_war":false}}]}. Ranks the strongest candidates inline.

  • hoi4.reference_contextFind docs for a modding taskread-only

    Find documentation for the content you are building: events, decisions, ideas, focuses, technology, GUI, maps, localisation or AI. Example: {"surface":"event","question":"fire an event after a delay"}. Returns up to 16 short sections; read more with hoi4.reference_read.

  • hoi4.reference_readRead a modding ruleread-only

    Read a documentation section returned by reference_search or reference_context. Pass its id and revision. Example: {"id":"<hit id>","revision":"<hit revision>"}. Returns at most 80 lines (40 by default) and 8,000 bytes, with a line to continue from.

  • hoi4.reference_searchFind a modding ruleread-only

    Find the right modding rule in the offline wiki and installed game docs using ordinary words or script names. Each hit includes its file, lines, revision and answering line. Example: {"query":"add_timed_idea"}. Returns 6 hits by default (up to 12); read one with hoi4.reference_read using its id and revision.

  • hoi4.scenario_testRun scenario suiteread-only

    Run named mechanic, package or inspection cases from a suite or workspace file. Continue unfinished batches and report failures and unresolved cases. Example: {"suitePath":"tests/my_suite.json","maxCases":20}. Returns completed, failed, unresolved and pending counts, and a continuation while cases remain.

  • hoi4.script_validateCheck HOI4 script commands and scopesread-only

    Find broken syntax, commands and scopes in an effect, trigger or mod file using the installed docs. Unknown helpers and native argument blocks stay unresolved. Example: {"source":"add_political_power = 10","kind":"effect","scope":"country"} or {"path":"events/a.txt"}. Returns up to 12 findings.

  • hoi4.source_lookupFind definitions and usagesread-only

    Find where a script symbol is defined and used across the game, DLC and mod. Pass a symbol, or a file path and line. Example: {"symbol":"my_scripted_effect"}. Returns up to 3 definitions with source text and 10 usages; keyPath and view=structure navigate nested blocks.

  • hoi4.tech_inspectInspect technology treesread-only

    Explain technology and doctrine paths, unlocks, bonuses and dependencies. Find layout or reference problems and compare revisions with mode compare. Example: {"mode":"explain","technologyId":"my_tech"}. Returns counts and the main findings inline; the full report is a linked resource.

  • hoi4.tech_renderPreview technology treesread-only

    Preview technology folders and doctrines with their icons, item sizes and year guides. Show dependencies, bonuses, grants, unlocks or unresolved references as JSON, SVG and PNG. Example: {"view":"folder","folderId":"my_folder"}. Images are linked artifacts.

Signals

Stars
6
Forks
1
Open issues
0
Last commit
Oct 19, 2026 (10 days ago)
Last release
Oct 25, 2026 (4 days ago)

From GitHub (fetched Oct 24, 2026).

Details

Registry name
io.github.klimPaskov/hoi4-agent-tools
Version
4.6.1
Auth
No auth
Packages
npm hoi4-agent-tools
License
Apache-2.0
Repository
github.com/klimPaskov/hoi4-agent-tools
Website
github.com/klimPaskov/hoi4-agent-tools#readme
First seen
Oct 24, 2026
Last checked
Oct 26, 2026
Source
Official MCP Registrygithub-graphql
Cite this page

HOI4 Agent Tools MCP server. Agent Mart. https://agentmart.dev/connectors/klimpaskov-hoi4-agent-tools (last updated 2026-10-26)