HumanSurvey
Website: humansurvey.co · Docs: humansurvey.co/docs · FAQ: humansurvey.co/faq
Feedback collection infrastructure for AI agents.
HumanSurvey lets an agent doing long-horizon work collect structured feedback from a group of people:
Agent is doing a job
→ needs structured feedback from a group
→ creates survey from JSON schema
→ shares /s/{id} URL with respondents
→ humans respond over hours or days
→ agent retrieves structured JSON results and acts on themWhat is this?
HumanSurvey is a minimal API and MCP server for one narrow job: let agents collect structured feedback from groups of humans and get machine-usable results back.
It is designed for:
- AI agents running event management, product launches, or community workflows that need to survey a group
- Developers building agent products that need a lightweight feedback-collection primitive
It is not designed for:
- survey dashboards
- visual form builders
- template libraries
- email campaigns
- analytics/reporting UI
Features
- JSON schema input — structured, precise, and directly machine-generated
- MCP server — create surveys and read results directly from Claude Code
- Minimal API surface — authenticated creator routes, public respondent submission
- Four semantic question types —
choice,text,scale,matrix - Conditional logic —
showIfin Markdown and JSON schema - Explicit lifecycle — close surveys, expiry, and max response limits
