cities2-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@cities2-mcp how do I increase land value?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Cities2 MCP and Modding Toolkit
Cities2 MCP and Modding Toolkit is a local MCP server and agent skill bundle for Cities: Skylines II gameplay questions, patch notes, and mod project workflows.
It gives AI agents access to a bundled, searchable Cities: Skylines II Wiki corpus, separately attributed curated research reports, and, when the game is installed locally, the in-game encyclopedia. Agents can use those sources to answer gameplay questions, summarize patch/update information, and explain city systems with source notes. The package also includes five agent skills for game knowledge, modding, review, debugging, and release readiness, plus local MCP workflow tools for scaffolding, inspecting, building, and packaging CS2 mod projects inside trusted workspaces.
The plugin is in active development. Package checks, direct MCP smoke tests, and selected client workflows are covered in the repository test suite and eval reports, but client plugin behavior can vary by host and version. See the known issues and eval reports for the latest verification notes.
Quick install
Choose your client: Claude Code | Claude desktop | Codex CLI | Codex app | Google Antigravity
See INSTALL.md for full installation details, direct MCP config, workspace setup, build prerequisites, and troubleshooting.
Related MCP server: nexus-mcp
What it can do
Search game and modding information
The MCP server includes a prepared text corpus from the Cities: Skylines II Wiki. An AI assistant can:
search the wiki
retrieve full pages, page-level references, and code-oriented snippets for game systems, patch notes, and modding topics
answer questions about game mechanics, recent updates, and how city systems affect your save
Search curated research
The MCP server also bundles curated Cities: Skylines II research reports. These reports are historically situated, separately attributed, and generated from committed research notes rather than raw transcripts. Results retain publication and source context so an assistant can distinguish time-bounded findings from current game behavior and APIs.
Search the local game encyclopedia
When Cities: Skylines II is installed locally, the MCP server reads the game encyclopedia from the installed game files. This source is enabled by default when the server can find Cities2_Data/Content/Game/Locale.cok.
The extracted encyclopedia index is cached locally on the user's machine and rebuilt only when the source game file, detected Steam build id, locale, or extractor version changes. Extracted game text is not committed to this repository, shipped in releases, or part of the redistributed wiki corpus.
Help with mod project workflows
The server also includes local workflow tools for CS2 mod projects. An AI assistant can:
scaffold C# code, UI, or hybrid mod project templates
write files inside configured workspaces
list project trees
run project builds and analyzers
package project output
These tools are meant for local development workflows. Claude, Codex, and Antigravity can use them to write and run trusted workspace code during builds, so configure workspaces deliberately and use manual playtesting before treating any mod as ready to share.
Agent skills
cities2-knowledge: answers gameplay, city-system, and player-facing patch/update questions.cities2-modding: handles general modding questions and local mod project workflows.cities2-mod-review: reviews CS2 mods for safety, maintainability, user value, packaging hygiene, and verification gaps.cities2-mod-debugging: helps debug CS2 mod build, packaging, runtime, log, UI debugger, and in-game behavior issues.cities2-mod-release: checks whether a mod is ready to share.
The modding quality skills use documented CS2 best practices and negative constraints as defaults, and they do not present a mod as ready to share until it has been locally playtested.
Privacy
The MCP server runs locally and does not collect telemetry. See PRIVACY.md for details.
Licensing
The MCP server code is licensed under the MIT License. The included wiki corpus is licensed under Creative Commons Attribution-ShareAlike 3.0; its source attribution and transformation notes are in the wiki corpus attribution. The curated research corpus is separately attributed, and its original report prose follows the repository license; see the research corpus attribution.
This project is not developed by, endorsed by, reviewed by, or approved by Paradox Interactive, Iceflake Studios, Colossal Order, Paradox Wikis, or any related company. Cities: Skylines II and related names are used referentially.
Available Tools
13 toolsanalyze_projectBRead-onlyIdempotent
Run static checks for Cities: Skylines II mod project structure and lifecycle patterns.
Inputs: project_dir (required), strict, profile.
build_projectC
Build a Cities: Skylines II mod project and return normalized diagnostics. This executes trusted workspace code; do not use it for arbitrary untrusted repositories.
Inputs: project_dir (required), clean, steps, package, +2 more.
get_encyclopedia_entryBRead-onlyIdempotent
Return one local Cities: Skylines II in-game encyclopedia entry by entry_id.
Inputs: entry_id (required).
get_pageARead-onlyIdempotent
Return a full page from the bundled Cities: Skylines II Wiki corpus or research datasets by page_id. Results include dataset labels. Research evidence is time-bounded; check publication dates for current details.
Inputs: page_id (required).
get_snippetsBRead-onlyIdempotent
Retrieve Cities: Skylines II modding code snippets extracted from the bundled wiki corpus.
Inputs: query (required), limit.
list_project_treeBRead-onlyIdempotent
List files in a configured Cities: Skylines II mod project workspace.
Inputs: project_dir (required), glob, max_files, include_hidden.
package_projectCDestructive
Create a zip package for a Cities: Skylines II mod project.
Inputs: project_dir (required), output_dir, package_name, exclude_globs.
query_referenceARead-onlyIdempotent
Search page-level Cities: Skylines II Wiki corpus and research dataset references: titles, sections, URLs, and links. Results include dataset labels. Research evidence is time-bounded; check publication dates for current details.
Inputs: query (required), limit.
scaffold_projectC
Scaffold a Cities: Skylines II mod project from a template.
Inputs: name (required), template (required), options, metadata, +1 more.
searchBRead-onlyIdempotent
Search the bundled Cities: Skylines II Wiki corpus and research datasets for gameplay, systems, and modding information. Results include dataset labels. Research evidence is time-bounded; check publication dates for current details.
Inputs: query (required), limit.
search_encyclopediaBRead-onlyIdempotent
Search the local Cities: Skylines II in-game encyclopedia read from the user's installed game files.
Inputs: query (required), limit.
source_statusARead-onlyIdempotent
Report Cities2-MCP source availability for the wiki corpus, bundled research datasets, and local game encyclopedia.
Inputs: no named parameters.
write_project_fileCDestructive
Write files inside a configured Cities: Skylines II mod project workspace.
Inputs: content (required), project_dir (required), relative_path (required), mode.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 13 tools
Each tool has a clearly distinct purpose: encyclopedia entries, wiki/reference search, mod project scaffolding and management, and status reporting. No two tools appear to overlap in functionality.
Almost all tools follow a verb_noun pattern in snake_case (e.g., get_encyclopedia_entry, scaffold_project). Minor deviations include 'source_status' and 'search', but they are still clear and consistent with the overall style.
With 13 tools, the set is well-scoped for a modding assistant covering reference lookup, code search, project scaffolding, build, and analysis. Each tool serves a clear purpose without bloat.
The toolset covers the key aspects of mod development: reference retrieval, scaffolding, file management, building, analysis, and packaging. A minor gap is the absence of a tool to delete or clean up project files, but core workflows are complete.
Maintenance
Related MCP Connectors
Official Duck Framework MCP server for AI-assisted development and project scaffolding.
An MCP server that gives your AI access to the source code and docs of all public github repos
Driflyte MCP server which lets AI assistants query topic-specific knowledge from web and GitHub.
Related MCP Servers
- AlicenseBqualityDmaintenanceProvides comprehensive access to MCP documentation through structured guides, full-text search, and interactive development workflows for building servers and clients.347 npmMIT
- AlicenseNot gradedqualityCmaintenanceA local MCP server for Nexus Mods mod discovery and research, backed by the v2 GraphQL API, enabling search of games, mods, collections, and users.61 npm1ISC
- AlicenseNot gradedqualityCmaintenanceProvides a local MCP server for searching and retrieving documentation from 22+ open-source projects, enabling AI coding assistants to access up-to-date docs without network dependency.5 npm3MIT
- AlicenseNot gradedqualityDmaintenanceMCP server that provides tools to add to, search, and manage a wiki knowledge base, enabling AI chat tools to contribute and retrieve information from the wiki via natural language prompts.MIT