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 agent_servers in your mcacp.json and call reload_config.

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's session ID.

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: "prompted" }. Use prompt_events to poll for events. Pair with prompt_events for the async pattern; use prompt_sync for the blocking pattern.

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

Send a prompt and block until it completes, errors, or a permission_request needs operator attention. Returns all collected events at once. Returns early (without a complete event) on permission_request or timeout. For the async pattern, use prompt_polled + prompt_events instead.

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

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

Send an MCP elicitation to the outer host asking for a permission decision. Does not require a running agent or session.

Cancel an in-progress prompt.

Switch the operating mode of a session.

List all spawned ACP agent processes with status, heartbeat, and active sessions.

Get detailed status of a running ACP agent.

Set an explicit status text for a running agent.