# MELRA

> MELRA is an open-source MCP server for developer tools. Local MCP runtime that checks, approves and records every agent tool call. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Website:** https://xagilab.com
- **Repository:** https://github.com/xagi-lab/melra
- **MCP Registry name:** io.github.XAGI-Lab/melra
- **Categories:** developer tools, security
- **Listing updated:** 2026-11-15

## About

MELRA sits between an agent and the tools it calls. Each call routed through it is checked against a local policy and then allowed, refused before anything runs, or held for a person's exact approval. A call counts as done only if the evidence it declared holds, and the outcome is stored as a redacted receipt linked by hash.

For each task, MELRA dispatches a mutation at most once. If the outcome is uncertain it parks the call for reconciliation instead of replaying it, and the README notes that exactly-once effects still depend on the provider. Calls made through other tools are outside its control. The project is labelled alpha, so APIs may change before 1.0, and the authors advise an isolated workspace with narrow domain and command allowlists.

Setup is one command, npx @melra/cli@alpha setup, which writes a local policy, detects installed agent apps, and writes MELRA into the one you pick, saving a .bak first. It needs Node.js 22.13 or newer, and a Docker image and prebuilt releases exist. MELRA is built by XAGI Labs, which also makes a personal agent called Bhai that routes its sends through it.

## Features

- **Policy checks:** Every call is allowed, refused or held for approval.
- **Human approvals:** Risky changes wait for a person to approve the exact action.
- **Verified results:** An action is done only when the declared evidence holds.
- **Hash-linked receipts:** Each action ends in a redacted, durable record.
- **At-most-once dispatch:** Uncertain outcomes are parked, not replayed.
- **Guided setup:** One command configures a policy and your MCP client.

## Good for

- Gate an agent's file and shell actions behind approvals
- Keep an audit trail of what an agent did
- Stop duplicate sends after a timeout
- Limit an agent to an allowlist of domains and commands

## Install

### Claude Code (Terminal)

```sh
claude mcp add melra -- npx -y @melra/cli
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "melra": {
      "command": "npx",
      "args": [
        "-y",
        "@melra/cli"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "melra": {
      "command": "npx",
      "args": [
        "-y",
        "@melra/cli"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "melra": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@melra/cli"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "melra": {
      "command": "npx",
      "args": [
        "-y",
        "@melra/cli"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "melra": {
      "command": "npx",
      "args": [
        "-y",
        "@melra/cli"
      ]
    }
  }
}
```

## FAQ

### Is it production ready?

No. The README labels it alpha and says APIs may change before 1.0.

### What do I need to run it?

Node.js 22.13 or newer, or 23.4 or newer, or the Docker image.

### Does it control every tool my agent uses?

No. Only calls routed through MELRA are governed.

### How do I install it?

Run npx @melra/cli@alpha setup in the project folder.

### Is MELRA free?

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

### How do I add MELRA to Claude Code?

Run this command in your terminal: claude mcp add melra -- npx -y @melra/cli

### What are the best alternatives to MELRA?

The closest alternatives to MELRA 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/melra
