Survey Mcp Server
Turns Claude into a conversational survey conductor with session management, conditional logic, and structured data collection. You get eight tools spanning the full lifecycle: list available surveys, start sessions with initial question suggestions, submit responses with validation and scoring, check progress against completion requirements, and export results as CSV or JSON. The server handles skip logic automatically, can resume interrupted sessions, and supports multi-tenancy with pluggable storage backends. Reach for this when you need LLM-driven interviews that adapt based on previous answers, track completion state, and collect structured data you can actually analyze. Built on the MCP SDK with TypeScript, supports both stdio and HTTP transports.
- GitHub stars
- 4
- tools
- 8
- transport
- STDIO, HTTP
- env vars
- 7
- last updated
- Oct 16, 2025
Tools
8 toolsPublic tool metadata for what this MCP can expose to an agent.
survey_list_availableDiscover available surveys in the definitions directory.
Discover available surveys in the definitions directory.
No parameter schema in public metadata yet.
survey_start_sessionInitialize a new session with complete survey context, all questions, and initial suggested questions.
Initialize a new session with complete survey context, all questions, and initial suggested questions.
No parameter schema in public metadata yet.
survey_get_questionRefresh a specific question's eligibility status after state changes (useful for conditional logic).
Refresh a specific question's eligibility status after state changes (useful for conditional logic).
No parameter schema in public metadata yet.
survey_submit_responseRecord participant answers with validation, scoring, returning updated progress and next suggested questions.
Record participant answers with validation, scoring, returning updated progress and next suggested questions.
No parameter schema in public metadata yet.
survey_get_progressCheck completion status, current score, remaining required/optional questions, and completion eligibility.
Check completion status, current score, remaining required/optional questions, and completion eligibility.
No parameter schema in public metadata yet.
survey_complete_sessionFinalize a completed session with final score summary (requires all required questions answered).
Finalize a completed session with final score summary (requires all required questions answered).
No parameter schema in public metadata yet.
survey_export_resultsExport session data in CSV or JSON format with optional filtering by status, date range, etc.
Export session data in CSV or JSON format with optional filtering by status, date range, etc.
No parameter schema in public metadata yet.
survey_resume_sessionResume an incomplete session, restoring full context including answered questions and progress.
Resume an incomplete session, restoring full context including answered questions and progress.
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageConfiguration
MCP_LOG_LEVELdefault: infoSets the minimum log level for output (e.g., 'debug', 'info', 'warn').
SURVEY_DEFINITIONS_PATHdefault: ./surveysPath to the directory containing survey definition files.
SURVEY_RESPONSES_PATHdefault: ./storage/responsesPath to the directory where survey responses are stored.
MCP_HTTP_HOSTdefault: 127.0.0.1The hostname for the HTTP server.
MCP_HTTP_PORTdefault: 3010The port to run the HTTP server on.
MCP_HTTP_ENDPOINT_PATHdefault: /mcpThe endpoint path for the MCP server.
MCP_AUTH_MODEdefault: noneAuthentication mode to use: 'none', 'jwt', or 'oauth'.
Readme
@cyanheads/survey-mcp-server
Transform LLMs into intelligent interviewers. A production-grade MCP server for conducting dynamic, conversational surveys with structured data collection. Features skip logic, session resume, multi-tenancy, and pluggable storage backends.
Details
- Repository
- github.com/cyanheads/survey-mcp-server
- Category
- Data & Analytics
- Package
@cyanheads/survey-mcp-server- Transport
- STDIO, HTTP
- Registry
- MCP registry, active
More from cyanheads
- Mcp Ts Template145
- nist-nvd-mcp-server
- open-meteo-mcp-server
- openfda-mcp-server
- wikipedia-mcp-server
- census-mcp-server
- crossref-mcp-server
- eur-lex-mcp-server
- faostat-mcp-server
- fema-mcp-server
- libofcongress-mcp-server
- openfoodfacts-mcp-server
- orcid-mcp-server
- reference-data-mcp-server
- usaspending-mcp-server
- arxiv-mcp-server
- exchange-rates-mcp-server
- openlibrary-mcp-server
- protein-mcp-server
- Pubmed Mcp Server167
- Clinicaltrialsgov Mcp Server100
- Openalex Mcp Server17
- Faostat Mcp Server3
- National Parks Mcp Server3
Related Data & Analytics MCP servers
View all
Unlinkedlarsbaunwall/unlinkedYour LinkedIn profile and recent activity as JSON, via CLI or MCP server (EEA and Switzerland only).4stars
Qrz Mcpqso-graph/qrz-mcpQRZ.com MCP server. Callsign lookup, DXCC resolution, logbook queries via QRZ XML API.4stars
ASAM ODS odsbox jaquel MCP Servertotonga/odsbox-jaquel-mcpMCP server for ASAM ODS with Jaquel query tools, connection management, and data access4stars
Hithereiamaliff Mcp Datagovmyhithereiamaliff/mcp-datagovmyThis MCP server provides seamless access to Malaysia's government open data, including datasets, w…3stars
Datos Gob Do Mcp Serveralcastaro/datos.gob.do-mcp-serverMCP server for datos.gob.do — Dominican Republic open government data (CKAN 2.11).3stars
Xmlriver Mcpartgas1/xmlriver-mcpGoogle/Yandex SERP parsing and Yandex Wordstat keyword frequency via XMLRiver XML API3stars