Humansurvey MCP Server

by sunsiyuanio.github.sunsiyuan/human-surveyv1.2.0

Feedback collection for AI agents: create surveys from JSON schema, collect structured responses from groups of people and retrieve aggregated results.

1Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Maintained2mo ago

Install Humansurvey MCP server

claude mcp add humansurvey -e HUMANSURVEY_API_KEY='<humansurvey-api-key>' -- npx -y humansurvey-mcp

{
  "mcpServers": {
    "humansurvey": {
      "command": "npx",
      "args": [
        "-y",
        "humansurvey-mcp"
      ],
      "env": {
        "HUMANSURVEY_API_KEY": "<humansurvey-api-key>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "humansurvey": {
      "command": "npx",
      "args": [
        "-y",
        "humansurvey-mcp"
      ],
      "env": {
        "HUMANSURVEY_API_KEY": "<humansurvey-api-key>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "humansurvey": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "humansurvey-mcp"
      ],
      "env": {
        "HUMANSURVEY_API_KEY": "<humansurvey-api-key>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "humansurvey": {
      "command": "npx",
      "args": [
        "-y",
        "humansurvey-mcp"
      ],
      "env": {
        "HUMANSURVEY_API_KEY": "<humansurvey-api-key>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
HUMANSURVEY_API_KEY	yes	yes	Your HumanSurvey API key (starts with hs_sk_). Get one at https://www.humansurvey.co

Freshness

Maintained — last maintenance signal 2mo ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-08-01 · 2mo ago · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-08-01 · 2mo ago · official registry · v1.2.0

FAQ

›How do I install the Humansurvey MCP server in Claude Code?

Run: claude mcp add humansurvey -e HUMANSURVEY_API_KEY='<humansurvey-api-key>' -- npx -y humansurvey-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Humansurvey require an API key?

Yes. It expects HUMANSURVEY_API_KEY, of which 1 is a secret.

›Can I use Humansurvey as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Humansurvey in the official MCP registry?

Yes, as io.github.sunsiyuan/human-survey.