# mcacp

Connects MCP clients to ACP coding agents from one chat. Use it to run agents side by side, build handoffs, and resume saved sessions.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 12
- Author: Oortonaut
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Oortonaut/mcacp
- Updated: 2026-02-01
- HTML: https://affpapa.org/en/nevibecode/mcp/mcacp

## What it does

mcacp acts as an MCP-to-ACP bridge over stdio. From Claude Code, Zed, or another compatible client, you can start an agent, create a session, send prompts, read events, and stop the process. It can also search the ACP registry, install agents, discover configured agents, and check upgrades.

The server exposes 22 tools grouped around registry actions, lifecycle control, sessions, interaction, and status. Sessions persist on disk and can be reopened with `load_session`; each session accepts `allow_all`, `deny_all`, `elicit`, or `operator` permissions. In Claude Code, permission requests use `operator` because this host does not support MCP elicitation. Add the server with `claude mcp add mcacp -- npx -y mcacp`.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add mcacp -- npx -y mcacp
```

### Codex

**Platform CLI**
```bash
codex mcp add mcacp -- npx -y mcacp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcacp": {
            "command": "npx",
            "args": [
                "-y",
                "mcacp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcacp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "mcacp"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add mcacp npx -y mcacp
```

## When to use it
- run ACP coding agents from an MCP client
- compare several agents on the same task
- chain coding, review, and test sessions
- resume an agent session saved on disk
- handle agent tool permissions interactively

## Example prompts
- Search the ACP registry and install Gemini using `registry_search` and `agent_install`.
- Initialize Codex, create a session for the current directory, and ask it to refactor authentication.
- Load a saved session with `load_session` and show its current events.

## Similar
- [agent-council](https://affpapa.org/en/nevibecode/plugins/agent-council.md) — plugin · ★ 11
- [nelson](https://affpapa.org/en/nevibecode/skills/nelson.md) — skill · 1300 installs
- [multi-agent-optimize](https://affpapa.org/en/nevibecode/commands/multi-agent-optimize.md) — command · ★ 41823
- [weixin-agent-sdk](https://affpapa.org/en/nevibecode/skills/weixin-agent-sdk.md) — skill · 1100 installs
- [warp-delegate](https://affpapa.org/en/nevibecode/skills/warp-delegate.md) — skill · 2800 installs
- [grok-delegate](https://affpapa.org/en/nevibecode/skills/grok-delegate.md) — skill · 4300 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md