# Epeaky host

> Epeaky host is an open-source MCP server for cloud and infrastructure. Install and administer an Epeaky encrypted-chat server over your own SSH. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, Linux
- **Website:** https://epeaky.zyn-network.com
- **Repository:** https://github.com/zyn-io/epeaky/tree/HEAD/agents/host-mcp
- **MCP Registry name:** io.github.zyn-io/epeaky-host-mcp
- **Categories:** cloud and infrastructure, developer tools
- **Listing updated:** 2026-11-16

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

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

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

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

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

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

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

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

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

## Tools

- `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

## 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

- [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/epeaky-host
