Official description7 sourcesMCP servers8d ago

MariusAure/needhuman-mcp

Human-as-a-service for AI agents: hand task

View on GitHub ↗Direct link · no redirect page

Config template (adjust for your client)

claude mcp add needhuman-mcp -- npx -y needhuman-mcp

A pasteable skeleton generated from the repository name. Check the project README for the exact package and arguments.

Star count: 1 ★ · MariusAure/needhuman-mcp · read from the repository page · (checked 2026-10-16 20:00:20)
Source: collected from the punkpeye/awesome-mcp-servers list · type: MCP server
Harvest history: first seen 2026-10-09 · last seen 2026-10-16 · seen 32× · listed by 7 sources
Score: score 703 · 1 ★ · 7 sources · mcp

FAQ (answers come from our records)

How do I install it?

We did not find an install command for this repository (our install coverage is only about 4%). Check its README or releases page.

Who is it for?

We filed it under these tags: MCP 服务. The tags come from the entry itself, not a taxonomy we imposed.

Who maintains it?

repository MariusAure/needhuman-mcp；first catalogued 2026-10-09；last seen 2026-10-16。There is no official certification or quality rating here — we record sources and dates only.

Third-party quality signals

NeedHuman MCP Server

以下摘录自该仓库的 README（片段） · 在 GitHub 读完整 README →

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.