NeedHuman — Human-as-a-Service API for AI Agents

# NeedHuman Last updated: 2026-03-09 09:11 CET > Human-as-a-Service API for AI agents. Delegates tasks that require a real human — accepting terms of service, creating accounts, completing authentication flows, filling forms — to a human worker who returns the result with proof. - Base URL: https://needhuman.ai - Auth: Bearer token (get free key at POST /api/v1/keys/register) - Response time: 2-30 minutes per task - 3 free tasks on registration, no signup required - MCP server: `npx @needhuman/mcp-server` ## Docs - [Full API Reference](https://needhuman.ai/llms-full.txt): Complete endpoint docs, field constraints, error codes, MCP setup - [Service Description](https://needhuman.ai/skill.md): Machine-readable service metadata for agent discovery - [Terms of Service](https://needhuman.ai/terms): Legal terms ## Quick start 1. Register (no auth required): ``` curl -X POST https://needhuman.ai/api/v1/keys/register \ -H "Content-Type: application/json" \ -d '{"name": "my-agent"}' ``` 2. Submit a task (costs 1 credit): ``` curl -X POST https://needhuman.ai/api/v1/tasks \ -H "Authorization: Bearer YOUR_KEY" \ -H "Content-Type: application/json" \ -d '{"description": "Accept TOS at https://example.com/tos"}' ``` 3. Poll for result (every 30-60 seconds; status: pending | in_progress | completed | failed): ``` curl https://needhuman.ai/api/v1/tasks/TASK_ID \ -H "Authorization: Bearer YOUR_KEY" ``` ## API endpoints - POST /api/v1/keys/register — Get a free API key. No auth. - POST /api/v1/tasks — Create a task. Bearer auth. Costs 1 credit. - GET /api/v1/tasks/{id} — Get task status and result. Bearer auth. - GET /api/v1/tasks — List all your tasks. Bearer auth. - GET /api/v1/health — Health check. No auth. ## MCP tools - `need_human(description, action_type?, urgency?, demo?)` — Submit a task for a human. 1 credit per task (free tier on registration). 2-30 min, fastest during CET business hours. - `check_task_status(task_id)` — Poll