Skip to main content
MCP server CX Codex

hoptell — Claude Code MCP server: messaging between AI agents

hoptell connects AI agents through a self-hosted relay: passes tasks, code and replies across Claude Code, Codex and other sessions on different machines and accounts.

Apache-2.0 ★ 10 updated 2026-10-08

Install into Claude Code · Platform CLI All methods and platforms ↓
claude mcp add --env HOPTELL_RELAY=<HOPTELL_RELAY> --env HOPTELL_TOKEN=<HOPTELL_TOKEN> --env HOPTELL_NAME=<HOPTELL_NAME> --env HOPTELL_ROLES=<HOPTELL_ROLES> --transport stdio hoptell -- npx -y hoptell
Open on GitHub

What hoptell does

hoptell links agents through a WebSocket relay running on one machine in your LAN or VPN. Each agent gets tools — list_peers, send_message, read_inbox — and can route messages by name, role (@reviewer, @backend) or to everyone (@all). An incoming message wakes the receiving session: Claude Code uses channels or hooks, tmux supports fixed terminal notices, other sessions rely on polling.

Inside: one Node process with two dependencies (ws and the MCP SDK). Agents exchange text only through your relay, each still talks to its own AI provider. Queued messages for offline agents stay in the relay's memory until they return.

Without tmux 3.2 or later, waking terminal agents fails. The relay and polling tools work on Windows; everything else needs macOS or Linux.

What it helps with

  • pass code for review from one machine to another without manual copying
  • wake a remote agent with an incoming message
  • ask the agent with the @pm role about the project's release plan
  • link several agents into a team where each handles its own part
  • run a relay for agent communication without external services

Example prompts for the agent

  • Send the contents of auth.js to agent Alex for a security check
  • Ask @backend which endpoint the payments module uses
  • Show the list of connected agents and their roles

How to install hoptell

Platform CLI

claude mcp add --env HOPTELL_RELAY=<HOPTELL_RELAY> --env HOPTELL_TOKEN=<HOPTELL_TOKEN> --env HOPTELL_NAME=<HOPTELL_NAME> --env HOPTELL_ROLES=<HOPTELL_ROLES> --transport stdio hoptell -- npx -y hoptell

Replace <…> with your own values

Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more

Questions about hoptell

How do I install hoptell in Claude Code?

Run claude mcp add hoptell -e HOPTELL_RELAY=<HOPTELL_RELAY> -e HOPTELL_TOKEN=<HOPTELL_TOKEN> -- npx -y hoptell, filling in the relay address and token. Or install the plugin: /plugin marketplace add EminUZUN/hoptell, then /plugin install hoptell@hoptell.

What does hoptell do?

Routes messages between AI agents through your relay. One agent on one machine sends a task or code to another agent, which gets a notice and can reply. Works across different sessions, accounts and tools.

What does hoptell need to run?

Node.js 20 or later. To wake terminal agents, tmux 3.2 or later. The relay starts on one machine, agents connect to it using HOPTELL_RELAY and HOPTELL_TOKEN variables.

Similar MCP servers

All MCP servers for Agent setup: memory, context, orchestration →
cli-anything-iterm2 HKUDS The cli-anything-iterm2 skill for Claude Code connects agents to live iTerm2 sessions via the Python API, sending commands, reading output and scrollback, and splitting and labeling panes. CX Codex +1 559installs 3dstreet 3DStreet A relay that bridges Claude Desktop, Claude Code, and other development environments to a 3DStreet browser tab. Through MCP tools, an agent can inspect scenes, add and modify objects, adjust parameters, and manage undo/redo. CX Codex +1 centrifugo pedronauck Skill for working with Centrifugo, a self-hosted real-time messaging server supporting WebSocket, SSE, and GRPC. Sets up channels, JWT authentication, backend publishing, and client subscriptions to live updates. CX Codex +1 263installs nemo-relay-install NVIDIA Corporation and Affiliates The nemo-relay-install skill identifies your installation target and deploys the current stable NeMo Relay package, resolving prerequisites and verifying availability. Works across agent runtimes, frameworks, and language bindings. CX Codex +1 227installs zcode-delegate amElnagdy zcode-delegate — a skill for Claude Code, Codex, and Cursor that offloads scoped coding tasks to the Z.AI ZCode CLI. Turns your primary assistant into a reviewer while ZCode writes the patch. CX Codex +1 3,200installs smux ShawnPana smux controls tmux panes and manages communication between AI agents via tmux-bridge. Useful when multiple agents or background tasks run in parallel panes. CX Codex +1 2,900installs

Project sponsors

Companies that keep this analytics open