NeedHuman

mariusaure/needhuman-mcp

Connects Claude to NeedHuman's human-as-a-service API for tasks that require a real person with a browser. Exposes three tools: need_human submits tasks (like accepting terms of service, filling web forms, or completing identity verification), check_task_status polls for completion, and list_tasks shows your queue. Works over stdio via npx or as a remote HTTP endpoint at needhuman.ai/mcp with zero installation. Includes 3 free tasks per API key, with founders completing requests during CET business hours in 2-30 minutes. Useful when your agent hits a wall that automation can't cross, like CAPTCHAs or workflows designed to block bots.

tools: 3
auth: Secret needed
transport: STDIO, HTTP
env vars: 2
last updated: Mar 9, 2026

View on GitHub

Install

From registry metadata

$ npx add-mcp https://needhuman.ai/mcp --name needhuman-mcp --header 'Authorization: Bearer ${API_TOKEN}'

Run in your terminal. add-mcp asks which agents to add it to, then asks for each value it needs. Add -g to install it for every project.

Review the command, arguments and environment values before installing. MCP servers run with your local permissions.

Other ways

Claude Code

$ claude mcp add --transport http needhuman-mcp https://needhuman.ai/mcp --header 'Authorization: YOUR_AUTHORIZATION'

Run in your terminal. Add --scope user to make it available in every project.

Tools

Verified live · 3 tools

Verified live against the running server on Nov 6, 2026.

need_humanCall when you cannot proceed because the next step requires a real human. USE WHEN you are blocked by: - Terms of Service or legal agreements requiring a natural person - Account creation that needs identity verification or CAPTCHA - Authentication requiring human identity (Ba...4 params

Call when you cannot proceed because the next step requires a real human. USE WHEN you are blocked by: - Terms of Service or legal agreements requiring a natural person - Account creation that needs identity verification or CAPTCHA - Authentication requiring human identity (Ba...

Parameters* required

action_typestring

Category: 'create_account', 'accept_terms', 'complete_web_action', 'bankid_auth', 'verify_identity', 'form_submission'

demoboolean

Set to true to get an instant synthetic response. No credits consumed, no real human involved. Use to verify integration works before submitting real tasks.

description*string

What you need the human to do. Include URLs, account details, and expected outcome.

urgencystring

immediate = target completion within 5 minutes. normal = within 60 minutes.one of immediate · normal

check_task_statusUse after dispatching a task via need_human to check whether the human worker has completed it. Returns: status (pending | in_progress | completed | failed | expired), result, proof (structured JSON), proof_text, proof_url. Poll no more than once every 30 seconds. Typical task...1 params

Use after dispatching a task via need_human to check whether the human worker has completed it. Returns: status (pending | in_progress | completed | failed | expired), result, proof (structured JSON), proof_text, proof_url. Poll no more than once every 30 seconds. Typical task...

Parameters* required

task_id*string

The task_id returned by need_human.

list_tasksUse when you have lost track of a task_id or want to review your past human task requests. Returns all tasks you have submitted, newest first: id, status, description, result, and timestamps.

Use when you have lost track of a task_id or want to review your past human task requests. Returns all tasks you have submitted, newest first: id, status, description, result, and timestamps.

No parameters. Call it with no arguments.

Configuration

NEEDHUMAN_API_KEY*secret

Your NeedHuman API key. Self-register for free (3 tasks): curl -X POST https://needhuman.ai/api/v1/keys/register -H 'Content-Type: application/json' -d '{"name":"my-agent"}'

NEEDHUMAN_API_URL

API base URL. Defaults to https://needhuman.ai

Readme

NeedHuman MCP Server

MCP server for NeedHuman — Human-as-a-Service API for AI agents.

When your agent hits a step it requires any real human with a browser — accepting terms of service, creating an account, completing identity verification, submitting web forms — it calls NeedHuman. A human (yes, it's basically me in the beginning) completes the task, submits proof, and the agent continues.

Install

Option A — Remote HTTP (zero install):

Connect directly to the hosted MCP endpoint — no npm, no local server:

URL: https://needhuman.ai/mcp
Transport: Streamable HTTP
Auth: Bearer YOUR_KEY (in Authorization header)

Works with Claude.ai, Smithery, and any MCP client that supports HTTP transport.

Option B — npx (local stdio):

Add to your MCP client config (e.g. ~/.claude/settings.json or .cursor/mcp.json):

View the full README on GitHub

Details

Repository: github.com/mariusaure/needhuman-mcp
Website: needhuman.ai
Package: @needhuman/mcp-server
Transport: STDIO, HTTP
Auth: Required
Registry: MCP registry, active
Tools verified: Nov 6, 2026