Skip to main content
Glama

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 tools
analyze_projectB
Read-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_entryB
Read-onlyIdempotent

Return one local Cities: Skylines II in-game encyclopedia entry by entry_id.

Inputs: entry_id (required).

get_pageA
Read-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_snippetsB
Read-onlyIdempotent

Retrieve Cities: Skylines II modding code snippets extracted from the bundled wiki corpus.

Inputs: query (required), limit.

list_project_treeB
Read-onlyIdempotent

List files in a configured Cities: Skylines II mod project workspace.

Inputs: project_dir (required), glob, max_files, include_hidden.

package_projectC
Destructive

Create a zip package for a Cities: Skylines II mod project.

Inputs: project_dir (required), output_dir, package_name, exclude_globs.

query_referenceA
Read-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.

search_encyclopediaB
Read-onlyIdempotent

Search the local Cities: Skylines II in-game encyclopedia read from the user's installed game files.

Inputs: query (required), limit.

source_statusA
Read-onlyIdempotent

Report Cities2-MCP source availability for the wiki corpus, bundled research datasets, and local game encyclopedia.

Inputs: no named parameters.

write_project_fileC
Destructive

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

    B3.4/5.0

    Scored across 13 tools

    Disambiguation5/5

    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.

    Naming Consistency4/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      A 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 npm
      1
      ISC
    • A
      license
      Not graded
      quality
      C
      maintenance
      Provides 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 npm
      3
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP 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