NeedHuman MCP Server
by mariusaureio.github.MariusAure/needhuman-mcpv0.3.2
MCP server for NeedHuman — Human-as-a-Service API for AI agents. When your agent needs a real human (accept ToS, create accounts, verify identity), it calls NeedHuman.
context tax
queued
security
queued
cold start
queued
freshness
Stale7mo ago
Install NeedHuman MCP server
Install in Claude Code
claude mcp add needhuman -e NEEDHUMAN_API_KEY='<needhuman-api-key>' -- npx -y @needhuman/mcp-serverInstall in Cursor
{
"mcpServers": {
"needhuman": {
"command": "npx",
"args": [
"-y",
"@needhuman/mcp-server"
],
"env": {
"NEEDHUMAN_API_KEY": "<needhuman-api-key>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"needhuman": {
"command": "npx",
"args": [
"-y",
"@needhuman/mcp-server"
],
"env": {
"NEEDHUMAN_API_KEY": "<needhuman-api-key>"
}
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"needhuman": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@needhuman/mcp-server"
],
"env": {
"NEEDHUMAN_API_KEY": "<needhuman-api-key>"
}
}
}
}Add to .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"needhuman": {
"command": "npx",
"args": [
"-y",
"@needhuman/mcp-server"
],
"env": {
"NEEDHUMAN_API_KEY": "<needhuman-api-key>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| NEEDHUMAN_API_KEY | yes | yes | Your NeedHuman API key. Self-register for free (3 tasks): curl -X POST https://needhuman.ai/api/v1/keys/register -H 'Content-Type: application/json' -d '{"name":"my-agent"}' |
| NEEDHUMAN_API_URL | — | — | API base URL. Defaults to https://needhuman.ai |
Remote endpoints
- streamable-http
https://needhuman.ai/mcp
Freshness
Stale — last maintenance signal 7mo ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-03-18 · 7mo ago · GitHub
Latest release
2026-03-18 · 7mo ago · GitHub · v0.3.2
Package published
no data · npm/PyPI
Registry entry updated
2026-03-09 · 7mo ago · official registry · v0.3.2
FAQ
›How do I install the NeedHuman MCP server in Claude Code?
Run: claude mcp add needhuman -e NEEDHUMAN_API_KEY='<needhuman-api-key>' -- npx -y @needhuman/mcp-server. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does NeedHuman require an API key?
Yes. It expects NEEDHUMAN_API_KEY, of which 1 is a secret.
›Can I use NeedHuman as a remote (hosted) MCP server?
Yes — it offers both a hosted endpoint and a local stdio package.
›Is NeedHuman in the official MCP registry?
Yes, as io.github.MariusAure/needhuman-mcp.