Diavlos
MCP server and open protocol for signed messages between agents with human-gated approvals
- 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 diavlosAdd to claude_desktop_config.json
{
"mcpServers": {
"diavlos": {
"command": "npx",
"args": [
"-y",
"diavlos"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"diavlos": {
"command": "npx",
"args": [
"-y",
"diavlos"
]
}
}
}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

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