# Use Acp

> React hooks for connecting to Agent Client Protocol (ACP) servers.

- **Type:** MCP server
- **Install:** `agentstack add mcp-marimo-team-use-acp`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [marimo-team](https://agentstack.voostack.com/s/marimo-team)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [marimo-team](https://github.com/marimo-team)
- **Source:** https://github.com/marimo-team/use-acp
- **Website:** https://marimo-team.github.io/use-acp/

## Install

```sh
agentstack add mcp-marimo-team-use-acp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# use-acp

React hooks for [Agent Client Protocol](https://agentclientprotocol.com/) (ACP) over WebSockets.

## Features

- WebSocket connection management
- Reactive state management
- Notifications timeline for ACP events
- Permission request/response handling
- Full TypeScript support

## Installation

```bash
npm install use-acp
# or
pnpm add use-acp
```

## Usage

### Basic Usage

```tsx
import { useAcpClient } from 'use-acp';

function App() {
  const {
    connect,
    disconnect,
    connectionState,
    notifications,
    pendingPermission,
    resolvePermission,
  } = useAcpClient({
    wsUrl: 'ws://localhost:8080',
    autoConnect: true
  });

  return (
    
      Status: {connectionState.status}
      
        {connectionState.status === 'connected' ? 'Disconnect' : 'Connect'}
      

      {pendingPermission && (
        
          Permission Request
          {pendingPermission.options.map((option) => (
             resolvePermission(option)}>
              {option.name}
            
          ))}
        
      )}

      Notifications: {notifications.length}
      
        {notifications.map((notification) => (
          {JSON.stringify(notification)}
        ))}
      
    
  );
}
```

## API Reference

### `useAcpClient({ wsUrl, autoConnect?, reconnectAttempts?, reconnectDelay? })`

**Returns:** `{ connect(), disconnect(), connectionState, notifications, clearNotifications(), pendingPermission, resolvePermission(), rejectPermission(), agent }`

### Utils

```tsx
import { groupNotifications, mergeToolCalls } from 'use-acp';

// Group notifications by their type
// This helps when displaying notifications in a timeline
const groupedNotifications = groupNotifications(notifications);

// Merge tool calls with the same toolCallId
const mergedToolCalls = mergeToolCalls(toolCalls);
```

## Development

```bash
pnpm install
pnpm test      # run tests
pnpm build     # build library
pnpm dev       # run demo, http://localhost:5173
```

### Example Agents

```bash
# Gemini ACP
npx -y stdio-to-ws "npx @google/gemini-cli --experimental-acp"

# Claude Code ACP
npx -y stdio-to-ws "npx @zed-industries/claude-code-acp"

# Codex ACP
npx -y stdio-to-ws "npx @zed-industries/codex-acp"
```

## License

Apache 2.0

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [marimo-team](https://github.com/marimo-team)
- **Source:** [marimo-team/use-acp](https://github.com/marimo-team/use-acp)
- **License:** Apache-2.0
- **Homepage:** https://marimo-team.github.io/use-acp/

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-marimo-team-use-acp
- Seller: https://agentstack.voostack.com/s/marimo-team
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.