EU5 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 binary, required to read normal and ironman (binary, zipped) saves. Can be omitted if rakaly is on your PATH or found in ~/Downloads/rakaly-*. | |
| EU5_GAME_DIR | No | Environment override for the Europa Universalis V game install directory (used to detect the game version and read localisation files). | |
| EU5_SAVE_DIR | No | One or more folders to search for EU5 save files. Use this when saves are in a non-standard location, e.g. cloud streaming or a VM. | |
| EU5_USER_DIR | No | Environment override for the user directory used to locate Paradox Interactive save folders. |
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 V campaign. Start with eu5_load_save (or eu5_list_saves), then eu5_find_problems and the reports (overview, economy, locations, diplomacy, wars, rankings). EU5's save schema evolves between patches: when a report lacks something, use eu5_country_raw, eu5_query and eu5_search to read the raw data, and eu5_wiki_search/eu5_wiki_page for rules. Ground advice in the save's numbers and say when data is missing.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| prompts | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| eu5_environmentA | Detect OS (EU5 is Windows-native; Linux via Proton, macOS via CrossOver/Whisky), save folders, game install + version, language and rakaly availability. |
| eu5_list_savesB | List .eu5 saves newest first with in-game date, country, version and format (text/binary). |
| eu5_load_saveB | Parse a save (plaintext natively, binary via rakaly) and return a campaign summary with the player's snapshot. |
| eu5_country_overviewC | Gold, manpower, stability, prestige, traditions, income/expense, tax & trade, great power rank, territory (locations, control, development), rulers and wars — plus all other scalar fields of the country. |
| eu5_economyB | Economy block, every income/tax/trade/maintenance field, loans, and the locations with the most untapped tax. |
| eu5_locationsC | Owned locations with development, control, prosperity, tax vs possible tax, market access, raw material, settlement rank, religion and occupation; plus averages and counts. |
| eu5_diplomacyC | Overlord, subjects (with liberty desire), the country's diplomacy record, and wars it is in. |
| eu5_warsB | Wars in the save (or involving a country): start date, sides, war score where present, battles. |
| eu5_find_problemsB | Find problems and opportunities (deficit, negative gold, loans, stability, prestige, manpower, low control, untapped tax, market access, occupation, multi-front wars) with advice. |
| eu5_rankingsC | Rank countries by a metric and show the player's position. |
| eu5_compare_savesC | Compare a country between an older and a newer save (gold, income, manpower, stability, prestige, locations, control, rank). |
| eu5_country_rawA | Depth-limited raw dump of a country's record in the save, for fields the reports don't cover. |
| eu5_queryA | Read any field by dotted path, e.g. 'metadata', 'countries.tags', 'war_manager.database.5'. Empty path lists top-level sections. |
| eu5_searchC | Find keys (and optionally values) matching a regex, optionally under a path. |
| eu5_wiki_searchB | Search the official Europa Universalis V wiki (eu5.paradoxwikis.com) for mechanics, buildings, laws, etc. |
| eu5_wiki_pageC | Fetch an EU5 wiki page as plain text (truncated). |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| campaign_review | Load the latest save and give a strategic review. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 16 tools
The domain tools (country_overview, economy, locations, diplomacy, wars) target distinct facets of a save and have descriptions that clarify boundaries. The only real overlap is among the generic introspection trio (country_raw, query, search) and their relation to country_overview, where an agent may hesitate between a raw dump, a dotted-path read, and a regex search.
All 16 tools share a uniform eu5_ prefix and snake_case, which is highly predictable. Minor inconsistency: action tools use verb_noun (list_saves, load_save, find_problems, compare_saves, wiki_search) while analysis tools are bare nouns (economy, locations, wars).
Sixteen tools is at the upper edge of ideal but each maps to a recognizable analysis task (environment, discovery, reporting, comparison, introspection, wiki lookup). Nothing looks like filler, though the retrieval layer plus the wiki layer together push it slightly past the comfortable range.
The surface covers the full read-only lifecycle: detect environment, list saves, load, then analyze country/economy/locations/diplomacy/wars, rank, compare saves, and consult wiki. Gaps are secondary domains such as military/army detail, technology, and buildings, but the generic query/search/raw tools provide an escape hatch for uncovered fields.