MariusAure/needhuman-mcp

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:
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):
**Option C — one-line install (Claude Code):**
Writes ~/.needhuman/mcp-server.ts and adds NeedHuman to ~/.claude/settings.json.
**Get an API key** (3 free tasks, no signup):
Tools
| Tool | Description |
|------|-------------|
| need_human | Submit a task for a human to complete. Returns a task ID. |
| check_task_status | Poll a task by ID. Returns status, result, and proof. |
| list_tasks | List all tasks for the current API key. |
System prompt guidance
Add this to your agent's system prompt:
Not using MCP?
The REST API works with any agent framework:
Get an API key: see Install above. Full API reference: https://needhuman.ai/llms.txt
Status and limitations
- Pre-v1.0. API is stable but may change without notice.
- Tasks are completed by the founders. Coverage: weekdays CET business hours, best-effort evenings.
- Response time: 2–30 minutes during coverage hours, again best effort.
- Tasks with expiring links (< 30 min TTL) may time out before completion.
- 3 free tasks per API key. Pricing for additional tasks: contact marius.bergvik.aure@gmail.com.
- Polling only. No webhooks yet.
- Not accepted: tasks requiring credential storage, persistent login sessions, or financial transactions.
Data handling
- Task descriptions are stored in the database and read by a human founder to complete the task.