# RSOS State Runtime

> RSOS State Runtime is an open-source MCP server for agent tooling. Shared-state runtime for multi-agent workflows that cuts model calls and heals drift. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API, self-hosted
- **Website:** https://r-a-elu-architecture.github.io/RSOS-Language/
- **Repository:** https://github.com/r-a-elu-architecture/rsos-language
- **MCP Registry name:** io.github.r-a-elu-architecture/rsos
- **Categories:** agent tooling
- **Listing updated:** 2026-11-18

## About

The README describes RSOS as a spatial-symbolic language for communication between humans and AI, and the State Runtime is the part aimed at agent workflows. The model chooses which changes should happen, and the runtime applies them, checks each agent's copy of the shared state, and repairs drift from a stored record without calling a model again.

According to the project's own pre-registered tests on real LLM agents, a 14-step task took 2 model calls instead of 42, and injected drift was healed with zero model calls. The results page also lists failed predictions, which the project reports alongside its passes.

The package installs from PyPI as rsoslang and runs as a local stdio MCP server that Claude Code and other MCP clients can attach to. It is a research and development project and is not described as a medical device.

## Features

- **Hash-checked shared state:** Each agent's copy of the shared state is checked so drift between copies is detected.
- **Drift healing without model calls:** Changed parts are restored from a stored record, with no additional model call, according to the project's tests.
- **Key-based operations:** The model names the keys to change and the runtime computes the values, so a whole task can fit in one call.
- **Local MCP server:** Runs over stdio via the rsoslang package and can be added to Claude Code with a single command.
- **Reproducible experiments:** The repository includes a replay script and pre-registered experiments with seeds and result hashes.

## Good for

- Coordinating several LLM agents that edit one shared state document
- Reducing model call count and cost in multi-step agent workflows
- Detecting and repairing divergent agent copies of shared data
- Replaying measured agent plans to verify runtime behaviour
- Adding a shared-state layer to an MCP-based coding assistant

## Install

### Claude Code (Terminal)

```sh
claude mcp add rsos -- uvx rsoslang
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "rsos": {
      "command": "uvx",
      "args": [
        "rsoslang"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "rsos": {
      "command": "uvx",
      "args": [
        "rsoslang"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "rsos": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "rsoslang"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "rsos": {
      "command": "uvx",
      "args": [
        "rsoslang"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "rsos": {
      "command": "uvx",
      "args": [
        "rsoslang"
      ]
    }
  }
}
```

## FAQ

### How do I install it?

The README gives pip install rsoslang, or pip install -e . from a clone. For MCP, it can be added with claude mcp add rsos -- rsoslang mcp, or with uvx rsoslang mcp without a local install.

### What licence is it released under?

The README states the code is licensed under Apache 2.0.

### Does it require any API keys or environment variables?

The registry entry lists no environment variables. The README's general MCP configuration example sets RSOS_CUE_FRAMEWORK, which is used for session features.

### What were the measured results?

The project reports 2 model calls instead of 42 for a 14-step task, 32/32 correct tasks, and zero model calls for drift healing, with the comparison setup described in its own tests.

### Is RSOS State Runtime free?

Yes. RSOS State Runtime is open source, so you can use and self-host it for free.

### How do I add RSOS State Runtime to Claude Code?

Run this command in your terminal: claude mcp add rsos -- uvx rsoslang

### What are the best alternatives to RSOS State Runtime?

The closest alternatives to RSOS State Runtime are BotShelf Vampire, Agent interoperability design — Atom, Agent context packaging — Atom, Zero trust evaluation verdict — Atom and Zero knowledge claim audit — Atom.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [BotShelf Vampire](https://ai-powered.com/mcp/botshelf-vampire): BotShelf Vampire is an open-source MCP server for agent tooling.
- [Agent interoperability design — Atom](https://ai-powered.com/mcp/agent-interoperability-design-atom): Agent interoperability design — Atom is an MCP server for design and media.
- [Agent context packaging — Atom](https://ai-powered.com/mcp/agent-context-packaging-atom): Agent context packaging — Atom is an MCP server for agent tooling.
- [Zero trust evaluation verdict — Atom](https://ai-powered.com/mcp/zero-trust-evaluation-verdict-atom): Zero trust evaluation verdict — Atom is an MCP server for ai models and llm tooling.
- [Zero knowledge claim audit — Atom](https://ai-powered.com/mcp/zero-knowledge-claim-audit-atom): Zero knowledge claim audit — Atom is an MCP server for security.
- [Network exposure audit — Atom](https://ai-powered.com/mcp/network-exposure-audit-atom): Network exposure audit — Atom is a paid MCP server for security.
- [BotMarket](https://ai-powered.com/mcp/botmarket): BotMarket is a free MCP server for agent tooling.
- [WritersLogic agent-infra](https://ai-powered.com/mcp/writerslogic-agent-infra): WritersLogic agent-infra is a paid MCP server for agent tooling.

---
Source: https://ai-powered.com/mcp/rsos-state-runtime
