Skip to main content
Glama

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

%USERPROFILE%\Documents\Paradox Interactive\Europa Universalis V\save games (+ OneDrive\Documents)

Linux (Steam Proton)

<Steam library>/steamapps/compatdata/3450310/pfx/drive_c/users/steamuser/Documents/Paradox Interactive/Europa Universalis V/save games

macOS via CrossOver / Whisky

drive_c/users/<user>/Documents/Paradox Interactive/Europa Universalis V/save games inside every bottle

Steam Cloud copy

<Steam>/userdata/<id>/3450310/remote/save games

Cloud streaming / VM

copy the .eu5 file to your computer and pass its path, or set EU5_SAVE_DIR

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 -debug_mode (Steam → Properties → Launch Options). Note: debug mode disables achievements.

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

eu5_environment

OS, platform notes, save folders, game install/version, language, rakaly status

eu5_list_saves

Saves newest first with date, country, version, format

eu5_load_save

Campaign summary + player snapshot

eu5_country_overview

Gold, manpower, stability, prestige, traditions, income/expense, tax & trade, great-power rank, territory, rulers, wars — plus every other scalar field of your country

eu5_economy

All economic fields, loans, and the locations with the most untapped tax

eu5_locations

Development, control, prosperity, tax vs possible tax, market access, raw materials, ranks, occupation

eu5_diplomacy

Overlord, subjects with liberty desire, your diplomacy record, wars

eu5_wars

Wars with sides and battles

eu5_find_problems

Health check: deficit, debt, stability, prestige, manpower, control, untapped tax, market access, occupation, multi-front wars

eu5_rankings

Great-power rank, gold, income, manpower, prestige, stability, locations, score, tax base

eu5_compare_saves

Your progress between two saves

eu5_country_raw / eu5_query / eu5_search

Raw access to any part of the save — EU5's schema changes between patches, so nothing is out of reach

eu5_wiki_search / eu5_wiki_page

The official EU5 wiki for rules and mechanics

There is also a campaign_review prompt.

Install

Claude Desktop (one click)

  1. Download eu5-save-mcp.mcpb from the latest release.

  2. Double-click it (or drag it into Claude Desktop → Settings → Extensions) and press Install.

  3. Optional: set your save folder and the path to rakaly.

Claude Code

claude mcp add eu5 -- npx -y github:adnan-kutay-yuksel/eu5-save-mcp

Any 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.mcpb

License

MIT. Not affiliated with or endorsed by Paradox Interactive. Europa Universalis is a trademark of Paradox Interactive AB.

Available Tools

16 tools
eu5_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_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.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.2/5.0

    Scored across 16 tools

    Disambiguation4/5

    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.

    Naming Consistency4/5

    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).

    Tool Count4/5

    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.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Enables Claude to access real-time Civilization VI game data for strategic analysis, diplomatic intelligence, military assessments, and more via MCP.
      21
      6
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables 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.
      14
      11
      4
      MIT
    • F
      license
      C
      quality
      C
      maintenance
      Enables 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
      -
    • A
      license
      Not graded
      quality
      B
      maintenance
      Lets 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