EU4 Save Advisor
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| RAKALY_PATH | No | Path to the rakaly CLI executable used to decode ironman/binary saves. Optional; only needed for ironman/binary saves. | |
| EU4_GAME_DIR | No | Override the Europa Universalis IV game install directory. Auto-detected if not set. | |
| EU4_SAVE_DIR | No | Override save folder(s). One or more folders, separated by `;` on Windows or `:` elsewhere. Auto-detected if not set. | |
| EU4_USER_DIR | No | Override the Europa Universalis IV user directory. Auto-detected if not set. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
Tools for chatting with a Europa Universalis IV campaign. Start with eu4_load_save (or eu4_list_saves), then use eu4_find_problems for a health check and the specific reports (economy, military, diplomacy, provinces, wars, rankings, trends) to answer questions. All data comes from the user's own save file; ground advice in those numbers and say when a value is missing. Use eu4_query / eu4_search to look up raw fields not covered by the reports.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| prompts | {
"listChanged": true
} |
| resources | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| eu4_environmentA | Detect OS, EU4 user/save folders, game install + version, language, and whether the rakaly CLI (needed for ironman saves) is available. Call this first if saves can't be found. |
| eu4_list_savesB | List EU4 save files (newest first) with date, player country, version, ironman flag and size. |
| eu4_load_saveA | Parse a save (text, compressed, or ironman via rakaly) and return a campaign summary: date, player, version, DLCs, mods and the player's headline stats. Later tools reuse this save by default. |
| eu4_country_overviewB | Headline state of a country: ruler/heir stats, government, tech, monarch points, ideas, treasury & balance, loans, stability, prestige, war exhaustion, overextension, manpower, army/navy size, subjects and wars. |
| eu4_economyB | Last month's income/expense breakdown (taxation, production, trade, army maintenance …) with percentages, last year totals, lifetime spending, loans with interest, inflation and corruption. |
| eu4_militaryC | Armies (regiments by infantry/cavalry/artillery, strength, morale, location), navies, manpower, traditions, professionalism, and a strength comparison against rivals and current enemies. |
| eu4_diplomacyA | Alliances, royal marriages, subjects (with liberty desire), overlord, guarantees, rivals and who rivals you, active wars, and the best/worst opinions toward the player's country. |
| eu4_warsA | All active wars (or only those involving a country): sides, war goal, participants' contribution and losses, recent battles. |
| eu4_provincesC | Owned provinces with development, trade goods, culture/religion mismatches, cores, autonomy, devastation, buildings, occupation. Also lists uncored provinces and trade-good totals. |
| eu4_find_problemsA | Scan a country for problems and missed opportunities (deficits, loans, inflation, low stability, overextension, wasted monarch points, empty idea slots, tech gaps, low manpower, rebels, estates, succession…) with concrete advice, sorted by severity. |
| eu4_rankingsC | Rank all living countries by a metric and show where the player stands. |
| eu4_compare_countriesC | Side-by-side comparison of several countries (development, economy, tech, manpower, army, navy, stability…). |
| eu4_trendsA | Yearly history of a country's income, size, score and inflation recorded by the game ledger since the campaign start. |
| eu4_compare_savesA | Compare a country between an older and a newer save of the same campaign (development, provinces, income, debt, tech, army, rank…). |
| eu4_queryA | Read any raw field by dotted path, e.g. 'countries.FRA.technology', 'provinces.-183', 'diplomacy', 'great_powers'. Returns a depth-limited preview. Use eu4_search to discover paths. |
| eu4_searchA | Find keys (and optionally values) matching a regex anywhere in the save, optionally under a path (e.g. under='countries.FRA'). |
| eu4_explainA | Short explanation + tips for an EU4 mechanic (overextension, aggressive expansion, stability, war exhaustion, inflation, corruption, monarch points, ideas, development, trade, institutions, manpower, autonomy, estates, loans) with a wiki link. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| campaign_review | Load the latest save and give a full strategic review. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| eu4-wiki | Link to the official EU4 wiki |
TDQS
Scored across 17 tools
Each tool is anchored to a distinct facet: overview, economy, military, diplomacy, wars, provinces, with separate comparison, ranking, and problem-scanning tools. The only real soft spots are eu4_query vs eu4_search (read-by-path vs regex discovery), which partially overlap, and the boundary between eu4_country_overview and the per-facet tools, though descriptions clarify that the latter go deeper. An agent can pick the right tool in nearly all cases.
Every tool uses the same eu4_ prefix with snake_case verb or noun phrasing (eu4_list_saves, eu4_load_save, eu4_find_problems, eu4_compare_countries). No style mixing, and the noun-based tools like eu4_economy/eu4_military are uniform among themselves.
17 tools is at the upper end but each maps to a real analysis facet of an EU4 save (discovery, loading, five stat domains, comparisons, raw access, explainer), so little feels redundant. Slightly heavy, but justified by the breadth of the domain rather than padding.
The surface covers discovery, environment checks, save loading, core country domains, cross-save and cross-country comparison, plus an escape hatch (eu4_query/eu4_search) for anything not covered. Minor gaps exist around granular domains like religion, culture, estates detail, missions/decisions, or trade-node level data, and there is no export/report output, but agents can work around these via raw queries.