agent-comm

Agent Communication MCP Server acts as a mission control hub for coordinating multiple specialized AI agents. It allows you to define tasks for distinct agents (for example, frontend engineer, backend engineer, QA tester) and observe how each agent understands the request, plans their approach, and progresses toward completion in real time. The server provides transparent visibility into each agent’s reasoning and workflow, enabling parallel work without file path chaos or setup headaches. Use the included tools to submit plans, track progress, and consolidate results across agents as a single cohesive task.

To integrate with Claude Code or other MCP clients, configure a MCP server entry named agent-comm (as shown in the setup example). The server is exposed via the MCP protocol and can be launched with npm/npx instructions. The tools enable you to create tasks for specific agents, monitor their progress, and fetch final outputs. You can also enable advanced features like plan validation and smart discovery to speed up task orchestration and improve reliability by automatically discovering and validating available agents.

Prerequisites:

• Node.js 18+ installed on your system
• npm (comes with Node.js) or yarn

Installation steps:

1. Global install (recommended for MCP usage):

npm install -g @jerfowler/agent-comm-mcp-server

2. Run directly with npx (no installation required):

npx @jerfowler/agent-comm-mcp-server

3. From source (clone, install, build):

git clone https://github.com/jerfowler/agent-comm-mcp-server.git
cd agent-comm-mcp-server
npm install
npm run build

Setup with Claude (example):

# Install globally and create configuration for Claude
npm install -g @jerfowler/agent-comm-mcp-server
npm run setup  # Creates .mcp.json with configured servers

Manual Claude configuration example (paste into .mcp.json or Claude config):

{
  "mcpServers": {
    "agent-comm": {
      "command": "npx",
      "args": ["@jerfowler/agent-comm-mcp-server"],
      "env": {
        "AGENT_COMM_DIR": "./comm"
      }
    }
  }
}

Note: The .mcp.json file is typically gitignored to protect sensitive credentials; use .mcp.json.example as a template and run the setup script to generate a working configuration.

Tips and common considerations:

• The server is Node.js-based and uses the MCP protocol to coordinate agents; ensure Node.js 18+ is installed.
• You can customize the environment via env vars in the mcp configuration; for example, AGENT_COMM_DIR can point to a working directory for comm artifacts.
• When using Claude or other clients, keep your API keys secure; the setup file is typically ignored by git. Use the provided .mcp.json.example as a template.
• If you enable features like stepCount in plan submissions, the system caches PLAN.metadata.json to speed up subsequent progress reporting.
• For best results, ensure your agents are available and properly discovered by the system to maximize reliability and reduce setup time.