SurveyMars MCP Server
About
Official SurveyMars Model Context Protocol (MCP) server that enables interaction with SurveyMars APIs. This server allows MCP clients like Claude Desktop, Cursor, Windsurf, OpenAI Agents and others to create, distribute, and analyze surveys.
Details
- Author
- surveymars
- Downloads
- 319
- Categories
- AI
Jump to
- Create surveys programmatically via the survey_create tool.
- Integrates with Claude Desktop, Cursor, Windsurf, and
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
SurveyMars MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Obtain your SurveyMars Account ID and Secret Key from your account summary page. Install uv, then configure your MCP client (e.g., Claude Desktop) with the command uvx surveymars-mcp and the arguments --account-id=your-account-id --secret-key=your-secret-key. After setup, you can ask natural language questions like “create a hotel satisfaction survey” to generate surveys.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"surveymars mcp server": {
"surveymars-mcp": {
"command": "uvx",
"args": [
"surveymars-mcp",
"--account-id=your-account-id",
"--secret-key=your-secret-key"
]
}
}
}
}McpServers
{
"surveymars-mcp": {
"command": "uvx",
"args": [
"surveymars-mcp",
"--account-id=your-account-id",
"--secret-key=your-secret-key"
]
}
}SurveyMars MCP Server
At <a href="https://surveymars.com">SurveyMars</a> our mission is to make it easy for our users to gather insights quickly and effortlessly through our powerful and completely free survey platform. With unlimited surveys, questions, responses, and advanced analytics tools, you can create, distribute, and analyze surveys in minutes, without any technical expertise or budget.
Our goal is to help our users save time and resources, so you can focus on what matters most: using data to drive success. We are dedicated to continuously improving our platform to meet the evolving needs of our users, and to providing you with the best possible experience.
Official SurveyMars <a href="https://github.com/modelcontextprotocol">Model Context Protocol (MCP)</a> server that enables interaction with SurveyMars APIs. This server allows MCP clients like <a href="https://www.anthropic.com/claude">Claude Desktop</a>, <a href="https://www.cursor.so">Cursor</a>, <a href="https://codeium.com/windsurf">Windsurf</a>, <a href="https://github.com/openai/openai-agents-python">OpenAI Agents</a> and others to create, distribute, and analyze surveys.
Components
Tools
- survey_create: Create survey with SurveyMars
Quickstart with Claude Desktop
1. Login to your SurveyMars account from SurveyMars Login
2. Get your Account ID and Secret Key from SurveyMars Account Summary.
3. Install uv (Python package manager), install with curl -LsSf https://astral.sh/uv/install.sh | sh or see the uv repo for additional install methods.
4. Go to Claude > Settings > Developer > Edit Config > claude_desktop_config.json to include the following:
{
"mcpServers": {
"surveymars-mcp": {
"command": "uvx",
"args": [
"surveymars-mcp",
"--account-id=your-account-id",
"--secret-key=your-secret-key"
]
}
}
}
If you're using Windows, you will have to enable "Developer Mode" in Claude Desktop to use the MCP server. Click "Help" in the hamburger menu at the top left and select "Enable Developer Mode".
Example usage
Try asking Claude:
- "Help me create a questionnaire for a hotel satisfaction survey"
- "Create a vehicle purchase journey survey to gather valuable insights from customers at every stage of their journey, from their initial research and showroom visit, to their final purchase decision and post-sale satisfaction."
Development
Building and Publishing
To prepare the package for distribution:
1. Sync dependencies and update lockfile:
uv sync
2. Build package distributions:
uv build
This will create source and wheel distributions in the dist/ directory.
3. Publish to PyPI:
uv publish
Note: You'll need to set PyPI credentials via environment variables or command flags:
- Token: --token or UV_PUBLISH_TOKEN
- Or username/password: --username/UV_PUBLISH_USERNAME and --password/UV_PUBLISH_PASSWORD
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
