Surveymars MCP

The SurveyMars MCP service is an officially provided server for interacting with the SurveyMars survey platform API, supporting the creation, distribution, and analysis of survey questionnaires through MCP clients.

Research and data Marketing #Questionnaire survey #Data analysis #API service #User feedback .Python

rating : 2 points

downloads : 12

update time : 2025-04-29

What is SurveyMars MCP Server?

SurveyMars MCP Server is a bridge service that connects AI assistants with the SurveyMars questionnaire platform. It allows users to directly create, distribute, and analyze questionnaires through AI tools such as Claude and Cursor without manually operating the web interface.

How to use SurveyMars MCP Server?

Simply configure your SurveyMars account information in the supported AI tools, and you can complete questionnaire - related work through natural language instructions. The system will automatically handle technical details, and you only need to focus on the questionnaire content itself.

Applicable scenarios

Suitable for users such as market researchers, product managers, and HR who need to quickly create professional questionnaires. Particularly applicable to: - Customer satisfaction surveys - Employee feedback collection - Product research - Academic research data collection

Main features

Intelligent questionnaire creationAutomatically generate professional questionnaire structures and questions through natural language descriptions

Multi - platform supportCompatible with various AI tools such as Claude Desktop, Cursor, and Windsurf

Analysis integrationAutomatically collect response data and provide visual analysis results

Advantages and limitations

Advantages

A completely free questionnaire platform

Unlimited number of questionnaires, questions, and responses

Create professional questionnaires without technical background

Seamless integration with mainstream AI tools

Limitations

Currently only supports the creation of English questionnaires

Advanced analysis functions need to be completed on the web - side

Windows users need to enable developer mode

How to use

Get account credentials

Install dependencies

Use the following command to install the Python package manager uv

Configure AI tools

Add MCP server settings to the configuration file of tools such as Claude

Usage examples

Hotel satisfaction surveyCreate a hotel satisfaction questionnaire covering dimensions such as cleanliness, service, and facilities

Vehicle purchase journey surveyDesign a questionnaire to track the entire process of customers from research to post - purchase experience

Frequently Asked Questions

Is it necessary to pay for use?

What should Windows users pay attention to?

How to get account credentials?

Related resources

SurveyMars official website

The official questionnaire platform

MCP protocol documentation

Model Context Protocol technical documentation

Installation guide video

MCP server configuration tutorial

🚀 SurveyMars MCP Server

At SurveyMars, our mission is to enable users to quickly and easily gather insights through our powerful 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 users save time and resources, allowing you to focus on leveraging data to drive success. We are committed to continuously improving our platform to meet the evolving needs of users and provide you with the best experience.

This is the official Model Context Protocol (MCP) server for SurveyMars, which enables you to interact with the SurveyMars API. This server allows MCP clients (such as Claude Desktop, Cursor, Windsurf, OpenAI Agents, etc.) to create, distribute, and analyze surveys.

🚀 Quick Start

Quick Start Guide (for Claude Desktop)

Log in to your SurveyMars account from the SurveyMars login page.
Obtain your Account ID and Secret Key in the SurveyMars Account Overview.
Install uv (Python package manager) using the command curl -LsSf https://astral.sh/uv/install.sh | sh or refer to the uv repository for other installation methods.
Navigate to Claude > Settings > Developer > Edit Configuration > claude_desktop_config.json and add the following content:

{
  "mcpServers": {
    "surveymars-mcp": {
      "command": "uvx",
      "args": [
        "surveymars-mcp",
        "--account-id=your-account-id",
        "--secret-key=your-secret-key"
      ]
    }
  }
}

If you are using Windows, you need to enable "Developer Mode" in Claude Desktop to use the MCP server. Click the hamburger icon in the top-left corner of the menu bar and select "Enable Developer Mode".

✨ Features

Components

Tools

survey_create: Create surveys using SurveyMars

💻 Usage Examples

Try asking Claude:

"Help me create a hotel satisfaction survey."
"Create a vehicle purchase journey survey to gather valuable insights from customers at every stage of their entire purchasing process, from their initial research and showroom visits to the final purchase decision and post-purchase satisfaction."

🔧 Technical Details

Development

Build and Release

To prepare the distribution package:

Synchronize dependencies and update the lock file:

uv sync

Build the release version:

uv build

This will create source code and wheel format releases in the dist/ directory. 3. Publish to PyPI:

uv publish

During the publishing process, you need to keep the placeholder {GITHUB_TOKEN} in the command or set your GitHub token through an environment variable.