NeedHuman
Delegate verification, judgment, or physical-world tasks your agent cannot finish by posting structured jobs to real humans via NeedHuman from MCP.
Overview
NeedHuman is an MCP server for the Grow phase that lets agents delegate tasks requiring real humans and retrieve results through the NeedHuman API.
What is this MCP server?
- Human-as-a-Service API exposed as MCP tools for agent delegation
- Remote https://needhuman.ai/mcp plus npm @needhuman/mcp-server stdio package (v0.3.2)
- Bearer auth; self-register via POST /api/v1/keys/register for free tier (3 tasks)
- NEEDHUMAN_API_KEY and optional NEEDHUMAN_API_URL for local stdio runs
- Closes the gap when agents need eyes, judgment, or real-world action
- Package and server version 0.3.2
- Free self-registration includes 3 tasks per documented registration flow
- Dual transport: streamable-http remote and npm stdio @needhuman/mcp-server
What problem does it solve?
Agent workflows break when they need human judgment or real-world actions but you have no MCP-native way to request and track that work.
Who is it for?
Indie builders prototyping agents that need occasional human fallback for QA, research checks, or operational errands with API-tracked outcomes.
Skip if: Teams needing 24/7 dedicated staff, regulated in-house processing only, or large-volume BPO with custom SLAs not covered by the public API.
What do I get? / Deliverables
After you register an API key and add the remote or npm stdio MCP server, your agent can create human tasks and pull completions back into the same session.
- MCP tool flows that create and track human-completed tasks
- Optional stdio or hosted HTTP integration for agent products needing escalation
Recommended MCP Servers
Journey fit
Human-in-the-loop work shows up when you are growing and operating a product—customer edge cases, manual checks, and ops escalations—not during pure local coding. Support is the canonical shelf because the service is framed as completing tasks only humans can do when automation stalls.
How it compares
Human task delegation MCP integration, not an agent skill that teaches customer support copywriting.
Common Questions / FAQ
Who is NeedHuman for?
Solo developers and agent builders who use MCP hosts and need a structured API to send work to humans when models or scripts are not enough.
When should I use NeedHuman?
Use it during grow and support workflows when automated agents must escalate to a person for verification, subjective decisions, or tasks that require a human in the loop.
How do I add NeedHuman to my agent?
Self-register with curl POST https://needhuman.ai/api/v1/keys/register, then either configure the streamable-http remote https://needhuman.ai/mcp with Authorization Bearer token or install npm @needhuman/mcp-server with NEEDHUMAN_API_KEY for stdio.