MELRA
Local MCP runtime that checks, approves and records every agent tool call
- Pricing
- Open source
- Platforms
- CLI, self-hosted
- Runs
- Locally
- Version
- 0.3.0-alpha.14
- Listing updated
- 2 days ago
About MELRA
MELRA is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.
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.
Install
Run in a terminal
claude mcp add melra -- npx -y @melra/cliAdd to claude_desktop_config.json
{
"mcpServers": {
"melra": {
"command": "npx",
"args": [
"-y",
"@melra/cli"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"melra": {
"command": "npx",
"args": [
"-y",
"@melra/cli"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"melra": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@melra/cli"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"melra": {
"command": "npx",
"args": [
"-y",
"@melra/cli"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"melra": {
"command": "npx",
"args": [
"-y",
"@melra/cli"
]
}
}
}What it does
- 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
Pricing
Open source
Open source; alpha release
Prices change. Check xagilab.com before you buy.
MELRA 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 to MELRA

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools