# withHuman

Pauses an AI agent's tool calls until a person signs off. Useful once the agent can issue refunds, roll back deploys or merge code.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 16
- Author: withHumanAI
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/withHumanAI/withHuman
- Updated: 2026-10-22
- HTML: https://affpapa.org/en/nevibecode/mcp/withhuman

## What it does

withHuman sits in front of tool execution as an approval layer. You write the rules once: routine calls go through, blocked ones are refused, and the risky ones wait for someone to decide. Every connected agent obeys the same policies.

An adapter, either a runtime hook or an SDK wrapper, forwards each call over the Agent Approval Protocol. A pipeline then looks at the tool name and its arguments — for instance, small refunds pass and larger ones get escalated. Escalation paths pick the reviewer by team, level and working hours. That person gets email, Slack or Discord, then approves or denies in the web app with the arguments and the agent's reasoning on screen.

The server ships as a Docker image: `docker run -d --name withhuman -p 8080:8080 -v withhuman-data:/data quay.io/withhuman/bundle:latest`, with the bootstrap secret read from `/data/bootstrap-secret`. Building from source needs Go and Node 25. Before exposing it beyond your own machine, put it behind HTTPS, set `WITHHUMAN_PUBLIC_ORIGIN`, restrict `WITHHUMAN_TRUSTED_PROXIES` to your proxy addresses and keep `WITHHUMAN_SECRETS_KEY` safe; without SMTP, invitations and password resets never reach anyone.

## Requirements
- Needs: Docker
- Remote server: `https://app.withhuman.ai/api/mcp/v1`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http withhuman https://app.withhuman.ai/api/mcp/v1
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add withhuman --url https://app.withhuman.ai/api/mcp/v1
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "withhuman": {
            "url": "https://app.withhuman.ai/api/mcp/v1"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "withhuman": {
            "type": "http",
            "url": "https://app.withhuman.ai/api/mcp/v1"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http withhuman https://app.withhuman.ai/api/mcp/v1
```

## When to use it
- gate a refund behind a human before it is issued
- route tool calls by a threshold in their arguments
- pick a reviewer from team and working hours
- auto-deny tool calls your agent must not make
- keep pending requests in one review queue

## Example prompts
- Connect this agent to withHuman and set the pipeline so refunds under 20 dollars auto-approve and anything larger asks me
- Add an escalation path for the payments team during working hours and send the rest to the on-call reviewer
- Show me which tool calls are waiting for my approval right now

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

---
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