# NeedHuman

Human-in-the-loop MCP server. When your agent is blocked by CAPTCHA, identity verification, account creation, or terms of service — it dispatches the task to a real human worker and polls for the res…

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add needhuman/needhuman-mcp

# Browse available tools
npx -y @smithery/cli@latest tool list needhuman/needhuman-mcp

# Get full schema for a tool
npx -y @smithery/cli@latest tool get needhuman/needhuman-mcp need_human

# Call a tool
npx -y @smithery/cli@latest tool call needhuman/needhuman-mcp need_human '{}'
```

## Direct MCP Connection

Endpoint: `https://needhuman-mcp--needhuman.run.tools`

**Required config:**
- `apiKey` (query) — Your NeedHuman API key (nh_ prefix). Register free at needhuman.ai

## Tools (3)

- `need_human` — Call when you cannot proceed because the next step requires a real human. USE WHEN blocked by: ToS, account creation, i…
- `check_task_status` — Check whether a human worker has completed a task dispatched via need_human. Returns status, result, and proof fields. …
- `list_tasks` — List all tasks you have submitted, newest first. Use when you have lost track of a task_id.

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get needhuman/needhuman-mcp <tool-name>
```