surveymars-mcp

SurveyMars MCP Server

At SurveyMars 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 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.

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