Acp Gateway — Productivity skill for Claude Code

@agentrq/acp-gateway

ACP+MCP Bridge brings Experimentation Claude Notification Channels feature to all agents that supports Agent Client Protocol.

[!WARNING] **Pre-Alpha**: This project is in early development. APIs, configurations, and behaviors are subject to change without notice.

**Note**: `claude/notifications` is an experimental feature of Claude Code. `@agentrq/acp-gateway` extends this same capability to any `--acp` compatible agent (e.g., Gemini CLI).

Overview

`@agentrq/acp-gateway` bridges the [Agent Client Protocol (ACP)](https://agentclientprotocol.com) with the [Model Context Protocol (MCP)](https://modelcontextprotocol.io) to connect ACP-compatible AI agents (e.g., Gemini) to an agentrq MCP server.

It automates task execution by:

1. Loading your workspace's .mcp.json configuration.
2. Connecting to the agentrq MCP server.
3. Spawning an ACP-compatible agent subprocess.
4. Bridging MCP notifications (tasks, permission requests) to ACP prompts and vice versa.
5. Providing file read/write capabilities through the ACP protocol.
6. Auto-reconnecting the MCP transport on disconnection.

Prerequisites

• Node.js >= 24
• npm or yarn
• An ACP-compatible agent (e.g., Gemini CLI)
• An agentrq workspace with an HTTP MCP server

Installation

cd acp-gateway
npm install

To use globally:

npm install -g @agentrq/acp-gateway

Current Version

`0.2.17`

Usage

Quick Start

Run `acp-gateway` from your agentrq workspace root (the directory containing `.mcp.json`):

# From workspace root
acp-gateway -- gemini --acp

Or with a custom command:

acp-gateway -- your-acp-agent --flag1 --flag2

CLI Options

You can specify gateway options before the `--` separator:

• --max-concurrency / --maxConcurrency : Sets the maximum number of concurrent tasks allowed to prompt the ACP agent at once