Factorio MCP
Ask an AI assistant about your own running game and get answers from live data:
"why is my plant not working?", "what makes plastic bar here, and in which machine?",
"which mining drills are about to run dry?".
This mod does nothing visible in game. It has no GUI, no items, no recipes, no changes to
gameplay. It exposes one read-only server console command that an external service uses.
You need the companion service
The mod alone does nothing. It works together with a small open-source service (Python, Docker)
that connects to your server over RCON and speaks the Model Context Protocol (MCP), so assistants
like Claude Code and Claude Desktop can use it. Setup guide, security notes and the service are on
GitHub: https://github.com/OLDIN/factorio-mcp
What it can answer
- Server state: mods and versions, difficulty and map settings, who is online and where
- The game's own reference data for your mod set (recipes, machines, items, fluids, modules,
quality, technologies, planets), including modded planets - Machine diagnostics around a point or a player, or over the whole base: what works, what stands
and why, what is stuck in inputs and outputs, drills running out of ore
Safe by design
- Read-only. The mod never changes the world, never writes files and never sends anything
over the network. There is no command for arbitrary Lua, items, speed or saves. - Server/RCON only. Players cannot run its command.
- Idle means idle. Nothing runs in the background. Big queries (the whole base) are split
over many game ticks, so players do not feel them. - Inventories of players, vehicles and chat are never read.
Install
Install it on the server like any other mod; clients sync it when they join. Then set up the
service from the GitHub page. Multiplayer-safe (it only reads), Factorio 2.1 and Space Age
supported, works with any mod set.
Settings (map, runtime)
- MCP job: chunks per tick - how many map chunks a large query scans per tick while players
are online (default 8, about 0.3 ms per tick on a big base). - MCP job: chunks per poll when nobody is online - batch size when no one can notice.