Factorio MCP

by OLDIN_

Read-only queries for an external MCP service.

Utilities
3 hours ago
2.1
8
Owner:
OLDIN_
Source:
https://github.com/OLDIN/factorio-mcp
Homepage:
N/A
License:
MIT
Created:
2 days ago
Latest Version:
0.3.0 (3 hours ago)
Factorio version:
2.1
Downloaded by:
8 users

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.