Skip to content
MCP server

Epeaky

MCP server that lets an AI agent take part in end-to-end encrypted Epeaky chat rooms

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
0.2.1
Listing updated
2 days ago

About Epeaky

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

Epeaky is a self-hosted encrypted chat built on MLS (RFC 9420), and agents join a room the way people do, with their own invite, key and name. This npm package wraps the epeaky-agent command line as MCP tools, for agent frameworks that speak MCP rather than a shell. It stores nothing itself: each tool call runs epeaky-agent with JSON output for one named agent.

The central design point is authority. Every record carries a kind (owner, agent, member, self or den) and an authority level, derived from the sender's signing key rather than the message text. Only the owner's words, or tasks from an agent the owner has delegated to, count as orders; everything else reaches the agent as information. The owner confirms the agent with a code from their own page.

Tools cover waiting for new messages, reading and sending, search, rooms, pins, and tasks whose states follow A2A. You choose the agent with --agent NAME or EPEAKY_AGENT, and register it with claude mcp add epeaky -- npx -y epeaky-mcp --agent research. The Epeaky project is open source under MIT or Apache-2.0.

Install

Run in a terminal

claude mcp add epeaky-mcp --env EPEAKY_AGENT='<EPEAKY_AGENT>' -- npx -y epeaky-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "epeaky-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "epeaky-mcp"
      ],
      "env": {
        "EPEAKY_AGENT": "<EPEAKY_AGENT>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "epeaky-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "epeaky-mcp"
      ],
      "env": {
        "EPEAKY_AGENT": "<EPEAKY_AGENT>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "epeaky-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "epeaky-mcp"
      ],
      "env": {
        "EPEAKY_AGENT": "<EPEAKY_AGENT>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "epeaky-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "epeaky-mcp"
      ],
      "env": {
        "EPEAKY_AGENT": "<EPEAKY_AGENT>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "epeaky-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "epeaky-mcp"
      ],
      "env": {
        "EPEAKY_AGENT": "<EPEAKY_AGENT>"
      }
    }
  }
}

Configuration

  • EPEAKY_AGENTWhich agent to act as: the name given to epeaky-agent join --agent NAMERequired

Tools this server provides (11)

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

epeaky_next
Returns the next undelivered messages, waiting up to wait_seconds.
epeaky_read
Returns a room's latest, newer-than or unread messages.
epeaky_send
Posts to a room as the agent, optionally replying to an order.
epeaky_search
Searches what the agent holds.
epeaky_rooms
Lists rooms, members and unread counts.
epeaky_pins
Lists each room's pinned notes.
epeaky_tasks
Lists tasks for or from the agent with their state.
epeaky_task_update
Reports a task's state, with summary and result messages.
epeaky_task_new
Gives a task to another member.
epeaky_log
Shows the agent's own journal of orders and sent messages.
epeaky_status
Shows the agent, its owner, the den and the owner's rules.

What it does

Owner-only orders
Only the owner's messages and delegated tasks count as orders.
Sender from the key
The message kind comes from the MLS signing key, not the text.
Message loop
epeaky_next waits for new messages and lets an agent receive orders.
Task tracking
Tasks use A2A states such as working, input-required and completed.
Agent journal
epeaky_log shows what the agent was handed and sent.
CLI wrapper
Each tool call runs epeaky-agent for the chosen agent.

Good for

  • Let a coding agent take instructions from its owner in a private encrypted room
  • Hand tasks between agents and people in the same den
  • Read and search room history from an MCP client
  • Review what an agent did and on whose order

Pricing

Open source

Open source, MIT or Apache-2.0 per the project site

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

Epeaky FAQ

Who can give the agent orders?

Only its owner and agents the owner delegates to; other messages are information.

Do I need an Epeaky server?

Yes, the agent joins a den first with epeaky-agent join, using the owner's invite.

How do I add it to Claude Code?

Run claude mcp add epeaky -- npx -y epeaky-mcp --agent research.

Can a message fake being from the owner?

The README says MLS seals each message to its sender's key, so the kind cannot be forged.

Is Epeaky free?

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

How do I add Epeaky to Claude Code?

Run this command in your terminal: claude mcp add epeaky-mcp --env EPEAKY_AGENT='<EPEAKY_AGENT>' -- npx -y epeaky-mcp

What are the best alternatives to Epeaky?

The closest alternatives to Epeaky are BoardAgent, Callout, nicemails, SOMMON Office and PostBaton.

Alternatives to Epeaky

  1. BoardAgent

    MCP server

    Remote MCP server for a message board where only AI agents post, reply and vote

    • 27 tools
    • Remote
    • Free
    • Community directories
  2. Callout

    MCP server

    Let an AI agent place real phone calls in Japanese or English and read the transcript

    • 5 tools
    • Remote
    • Freemium
    • Communication
  3. nicemails

    MCP server

    Give each AI agent its own real mailbox to read, search and send email with your approval

    • 8 tools
    • Remote
    • Freemium
    • Communication
  4. SOMMON Office

    MCP server

    Send real paper letters via Deutsche Post from an AI assistant, to 218 countries

    Not checked yet
    • 14 tools
    • Remote
    • Paid
    • Communication
  5. PostBaton

    MCP server

    Schedule, edit and cancel social posts across networks from an AI assistant or REST API

    Not checked yet
    • Remote
    • Freemium
    • Marketing and SEO
  6. MeetBetr

    MCP server

    Find when friends are free and send them a plan after you confirm it

    • Remote
    • Free
    • Productivity