gitwtfhub

wtf is cities-skylines-2-mcp?

lancercomet/cities-skylines-2-mcp — explained in plain English

Analysis updated 2026-05-18

8C#Audience · developerComplexity · 4/5Setup · hard

TL;DR

An MCP server that lets Claude or another AI assistant read and control a running Cities Skylines II game, including building roads, zoning, budgets, and simulation time.

Mindmap

mindmap
  root((CS2MCP))
    What it does
      Observe city data
      Build roads and buildings
      Paint zones
      Manage finances
      Control simulation time
    Architecture
      In-game C# mod
      MCP server in Node.js
      Local HTTP bridge
    Tech Stack
      C#
      TypeScript
      Node.js
      MCP protocol
    Audience
      Gamers
      Modders
      AI experimenters

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Let an AI assistant play or manage a Cities Skylines II city on your behalf.

REASON 2

Ask Claude to build roads, zone areas, or adjust budgets and policies in a live game.

REASON 3

Watch an AI observe city statistics and screenshots, then act based on what it sees.

REASON 4

Automate repetitive city management tasks like tax and service budget tuning.

What's in the stack?

C#TypeScriptNode.jsMCP.NET

How it stacks up

lancercomet/cities-skylines-2-mcpautofac/autofac.extras.fakeiteasyjihadkhawaja/mem0sharp
Stars888
LanguageC#C#C#
Last pushed2026-07-09
MaintenanceActive
Setup difficultyhardeasymoderate
Complexity4/52/53/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · hard Time to first run · 1h+

Requires Windows, the game itself.NET SDK 8+ to build the mod, and Node.js 18+ for the MCP server.

The README does not state a license in the shown portion.

Wtf does this do

CS2MCP is an MCP server that lets Claude, or any other MCP compatible AI client, control a running copy of the city building game Cities Skylines II. MCP is a protocol that lets AI assistants call tools, and this project exposes 44 of them, letting an AI observe the city, build roads and buildings, paint residential, commercial, or industrial zones, adjust taxes and budgets, and control the pace of the simulation, including pausing it or running it forward by a set number of in game hours. The system has two parts. A mod written in C# runs inside the game itself and starts a small local web server that only accepts connections from the same machine. It reads and changes the game's data on the simulation's own main thread, and it builds or demolishes things using the game's normal construction and bulldozer systems rather than editing data directly, so changes stay valid within the game's rules. A separate MCP server, written in TypeScript and run with Node.js, translates tool calls from Claude into requests sent to that in game web server. To use it you need Windows, Cities Skylines II from Steam, the .NET SDK version 8 or newer to build the mod, and Node.js 18 or newer to run the MCP server. Building the mod copies it into the game's mods folder automatically, and it loads the next time the game starts. The MCP server can then be registered with Claude Code or Claude Desktop by pointing at its built file. Once connected, and with a save loaded in the game, you can ask Claude things like how a city's finances look, to zone a residential area near a river, or to build a road connecting an industrial district to the highway, and it will read the current state and make the change through the same tools a player would use. Screenshots can be taken so the AI can see the current view alongside the raw data. The README notes some current limits: buying new map tiles, planning transit lines, and reshaping terrain are not supported yet and are planned for a future version, and roads can only connect at existing segment endpoints rather than merging smoothly in the middle of a road.

Yoink these prompts

Prompt 1
Help me build the CS2MCP.Bridge mod and the mcp-server, then register the cs2 MCP server with Claude Code.
Prompt 2
Ask Claude to check my city's finances and RCI demand using the CS2MCP tools.
Prompt 3
Have Claude zone a residential area next to the river and then build a connecting road using CS2MCP.
Prompt 4
Use CS2MCP to take a screenshot of my city, then have Claude suggest where to place new industrial zoning.

Frequently asked questions

wtf is cities-skylines-2-mcp?

An MCP server that lets Claude or another AI assistant read and control a running Cities Skylines II game, including building roads, zoning, budgets, and simulation time.

What language is cities-skylines-2-mcp written in?

Mainly C#. The stack also includes C#, TypeScript, Node.js.

What license does cities-skylines-2-mcp use?

The README does not state a license in the shown portion.

How hard is cities-skylines-2-mcp to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is cities-skylines-2-mcp for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.