RimSage logo

RimSage

Search, browse, and inspect indexed RimWorld source code, Defs, files, and C# symbols through MCP.

Install RimSage

Pick your client, then add it in one click or paste the config.

Streamable HTTP (Remote)
Server URL
https://mcp.rimsage.com/mcp

Remote servers are added in the app, not the config file: Customize → Connectors → Add custom connector, then paste this URL.

Overview

RimSage MCP server gives AI agents structured access to RimWorld source code, Defs, files, directories, and C# symbols. It exposes six MCP tools for code search, file browsing, Def lookup, XML inspection, and symbol reading. Use the hosted Streamable HTTP endpoint for quick access, or run it locally over stdio after indexing local RimWorld and decompiled C# files. It fits mod development, source investigation, and Def-based troubleshooting workflows.

Use cases

  • Search RimWorld source code for an implementation
  • Inspect the C# definition of a type or method
  • Find RimWorld Defs by name or content
  • Compare raw and merged Def XML
  • Browse indexed files while developing a mod

Key features

  • RimWorld source-code search
  • File and directory browsing
  • RimWorld Def search
  • Raw and merged Def XML retrieval
  • C# type and method inspection
  • Hosted and self-hosted MCP access

Tools6

What RimSage lets your agent do. Expand a tool for its parameters.

Verified live~625 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked

Recent health check succeeded.

4/4 checks healthy over the last 6d

What it can do

From the 6 tools this server returned when we ran it.

Read-only tools · 6

Observed 2026-11-12 in an isolated sandbox. A description of reach, not a security audit.

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars100Stargazers on the source repository.
Last commit6d agoMost recent push to the default branch.
Tools exposed6Callable tools this server registers over MCP.

How RimSage works

What RimSage does

Its tools cover both text-oriented code exploration and RimWorld-specific data inspection:

  • search_source searches indexed RimWorld source code.
  • read_file returns the contents of a selected file.
  • list_directory inspects available directory entries.
  • search_defs searches RimWorld Defs.
  • get_def_details retrieves raw or merged Def XML.
  • read_csharp_symbol reads the definition of a C# type or method.

This combination lets an agent move from a broad source search to a particular file, symbol, or Def without relying only on plain-text grep results.

How it works

The project can be used through the hosted MCP endpoint at https://mcp.rimsage.com/mcp, which provides a ready-to-use service for supported MCP clients. For local use, RimSage runs with stdio transport. It also includes a Streamable HTTP development mode.

A self-hosted installation builds indexes from two local inputs: a RimWorld installation or root directory for Def data, and a decompiled C# source project. The indexed data is then queried by the MCP tools. Local deployment therefore requires access to the relevant RimWorld files and decompiled source before an agent can search them.

Setup and configuration

The self-hosted workflow requires Bun and ripgrep. After cloning the repository, install its package dependencies with Bun, import the Defs and C# source, and build the project:

sh
bun install
bun run src/scripts/import-defs /path/to/your/rimworld/root/path
bun run src/scripts/import-csharp /path/to/decompiled/source/root/path
bun run build

Run the local stdio server with:

sh
bun run start

The repository also provides a Streamable HTTP start command:

sh
bun run start:http

An MCP client can launch the stdio server with a configuration similar to this:

config.json
{
  "mcpServers": {
    "rimsage": {
      "command": "bun",
      "args": ["run", "/path/to/this/repo"]
    }
  }
}

Replace the repository path with the location of the local checkout. Client-specific connection instructions are available through the project's integration wiki.

Tools and capabilities

The source-search tools support code navigation at several levels. Agents can search indexed source, inspect directory structure, open individual files, and read C# type or method definitions. RimSage also treats RimWorld Defs as a separate searchable data set, with support for finding matching Defs and retrieving either their raw or merged XML representation.

These capabilities are useful when investigating how a game system is implemented, locating the code behind a Def, checking inherited or merged Def values, or examining a specific C# symbol during mod development.

Limitations and notes

Local deployment depends on a prepared index and does not operate from only the repository checkout. You need local RimWorld files and a decompiled C# project to populate the index. The project states that using those materials is allowed under the RimWorld EULA; users remain responsible for following the applicable license terms.

The hosted endpoint avoids the local indexing workflow, while the self-hosted option keeps the source inputs and server process in the local environment. Bun and ripgrep are required for the documented self-hosted setup.

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about RimSage

RimSage is an MCP server that connects AI agents to indexed RimWorld source code and Def data, with tools for source search, file and directory browsing, Def lookup, raw or merged Def XML retrieval, and C# symbol reading. It supports an online MCP endpoint and local stdio deployment.

Install Bun and ripgrep, clone the repository, run `bun install`, import your RimWorld and decompiled C# paths, and build with `bun run build`. Start the local stdio service with `bun run start`, then add its Bun command and repository path to your MCP client configuration.

Yes. Connect an MCP client to `https://mcp.rimsage.com/mcp` to use the hosted service without performing the local indexing steps.

Self-hosting needs local RimWorld files and a decompiled C# project. Use the import scripts to index the RimWorld root for Defs and the decompiled source root for C# code before building the server.

Yes. The project provides Streamable HTTP support through `bun run start:http`, in addition to its local stdio mode.

Related MCP servers

Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewRimSage AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/rimsage?style=directory)](https://allmcps.com/mcp/rimsage)
HTML Embed
<a href="https://allmcps.com/mcp/rimsage"><img src="https://allmcps.com/api/badge/rimsage?style=directory" alt="RimSage on AllMCPs" /></a>