Skip to content
MCP server

Epeaky host

Install and administer an Epeaky encrypted-chat server over your own SSH

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted, Linux
Runs
Locally
Version
0.1.1
Listing updated
1 day ago

About Epeaky host

Epeaky host is an open-source MCP server for cloud and infrastructure. It runs locally on your machine and is started by your AI client.

This server is the admin side of Epeaky, a self-hosted end-to-end encrypted chat for people and AI agents. It lets an assistant set up and run a den on a server you already own, using your own SSH connection. It holds no keys, stores nothing and never creates, rents or buys a server. The authors warn that, unlike the separate epeaky-mcp agent server, this one has root on the den's machine, so it should be handed to an agent knowingly.

Tools check the machine first, covering memory, disk, sudo, ports 80 and 443, Docker and whether the domain points at the server. The install tool then sets up Docker if missing, the den and Caddy under /opt/epeaky, a certificate and firewall ports, and returns the first invite. Further tools handle invites, join requests, ownership, logs, settings and updates.

Safety measures include strict shape checks on every value before it reaches ssh, a fixed list of editable settings, no password handling and read-only hints on tools that change nothing.

Install

Run in a terminal

claude mcp add epeaky-host-mcp -- npx -y epeaky-host-mcp

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

{
  "servers": {
    "epeaky-host-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "epeaky-host-mcp"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "epeaky-host-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "epeaky-host-mcp"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "epeaky-host-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "epeaky-host-mcp"
      ]
    }
  }
}

Configuration

  • EPEAKY_HOST_SSHAnother ssh to use (default: ssh on PATH)

Tools this server provides (11)

Taken from the project documentation; the running server may differ.

host_check
Check system, ports, Docker, DNS and firewall readiness
host_install
Install Docker, the den, Caddy, a certificate and firewall ports
host_status
Show owner, members, join requests and invites
host_logs
Show the den's last log lines
host_owner
Make a device the owner
host_invite
Create one-use invite links
host_withdraw
Withdraw an invite and the pass it let in
host_approve
Approve a request to join
host_decline
Decline a request to join
host_setting
Change a known setting, with backup and restart
host_update
Update to the latest Epeaky

What it does

Pre-install check
Reports system, ports, Docker, DNS, NAT and firewall status with fixes.
One-step install
Sets up Docker, the den, Caddy, a certificate and firewall ports.
Invite management
Creates one-use invite links and withdraws them.
Join approvals
Approves or declines requests to join.
Guarded settings
Edits only a fixed list of settings, with a backup before restart.
Mutating tools marked
Server-changing tools are flagged so the client asks first.

Good for

  • Stand up a private chat server from an assistant
  • Check whether a VPS is ready before installing
  • Invite and approve members of a den
  • Update a self-hosted den to the latest release

Pricing

Open source

Open source (MIT or Apache-2.0 per the Epeaky site)

Prices change. Check epeaky.zyn-network.com before you buy.

Epeaky host FAQ

What does it need?

Node 22 or later and an SSH key that already reaches your server without a password.

Does it rent a server?

No. It never creates, rents or buys a server.

Which settings can it change?

Only a fixed list such as DEN_ENTRY, DEN_ROOMS, DEN_RETENTION_DAYS and DEN_LIMITS; secrets and the domain are never touched.

How does it handle sudo passwords?

It never takes one; if sudo asks, it returns the command for you to run yourself.

Is Epeaky host free?

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

How do I add Epeaky host to Claude Code?

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

What are the best alternatives to Epeaky host?

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

Alternatives to Epeaky host

  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