MCACP

MCACP bridges MCP clients to ACP coding agents, turning a chat-based workflow into a multi-agent control plane. You can run any ACP agent from any MCP client, manage sessions, and orchestrate agent-driven coding pipelines without needing dedicated plugins for each agent.

How to use

You connect an MCP client to MCACP, which speaks the Agent Client Protocol on behalf of your MCP host. From there, you can browse the ACP registry, install agents, start a session, and issue prompts to one or more agents in parallel. Use MCACP to compare agents side by side, compose agent-driven pipelines, and manage permissions interactively or in operator mode depending on your host capabilities. Sessions persist to disk so you can resume where you left off.

How to install

Prerequisites: you need Node.js and npm installed on your system.

Configuration and running

The server is configured via a JSON file named mcacp.json. You define registries, a default permission policy, and custom agent servers. Example configurations show a registry endpoint, a default elicit policy, and a custom local agent command.

{
  "registries": ["https://cdn.agentclientprotocol.com/registry/v1/latest/registry.json"],
  "defaultPermissionPolicy": "elicit",
  "agent_servers": {
    "my-custom-agent": {
      "command": "node",
      "args": ["my-agent.js"]
    }
  }
}

Starting from source and using the CLI

You can install the MCACP command-line entry and run it directly to start MCACP, then connect your MCP client to it. The standard workflow uses the following commands.

npm install -g mcacp
npx mcacp

Available tools

list_installed_agents

List locally installed ACP agents available to MCACP.

registry_search

Browse the ACP agent registry to find available agents.

agent_install

Install an ACP agent from the registry into MCACP.

agent_uninstall

Remove an installed ACP agent from MCACP.

agent_check_upgrades

Check for available upgrades for installed agents.

discover_agents

Scan editor configurations for configured agents and integrate them.

reload_config

Reload mcacp.json from disk to apply changes.

initialize

Spawn an agent process and perform the ACP handshake.

shutdown

Gracefully shut down an agent.

new_session

Create a new session with a working directory and permission policy.

load_session

Resume a previously saved session.

list_sessions

List stored sessions for an agent.

close_session

Close a session while preserving the ability to resume later.

prompt_start

Send a prompt to an agent and return immediately.

prompt

Block until events are available from an agent in response to a prompt.

prompt_events

Poll for new events without blocking.

grant_permission

Resolve a pending permission request in operator mode.

request_permission

Ask the host for a permission decision via MCP elicitation.

cancel

Cancel an in-progress prompt.

set_mode

Switch the agent operating mode.

list_running_agents

List all agents with their status and sessions.

get_agent_status

Get detailed status information for a running agent.

set_agent_status

Set a text status for an agent.