Skip to content
Back to search

eu5-save-mcp

MCP server: chat with your Europa Universalis V save files in Claude (Windows, Linux/Proton, macOS via CrossOver)

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/adnan-kutay-yuksel--eu5-save-mcp/badge.svg)](/listings/adnan-kutay-yuksel--eu5-save-mcp)

HTML

<a href="/listings/adnan-kutay-yuksel--eu5-save-mcp"><img src="/api/listings/adnan-kutay-yuksel--eu5-save-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Claude Desktop (one click)

1. Download `eu5-save-mcp.mcpb` from the [latest release](https://github.com/adnan-kutay-yuksel/eu5-save-mcp/releases/latest). 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`).

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 111 lines
  1. # EU5 Save Advisor — MCP server for Europa Universalis V
  2. Chat with your **Europa Universalis V** campaign. This [Model Context Protocol](https://modelcontextprotocol.io) server lets Claude (Claude Desktop, Claude Code, or any MCP client) read your save files and answer questions with real numbers from your game:
  3. > *"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?"*
  4. It is **read-only**, runs locally, and adapts to your platform and game version.
  5. ## Platform support
  6. EU5 is a Windows game. The server knows where saves end up on every setup:
  7. | Setup | Save folder searched automatically |
  8. | --- | --- |
  9. | Windows | `%USERPROFILE%\Documents\Paradox Interactive\Europa Universalis V\save games` (+ OneDrive\Documents) |
  10. | Linux (Steam Proton) | `<Steam library>/steamapps/compatdata/3450310/pfx/drive_c/users/steamuser/Documents/Paradox Interactive/Europa Universalis V/save games` |
  11. | macOS via CrossOver / Whisky | `drive_c/users/<user>/Documents/Paradox Interactive/Europa Universalis V/save games` inside every bottle |
  12. | Steam Cloud copy | `<Steam>/userdata/<id>/3450310/remote/save games` |
  13. | Cloud streaming / VM | copy the `.eu5` file to your computer and pass its path, or set `EU5_SAVE_DIR` |
  14. Run `eu5_environment` to see exactly what was detected (OS, folders, game install + version, language, rakaly).
  15. ## Save formats
  16. | Save type | How it is read |
  17. | --- | --- |
  18. | **Debug-mode saves** (plaintext) | ✅ built in — start EU5 with the launch option `-debug_mode` (Steam → Properties → Launch Options). Note: debug mode disables achievements. |
  19. | Normal & ironman saves (binary, zipped) | ✅ via the free [rakaly CLI](https://github.com/rakaly/cli/releases), version 0.8.25 or newer (tested) |
  20. Paradox's binary format uses a token table that is not public; [rakaly](https://github.com/rakaly) (the engine behind [pdx.tools](https://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 can't read a brand-new EU5 patch yet, you'll get a clear message; update rakaly or use a debug-mode save. Binary saves show their date and country once loaded (listing only reads plaintext headers).
  21. ## Tested with real saves
  22. Every release is checked against 7 real saves from the public [pdx.tools](https://pdx.tools) test corpus: patches 1.0 to 1.4, debug (text), ironman, multiplayer (15 players) and observer games, up to 500 MB of decoded game state. A late-game save decodes and loads in about 2–13 s and uses 150 MB to 1 GB of memory. To run it yourself:
  23. ```bash
  24. REAL_SAVES_DIR=/path/to/saves RAKALY_PATH=/path/to/rakaly npm test
  25. ```
  26. ## Tools
  27. | Tool | What you get |
  28. | --- | --- |
  29. | `eu5_environment` | OS, platform notes, save folders, game install/version, language, rakaly status |
  30. | `eu5_list_saves` | Saves newest first with date, country, version, format |
  31. | `eu5_load_save` | Campaign summary + player snapshot |
  32. | `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 |
  33. | `eu5_economy` | All economic fields, loans, and the locations with the most untapped tax |
  34. | `eu5_locations` | Development, control, prosperity, tax vs possible tax, market access, raw materials, ranks, occupation |
  35. | `eu5_diplomacy` | Overlord, subjects with liberty desire, your diplomacy record, wars |
  36. | `eu5_wars` | Wars with sides and battles |
  37. | `eu5_find_problems` | Health check: deficit, debt, stability, prestige, manpower, control, untapped tax, market access, occupation, multi-front wars |
  38. | `eu5_rankings` | Great-power rank, gold, income, manpower, prestige, stability, locations, score, tax base |
  39. | `eu5_compare_saves` | Your progress between two saves |
  40. | `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 |
  41. | `eu5_wiki_search` / `eu5_wiki_page` | The official [EU5 wiki](https://eu5.paradoxwikis.com) for rules and mechanics |
  42. There is also a `campaign_review` prompt.
  43. ## Install
  44. ### Claude Desktop (one click)
  45. 1. Download `eu5-save-mcp.mcpb` from the [latest release](https://github.com/adnan-kutay-yuksel/eu5-save-mcp/releases/latest).
  46. 2. Double-click it (or drag it into Claude Desktop → Settings → Extensions) and press **Install**.
  47. 3. Optional: set your save folder and the path to `rakaly`.
  48. ### Claude Code
  49. ```bash
  50. claude mcp add eu5 -- npx -y github:adnan-kutay-yuksel/eu5-save-mcp
  51. ```
  52. ### Any MCP client
  53. ```json
  54. {
  55. "mcpServers": {
  56. "eu5": {
  57. "command": "npx",
  58. "args": ["-y", "github:adnan-kutay-yuksel/eu5-save-mcp"],
  59. "env": { "EU5_SAVE_DIR": "", "RAKALY_PATH": "" }
  60. }
  61. }
  62. }
  63. ```
  64. 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`).
  65. ## How it reads the save
  66. 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](https://github.com/rakaly/jomini); location names come from the save's own location list and, when the game is installed, from your localisation files.
  67. ## Development
  68. ```bash
  69. npm install
  70. npm run typecheck
  71. npm test # parser, analysis and stdio MCP integration tests
  72. npm run build # bundles to dist/index.js (committed so `npx github:` works)
  73. npm run pack # builds eu5-save-mcp.mcpb
  74. ```
  75. ## Related
  76. - [EU4 Save Advisor](https://github.com/adnan-kutay-yuksel/eu4-save-mcp)
  77. - [GTA 6 Guide MCP](https://github.com/adnan-kutay-yuksel/gta6-mcp)
  78. ## License
  79. MIT. Not affiliated with or endorsed by Paradox Interactive. Europa Universalis is a trademark of Paradox Interactive AB.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.