# AgentRaaS wrap

> AgentRaaS wrap is an open-source MCP server for developer tools. Wraps any MCP server so repeated write calls run once and every call is logged. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, API
- **Website:** https://agentraas.io
- **Repository:** https://github.com/agentraas/agentraas/tree/HEAD/src/sdk
- **MCP Registry name:** io.github.agentraas/agentraas
- **Categories:** developer tools, security
- **Listing updated:** 2026-11-14

## About

Put this in front of another MCP server and an identical call to one of its write tools inside a 10-minute window returns the first result instead of running again. That stops a looping agent from opening the same issue or sending the same email twice. Read-only tools always run, and every tool call lands in a local audit log. In a client config you replace the command with uvx agentraas wrap -- followed by the original server command.

It belongs to the wider AgentRaaS project, a self-hosted reliability layer that can also add policies, spend caps, Slack approval for risky calls and a Postgres audit trail when you run its server. The Python package adds an @exactly_once decorator backed by SQLite or Redis, protect_tool for LangChain and CrewAI, agentraas scan to list tools that can move money, delete data, run code or message people without calling them, and agentraas-chaos to find calls that double up under retries.

The website says about 2 ms is added per call. It is open source and free to self-host.

## Features

- **Exactly-once writes:** Identical write calls within a 10-minute window return the first result.
- **Local audit log:** Every tool call through the wrapper is recorded.
- **Safety scan:** agentraas scan lists risky tools in your MCP config without calling them.
- **Chaos tester:** agentraas-chaos finds calls that would duplicate under retries and exits non-zero for CI.
- **Library decorators:** @exactly_once and protect_tool cover plain functions, LangChain and CrewAI.
- **Optional server:** Adds approvals, spend caps, circuit breaking and a dashboard when you want them.

## Good for

- Stop an agent loop from creating duplicate GitHub issues
- Audit every tool call an agent makes
- Find which MCP tools can move money or delete data
- Prevent double charges when a workflow retries

## Install

### Claude Code (Terminal)

```sh
claude mcp add agentraas -- uvx agentraas
```

### Claude Desktop (claude_desktop_config.json)

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

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

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

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

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

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

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

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

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

## FAQ

### How do I install it?

pip install agentraas, then wrap an MCP server with agentraas wrap in your client config.

### Do read tools get cached?

No. Read-only tools always run.

### Does it need a server or account?

No. The wrapper, scan and chaos tools work locally; the server is optional.

### What state store does it use?

SQLite by default or your own Redis.

### Is AgentRaaS wrap free?

Yes. AgentRaaS wrap is open source, so you can use and self-host it for free.

### How do I add AgentRaaS wrap to Claude Code?

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

### What are the best alternatives to AgentRaaS wrap?

The closest alternatives to AgentRaaS wrap are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/agentraas-wrap
