Human Survey

Name: Human Survey
Author: sunsiyuan

by sunsiyuancommunityv0.1.0

HumanSurvey is a minimal API and MCP server that allows AI agents to collect structured feedback from groups of humans and retrieve machine-usable results.

From the registry: Feedback collection for AI agents. Create surveys, collect responses, get results.

GitHub Repository

Install & configure

Prerequisites

optional
HumanSurvey API key
Self-provision via the create_key MCP tool, or POST to https://www.humansurvey.co/api/keys
https://www.humansurvey.co/docs

Install in your client

Paste into the AI you're chatting with — it will figure out the rest

Please install the `human-survey` MCP server into my current AI client (that's you).

Optional prerequisites:
- HumanSurvey API key — Self-provision via the create_key MCP tool, or POST to https://www.humansurvey.co/api/keys (https://www.humansurvey.co/docs)

Canonical MCP server config (stdio transport):
- command: `npx`
- args: ["-y","humansurvey-mcp"]
- required environment variables:
  - `HUMANSURVEY_API_KEY`: HumanSurvey API key (starts with hs_sk_). Can be self-provisioned via create_key tool. (example: `<your-api-key>`)

Note: Hosted backend at humansurvey.co. API key is required once surveys are created; can be self-provisioned via the no-auth create_key tool.

Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.

Note: Hosted backend at humansurvey.co. API key is required once surveys are created; can be self-provisioned via the no-auth create_key tool.

Tools (5)

create_key

Self-provision an API key; no human setup required.

create_survey

Create a survey from JSON schema with optional parameters.

get_results

Retrieve aggregated results and raw responses.

list_surveys

List surveys owned by your API key.

close_survey

Close a survey immediately.

Environment variables

HUMANSURVEY_API_KEYrequiredAPI key for authenticating requests.

Packages

humansurvey-mcp

npmv0.1.0transport: stdio

Details

Language: TypeScript
License: MIT
Released: Apr 7, 2026
Last commit: Aug 1, 2026
Registry name: io.github.sunsiyuan/human-survey

Related Servers

Labelhead Artist Momentum

Trending hip-hop artist momentum scores across four cultural dimensions.

78.5k

PostHog MCP Server

Official PostHog MCP Server for product analytics, feature flags, experiments, and more.

37.7k

Openmetadata Mcp

Official OpenMetadata MCP: governed context and business semantics for AI assistants and agents.

14.9k