Skip to content
MCP server

RSOS State Runtime

Shared-state runtime for multi-agent workflows that cuts model calls and heals drift

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, API, self-hosted
Runs
Locally
Version
0.3.0
Listing updated
today

About RSOS State Runtime

RSOS State Runtime is an open-source MCP server for agent tooling. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

claude mcp add rsos -- uvx rsoslang

Add to claude_desktop_config.json

{
  "mcpServers": {
    "rsos": {
      "command": "uvx",
      "args": [
        "rsoslang"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "rsos": {
      "command": "uvx",
      "args": [
        "rsoslang"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

What it does

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

Pricing

Open source

Apache 2.0 open-source software installed locally; no paid plan mentioned.

Prices change. Check r-a-elu-architecture.github.io before you buy.

RSOS State Runtime 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.

How AIPoweredBot checks servers

Alternatives to RSOS State Runtime

  1. Read-only MCP server to search and read free items from the BotShelf Vampire shelf

    Not checked yet
    • 3 tools
    • Remote
    • Open source
    • Agent tooling
  2. Deterministic verdict on an agent context-pack manifest, per API call

    Not checked yet
    • Remote
    • Agent tooling
  3. Per-call zero trust evaluation verdict for agents and developers, served over MCP and API

    Not checked yet
    • Remote
    • AI models and LLM tooling
  4. Pay-per-call MCP service that audits zero knowledge claims and returns a deterministic

    Not checked yet
    • Remote
    • Security
  5. Pay-per-call MCP service that audits declared network exposure evidence and returns

    Not checked yet
    • Remote
    • Paid
    • Security