NeedHuman MCP (@needhuman/mcp-server)

Name: NeedHuman MCP (@needhuman/mcp-server)
Author: MariusAure

@MariusAure

NeedHuman MCP (@needhuman/mcp-server) について

Human-as-a-Service MCP server for AI agents. When your agent needs a real human (accept ToS, create accounts, verify identity), POST a task and a person handles it. 3 free tasks.

基本情報

カテゴリ

その他

ライセンス

MIT

ランタイム

node

公開者

MariusAure

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

{
  "mcpServers": {
    "needhuman": {
      "command": "npx",
      "args": [
        "-y",
        "@needhuman/mcp-server"
      ],
      "env": {
        "NEEDHUMAN_API_KEY": "YOUR_KEY"
      }
    }
  }
}

ツール

Submit a task for a human to complete. Returns a task ID.

Poll a task by ID. Returns status, result, and proof.

List all tasks for the current API key.

概要

What is NeedHuman MCP Server (@needhuman/mcp-server)?

An MCP server for NeedHuman — a Human-as-a-Service API that lets AI agents delegate tasks requiring a real human with a browser. When an agent hits a step it cannot complete alone (e.g., accepting terms of service, creating an account, verifying identity, submitting web forms), it calls NeedHuman and a human completes the task.

How to use NeedHuman MCP Server (@needhuman/mcp-server)?

Connect via remote HTTP (Streamable HTTP, no install), local stdio using npx -y @needhuman/mcp-server, or a one‑line install script. Obtain a free API key (3 tasks, no signup) with curl -X POST https://needhuman.ai/api/v1/keys/register. Use the need_human tool to submit a task, check_task_status to poll results, and list_tasks to view all tasks.

Key features of NeedHuman MCP Server (@needhuman/mcp-server)

Human‑as‑a‑Service for AI agents
Submit tasks requiring a real human with a browser
Poll for task status, result, and proof
Three installation options: HTTP, npx, one‑line script
Free tier: 3 tasks per API key, no signup
REST API available for non‑MCP agent frameworks

Use cases of NeedHuman MCP Server (@needhuman/mcp-server)

Accept terms of service on websites that block automated requests
Create user accounts or complete sign‑up flows
Complete identity verification steps requiring manual input
Submit complex web forms that require human judgment
Any browser‑based step that an AI agent cannot perform alone

FAQ from NeedHuman MCP Server (@needhuman/mcp-server)

How do I get an API key?

Run curl -X POST https://needhuman.ai/api/v1/keys/register -H "Content-Type: application/json" -d '{"name": "my-agent"}'. The key is free for 3 tasks with no signup required.

What are the coverage hours and response times?

Tasks are completed by the founders weekdays during CET business hours, best‑effort evenings. Typical response time is 2–30 minutes during coverage; tasks with expiring links (under 30 min TTL) may time out.

Can I use NeedHuman without MCP?

Yes. The REST API works with any agent framework. Submit a task with curl -X POST https://needhuman.ai/api/v1/tasks -H "Authorization: Bearer YOUR_KEY" -d '{"description": "..."}' and poll for results.

What tasks are not accepted?

Tasks requiring credential storage, persistent login sessions, or financial transactions are explicitly not accepted.

How is my data handled?

Task descriptions are stored and read by the founder to complete the task. API traffic is HTTPS, and API keys are stored hashed. Do not include passwords, card numbers, or confidential