SatisfactoryMCP

Ask Claude about your Satisfactory world — and get answers read straight from your own
save files. This is an MCP server plus a local web map: the server plans factories with a real
optimizer over the game's own recipe data and your actual progress, and the map renders your
world in the browser — terrain, factories, belts and pipes, power wiring, floors, crates.
Everything runs locally: your saves, the recipe data and the map artwork are all read off
this machine, and nothing about your world is sent anywhere.

One platform up close — machines, storage, belts, pipes, wires	Floor view — pick a storey, see what stands on it
Terrain mode — hillshade from a 1 m heightfield read out of the game	A crate's contents, with icons extracted from the game's assets

What you can ask

Phrased however you like — the model picks the tools:

• "Plan a factory for 20 Modular Frames per minute using only recipes I've actually unlocked —
  what do I build, and how much power will it draw?"
• "Which of my pending hard drives should I bank first, and why?"
• "How healthy is my steel factory right now? Anything idle or starved?"
• "Where am I standing, and what's the best spot near me for an aluminium setup?"
• "What's still missing for Phase 3, and which factory is the bottleneck?"
• "Trace my Reinforced Iron Plates upstream and tell me where the chain is thinnest."
• "Compare the alternate recipes for Computers against what I'm running today."
• "How much Quartz do I actually have, and which container is it in?"
• "What was in the crate where I died?"
• "Show the coal powerplant on the map." — answers with a link that opens the local web map
  above, zoomed to it. A satisfactory-calculator.com link comes second, for the vanilla world
  it knows; only the local one can draw what you built.

Plans balance every item honestly — a setup that would silently strand Heavy Oil Residue is
reported infeasible instead of overstated — and every answer names the save file it read and
how old it is. The server only ever reads your saves; it never writes them.

Plus MCP resources (satisfactory://docs/summary, satisfactory://save/current,
satisfactory://map/regions) and three prompts that surface as slash commands:
design_factory, plan_power_plant, pick_hard_drive. The full surface, argument by
argument, is in docs/mcp-surface.md.

Getting started

You need:

• Python ≥ 3.11 and uv
• A local Satisfactory installation (Steam or Epic) — recipes and rates are read from the
  game's own data dump, so numbers stay correct when the game patches
• Node.js — only to build the web map once; not needed for the MCP server alone
• Windows is what it's developed and tested on; save and install auto-detection assume
  Windows paths, and both can be pointed elsewhere via environment variables (below)

git clone https://github.com/lukszi/SatisfactoryMCP.git
cd SatisfactoryMCP
uv sync

Connect it to Claude

The MCP entry point is satisfactory-mcp (stdio). With Claude Code, register it at user scope
so it loads in any directory — you'll usually be asking about the game, not about this code:

claude mcp add --scope user satisfactory -- uv run --directory "/path/to/SatisfactoryMCP" satisfactory-mcp

For any other MCP client, the equivalent JSON configuration:

{
  "mcpServers": {
    "satisfactory": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/SatisfactoryMCP", "satisfactory-mcp"]
    }
  }
}

The web map

Build the page once, then start the server:

cd src/satisfactory_mcp/interfaces/web/frontend
npm ci && npm run build
cd -
uv sync --extra web
uv run satisfactory-mcp-web

The map is at http://127.0.0.1:8712, and it follows your saves live as you play. It binds to
localhost on purpose: the API answers with the contents of your save directory and has no
authentication, so it is a local tool.

Where your saves come from

Both locations are auto-detected:

• Saves: %LOCALAPPDATA%\FactoryGame\Saved\SaveGames — the game's own location. Override
  with SATISFACTORY_SAVES.
• Game data: CommunityResources/Docs/en-US.json under common Steam and Epic install
  paths. Override with SATISFACTORY_DOCS (pointing at the en-US.json file itself).

Saves are grouped into worlds; within a world the newest save is used by default, and every
answer says which file it read.

Licence

PolyForm Noncommercial 1.0.0. Free to use, modify and share for any
noncommercial purpose, provided the required notice travels with copies:

Required Notice: Copyright Lukas Szimtenings (https://github.com/lukszi/SatisfactoryMCP)

Commercial use requires a separate licence from the owner — get in touch via GitHub
(@lukszi). The licence covers this repository's code, tooling and
extracted tables; it cannot and does not grant anyone rights over the game's content. All
game-derived data describes Coffee Stain Studios' content — Coffee Stain retains all rights to
Satisfactory and its assets, and this project is not affiliated with or endorsed by them.

The web map compiles Leaflet (BSD-2-Clause) into its bundle at build
time from the npm package; the bundle is not committed, and every build carries Leaflet's
licence text beside it.

Developing: the code layout, test suite, data generators, and the full data-provenance record
live in docs/DEVELOPING.md. DESIGN.md is the design spine.