EU5 Save Advisor
Reads and analyzes locally stored Europa Universalis V save files from Paradox Interactive games, enabling campaign summaries, economy and location insights, diplomacy and war analysis, rankings, problem detection, and comparisons between saves.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@EU5 Save Advisor Why is my gold going down in my current EU5 save?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
EU5 Save Advisor — MCP server for Europa Universalis V
Chat with your Europa Universalis V campaign. This Model Context Protocol server lets Claude (Claude Desktop, Claude Code, or any MCP client) read your save files and answer questions with real numbers from your game:
"Why is my gold going down?" · "Which of my locations have the worst control?" · "How do I compare to the other great powers?" · "What changed since my last save?" · "How does control actually work?"
It is read-only, runs locally, and adapts to your platform and game version.
Platform support
EU5 is a Windows game. The server knows where saves end up on every setup:
Setup | Save folder searched automatically |
Windows |
|
Linux (Steam Proton) |
|
macOS via CrossOver / Whisky |
|
Steam Cloud copy |
|
Cloud streaming / VM | copy the |
Run eu5_environment to see exactly what was detected (OS, folders, game install + version, language, rakaly).
Related MCP server: ck3-strategy-advisor
Save formats
Save type | How it is read |
Debug-mode saves (plaintext) | ✅ built in — start EU5 with the launch option |
Normal & ironman saves (binary, zipped) | ✅ via the free rakaly CLI if your rakaly build supports EU5 |
Paradox's binary format uses a token table that is not public; rakaly (the engine behind pdx.tools) decodes it. Download the build for your OS, extract it, and put it on your PATH or point RAKALY_PATH at it (the server also looks in ~/Downloads/rakaly-*). If your rakaly version cannot read a brand-new EU5 patch yet, you'll get a clear message — update rakaly or use a debug-mode save.
Tools
Tool | What you get |
| OS, platform notes, save folders, game install/version, language, rakaly status |
| Saves newest first with date, country, version, format |
| Campaign summary + player snapshot |
| Gold, manpower, stability, prestige, traditions, income/expense, tax & trade, great-power rank, territory, rulers, wars — plus every other scalar field of your country |
| All economic fields, loans, and the locations with the most untapped tax |
| Development, control, prosperity, tax vs possible tax, market access, raw materials, ranks, occupation |
| Overlord, subjects with liberty desire, your diplomacy record, wars |
| Wars with sides and battles |
| Health check: deficit, debt, stability, prestige, manpower, control, untapped tax, market access, occupation, multi-front wars |
| Great-power rank, gold, income, manpower, prestige, stability, locations, score, tax base |
| Your progress between two saves |
| Raw access to any part of the save — EU5's schema changes between patches, so nothing is out of reach |
| The official EU5 wiki for rules and mechanics |
There is also a campaign_review prompt.
Install
Claude Desktop (one click)
Download
eu5-save-mcp.mcpbfrom the latest release.Double-click it (or drag it into Claude Desktop → Settings → Extensions) and press Install.
Optional: set your save folder and the path to
rakaly.
Claude Code
claude mcp add eu5 -- npx -y github:adnan-kutay-yuksel/eu5-save-mcpAny MCP client
{
"mcpServers": {
"eu5": {
"command": "npx",
"args": ["-y", "github:adnan-kutay-yuksel/eu5-save-mcp"],
"env": { "EU5_SAVE_DIR": "", "RAKALY_PATH": "" }
}
}
}Environment overrides: EU5_SAVE_DIR (one or more folders), EU5_USER_DIR, EU5_GAME_DIR, RAKALY_PATH. Requires Node.js 18+ (Claude Desktop bundles its own for .mcpb).
How it reads the save
An EU5 save starts with a one-line header (SAV02…) that says whether it is a debug (text) or packed (binary) save. Text saves are parsed by a fast, dependency-free Clausewitz parser; packed saves are a ZIP (gamestate + string_lookup) that rakaly melts to text first. Country, location and character data are interpreted using the field names of the open-source eu5save models from rakaly/jomini; location names come from the save's own location list and, when the game is installed, from your localisation files.
Development
npm install
npm run typecheck
npm test # parser, analysis and stdio MCP integration tests
npm run build # bundles to dist/index.js (committed so `npx github:` works)
npm run pack # builds eu5-save-mcp.mcpbRelated
License
MIT. Not affiliated with or endorsed by Paradox Interactive. Europa Universalis is a trademark of Paradox Interactive AB.
Available Tools
16 toolseu5_compare_savesProgress between two savesC
Compare a country between an older and a newer save (gold, income, manpower, stability, prestige, locations, control, rank).
Inputs: older (required), newer, country.
eu5_country_overviewCountry 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.
Inputs: save, country.
eu5_country_rawRaw country recordA
Depth-limited raw dump of a country's record in the save, for fields the reports don't cover.
Inputs: save, depth, country, section.
eu5_diplomacyDiplomacy reportC
Overlord, subjects (with liberty desire), the country's diplomacy record, and wars it is in.
Inputs: save, country.
eu5_economyEconomy reportB
Economy block, every income/tax/trade/maintenance field, loans, and the locations with the most untapped tax.
Inputs: save, country.
eu5_environmentDetect EU5 setupA
Detect OS (EU5 is Windows-native; Linux via Proton, macOS via CrossOver/Whisky), save folders, game install + version, language and rakaly availability.
Inputs: no named parameters.
eu5_find_problemsCampaign health checkB
Find problems and opportunities (deficit, negative gold, loans, stability, prestige, manpower, low control, untapped tax, market access, occupation, multi-front wars) with advice.
Inputs: save, country.
eu5_list_savesList EU5 savesB
List .eu5 saves newest first with in-game date, country, version and format (text/binary).
Inputs: dir, limit.
eu5_load_saveLoad an EU5 saveB
Parse a save (plaintext natively, binary via rakaly) and return a campaign summary with the player's snapshot.
Inputs: full, save.
eu5_locationsLocations reportC
Owned locations with development, control, prosperity, tax vs possible tax, market access, raw material, settlement rank, religion and occupation; plus averages and counts.
Inputs: save, sort, limit, country.
eu5_queryRaw save lookupA
Read any field by dotted path, e.g. 'metadata', 'countries.tags', 'war_manager.database.5'. Empty path lists top-level sections.
Inputs: path, save, depth.
eu5_rankingsWorld rankingsC
Rank countries by a metric and show the player's position.
Inputs: save, limit, metric.
eu5_searchSearch save keysC
Find keys (and optionally values) matching a regex, optionally under a path.
Inputs: pattern (required), save, limit, under, +1 more.
eu5_warsWarsB
Wars in the save (or involving a country): start date, sides, war score where present, battles.
Inputs: save, country.
eu5_wiki_pageRead an EU5 wiki pageC
Fetch an EU5 wiki page as plain text (truncated).
Inputs: title (required), maxChars.
eu5_wiki_searchSearch the EU5 wikiB
Search the official Europa Universalis V wiki (eu5.paradoxwikis.com) for mechanics, buildings, laws, etc.
Inputs: query (required), limit.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
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.
Maintenance
Related MCP Connectors
Savecraft serves real save game data and expert game knowledge to AI assistants.
Chess MCP for Claude: engine analysis, attack maps, game review. One URL, no install.
Ask Claude, ChatGPT, or any MCP client about your game's players, retention, revenue, and win rates.
Swiss encrypted cloud drive for Claude, ChatGPT and AI agents: search, read and save files.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables Claude to access real-time Civilization VI game data for strategic analysis, diplomatic intelligence, military assessments, and more via MCP.216MIT
- AlicenseAqualityBmaintenanceEnables Claude to read Crusader Kings III save files and retrieve strategic game information such as realm overview, military, succession, diplomacy, vassals, factions, and expansion options.14114MIT
- FlicenseCqualityCmaintenanceEnables AI agents to read local Victoria 3 save files, list saves, and analyze country, economy, politics, diplomacy, military, and technology data, while generating construction, law, and diplomatic advice.19-
- AlicenseNot gradedqualityBmaintenanceLets users interrogate an Europa Universalis V save with an AI assistant, returning real figures decoded from their own save, game files and wiki-verified rules for economy, locations, buildings, markets, diplomacy and strategy. It is read-only and reports unverifiable values as missing rather than guessing.AGPL 3.0