Skip to content
MCP server

Survey MCP Server

MCP server for conducting dynamic, conversational surveys with structured data collection.

Install
Pricing
Open source
Runs
Locally or Remotely
Version
1.0.6
Listing updated
4 days ago

About Survey MCP Server

Survey MCP Server is an open-source MCP server. It can run locally on your machine or as a hosted remote server.

Install

Run in a terminal

claude mcp add survey-mcp-server -- npx -y @cyanheads/survey-mcp-server

Add to claude_desktop_config.json

{
  "mcpServers": {
    "survey-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/survey-mcp-server"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "survey-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/survey-mcp-server"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "survey-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/survey-mcp-server"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "survey-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/survey-mcp-server"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "survey-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/survey-mcp-server"
      ]
    }
  }
}

Configuration

  • MCP_LOG_LEVELSets the minimum log level for output (e.g., 'debug', 'info', 'warn').
  • SURVEY_DEFINITIONS_PATHPath to the directory containing survey definition files.
  • SURVEY_RESPONSES_PATHPath to the directory where survey responses are stored.
  • MCP_HTTP_HOSTThe hostname for the HTTP server.
  • MCP_HTTP_PORTThe port to run the HTTP server on.
  • MCP_HTTP_ENDPOINT_PATHThe endpoint path for the MCP server.
  • MCP_AUTH_MODEAuthentication mode to use: 'none', 'jwt', or 'oauth'.
  • MCP_LOG_LEVELSets the minimum log level for output (e.g., 'debug', 'info', 'warn').
  • SURVEY_DEFINITIONS_PATHPath to the directory containing survey definition files.
  • SURVEY_RESPONSES_PATHPath to the directory where survey responses are stored.

Pricing

Open source

Survey MCP Server FAQ

Is Survey MCP Server free?

Yes. Survey MCP Server is open source, so you can use and self-host it for free.

How do I add Survey MCP Server to Claude Code?

Run this command in your terminal: claude mcp add survey-mcp-server -- npx -y @cyanheads/survey-mcp-server