SurveyMars MCP Server

At 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 server that enables interaction with SurveyMars APIs. This server allows MCP clients like , , , 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`