About agentchan
agentchan is an MCP server for coordinating conversations between installed, signed-in Claude Code, Codex, and Grok coding agents. It provides per-agent messaging plus channels for receiving replies and ending sessions.
Key features
- 01Message Claude Code, Codex, or Grok
- 02Start or continue agent sessions
- 03Wait for replies across channels
- 04Close sessions and stop agents
Use cases
- 01Delegate a coding question to another agent
- 02Run follow-up exchanges with an agent
- 03Collect the first reply from several sessions
MCP support
It exposes tools for available agents and channel management to MCP clients. Each message runs the selected agent CLI in the server's working directory with permission checks off.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMEagentchan
An MCP server that lets one coding agent talk to another: Claude Code, Codex or Grok. It gives one tool for each agent that is installed and signed in, plus two tools that work like Go channels:
claude(message, channel?),codex(…),grok(…)send a message and return a channel id at once. Withoutchannel, the message starts a new session. Withchannel, it is a follow-up.receive(channels)waits for the first reply on any of the channels, up to 50 s.close(channel)stops the agent and ends the channel.
Each channel is one agent session. Each message runs claude -p, codex exec or grok --prompt-file
in the server's working directory, with permission checks off, and with the settings that agent already has.
Install
Linux and macOS, prebuilt:
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/damejeras/agentchan/releases/latest/download/agentchan-installer.sh | sh
With npm, which downloads the same prebuilt binary:
npm install -g agentchan
From source:
cargo install agentchan
The server offers every agent that is installed and signed in when it starts.
# Claude Code
claude mcp add --scope user agentchan -- agentchan
# or, without installing it first
claude mcp add --scope user agentchan -- npx -y agentchan
# Codex: ~/.codex/config.toml
[mcp_servers.agentchan]
command = "agentchan"
Security
The called agent runs with permission checks off. It can read, write and run anything in the server's working directory without asking. Any agent that can call agentchan gets that access.
When a turn ends, and when a channel closes or the server stops, agentchan kills the agent's process group. A process that the agent moved to a different process group keeps running.
Test
cargo test # fake agents, no plan limits used
cargo test -- --ignored # the real CLIs that are signed in
Cost
Each message uses the called agent's own login and plan limits. Each message starts a new process that loads that agent's full configuration again.
Links
- MCP Registry name:
mcp-name: io.github.damejeras/agentchan
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.