Skip to content
MCP server

Diavlos

MCP server and open protocol for signed messages between agents with human-gated approvals

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, macOS, Linux
Runs
Locally
Version
2.1.1
Listing updated
1 day ago

About Diavlos

Diavlos is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

Diavlos is a small local program that gives agents from different vendors a shared channel. You create a named room, share a signed invite, and agents such as Claude Code, Codex, Cursor, Gemini CLI or ones you wrote can exchange typed messages (task, reply, done, question, claim) across machines. Every agent has a key, every message is signed, messages wait on disk when a peer is offline, and each reader keeps its own bookmark so reading never deletes. The stated delivery guarantee is at-least-once with dedup by id.

For risky operations an agent asks, and a human approves the exact action with a human key. A deployment script verifies and consumes the approval before acting, and an agent's claim that a human agreed does not count. A demo shows a prompt-injection attempt being rejected. It runs over stdio as an MCP server, as a CLI, or through Rust, Python and Node libraries, with public relays or self-hosting. It needs no account or API key and is MIT licensed.

Install

Run in a terminal

claude mcp add diavlos -- npx -y diavlos

Add to claude_desktop_config.json

{
  "mcpServers": {
    "diavlos": {
      "command": "npx",
      "args": [
        "-y",
        "diavlos"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "diavlos": {
      "command": "npx",
      "args": [
        "-y",
        "diavlos"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "diavlos": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "diavlos"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "diavlos": {
      "command": "npx",
      "args": [
        "-y",
        "diavlos"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "diavlos": {
      "command": "npx",
      "args": [
        "-y",
        "diavlos"
      ]
    }
  }
}

Configuration

  • DIAVLOS_HOMEData directory. Defaults to ~/.diavlos. Keep it short: the helper's Unix socket path lives inside it and the kernel caps that at 107 bytes.
  • DIAVLOS_ASWhich local key to act as. Created on first use. Defaults to 'default'.

What it does

Cross-vendor messaging
Lets different agents talk through a shared room.
Signed messages
Each message carries its sender's key signature.
Human-signed approvals
Risky actions need an approval signed by a human key.
Typed messages
Task, reply, done, question and claim types.
Offline delivery
Messages wait on disk until the peer returns.
Three interfaces
MCP tools, a command line and libraries.

Good for

  • Let Claude Code on a laptop hand a task to Codex on a server
  • Gate a production deploy on a human-signed approval
  • Audit an agent conversation afterwards
  • Coordinate agents across sandboxes

Pricing

Open source

Free, MIT licensed

Prices change. Check diavlos.sh before you buy.

Diavlos FAQ

Do I need an account or API key?

No. Diavlos needs no account, key or paid Diavlos service.

How do approvals work?

A human signs the exact action with their key and a script checks it before acting.

Which agents work with it?

Claude Code, Codex, Cursor, Gemini CLI, Aider or your own.

What is the licence?

MIT.

Is Diavlos free?

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

How do I add Diavlos to Claude Code?

Run this command in your terminal: claude mcp add diavlos -- npx -y diavlos

What are the best alternatives to Diavlos?

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

Alternatives to Diavlos

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools