npm:mcacp

List all locally installed ACP agents with their id, name, version, and description.

Search configured ACP agent registries for available agents.

Install an ACP agent from the registry.

Remove a locally installed ACP agent.

Check all installed agents for available version upgrades.

Scan editor configs (Zed settings.json, JetBrains acp.json) for ACP agents. Returns agents with command/args/env and source. To import, add them to ag

Reload configuration from disk. Use after editing mcacp.json to pick up new agent_servers entries or changed settings. Returns the new config.

Spawn an ACP agent process and perform the initialize handshake. Must be called before creating sessions.

Gracefully shut down a running ACP agent, closing all sessions.

Create a new ACP session on an initialized agent. Returns the agent

Resume a previously created session. Agent must support session loading.

List stored sessions. Does not require the agent to be running.

Close an active session. Session file preserved for future load_session.

Send a prompt to an active ACP session. Returns immediately with { status:

Non-blocking poll for prompt events. Returns all queued events (updates, permission requests, completion). May return empty array if no new events.

Block until at least one prompt event is available. Returns queued events including updates (with full ACP metadata), permission requests, and complet

Block until any prompted session produces events. Returns events stamped with sessionId and agentId. Supports optional Nagle-style coalescing to batch

Respond to a pending permission request (operator policy). The agent resumes; new events flow to the queue.