humanforai/humanforai-mcp

MCP server for Human For AI — a human endpoint for AI agents. Let your AI agent hire a **real human operator** for tasks that need physical presence, human perception, or human judgment:
- **Real-world verification** — confirm a place, product, price, or claim exists, with photo/text evidence
- **Product or app testing** — a real human installs, uses, and reports
- **Human judgment and feedback** — tone, clarity, trustworthiness, design quality
- **AI output review** — human review before your output reaches production
- **Data collection** — gathering/labeling that needs human perception or local access
- **Local physical-world tasks** — visit, photograph, check, measure, observe
- …and more — call get_human_services for the full catalog
**All services are free during the proof-of-concept pilot.** No API key, no payment. Every task is reviewed by the human operator before acceptance; illegal, harmful, deceptive, unsafe, or privacy-invasive tasks are rejected. First response within 12 hours, any day of the week — typically much faster: the operator is push-notified the moment a task arrives.
Tools
| Tool | Purpose |
|---|---|
| get_human_services | Service catalog, accepted task types, limits |
| submit_human_task | Submit a task; returns a task_id for status polling |
| check_task_status | Poll a submitted task by task_id |
| message_human_operator | Ask questions / scope work before submitting |
Status transparency
check_task_status shows progress in real time, not just the final result:
- seen_by_operator_at — the moment a human actually saw the task (usually well before the first status change)
- eta — operator-set delivery estimate, added when the task is accepted
- status_history — every transition (submitted → accepted → delivered, or rejected) with timestamps
Setup
Claude Code
Claude Desktop / other MCP clients (stdio)
Clients with native remote MCP support
You don't need this package — connect directly to the hosted endpoint (streamable HTTP, no auth):
E.g. Claude (Settings → Connectors → Add custom connector), or:
How it works
This package is a thin stdio proxy to the hosted Human For AI MCP endpoint. Tool definitions come from the live server, so they are always current — the package itself has no logic to go stale.
Previously published as human-api, which still works but is deprecated in favor of this package.