SurveyMars Interoperability Module (MCP Server)

At SurveyMars, our core directive is to simplify the acquisition of crucial insights for our user base, making the process swift and frictionless via our robust, entirely complimentary platform. Leveraging limitless capacity for surveys, questions, and responses, alongside sophisticated analytical instrumentation, users can swiftly architect, deploy, and interpret surveys without prerequisite technical proficiency or capital investment.

Our primary objective is the conservation of user time and operational expenditure, allowing for heightened focus on leveraging empirical data to stimulate organizational advancement. We maintain a commitment to perpetual platform enhancement to align with the dynamic requirements of our clientele and to guarantee an optimal operational experience.

This official SurveyMars Model Context Protocol (MCP) backend facilitates seamless integration with the proprietary SurveyMars Application Programming Interfaces. This server empowers various MCP clients, such as Claude Desktop, Cursor, Windsurf, OpenAI Agents, and others, to programmatically formulate survey instruments, manage distribution channels, and execute comprehensive data analysis.

Functional Units

Available Capabilities

• survey_create: Orchestrates the generation of a new survey construct within the SurveyMars ecosystem.

Initial Configuration for Claude Desktop

1. Authenticate within your SurveyMars workspace via the SurveyMars Login Portal.
2. Retrieve your unique Account ID and corresponding Secret Key from the SurveyMars User Management Center.
3. Install the uv utility (Python dependency manager). Installation command: curl -LsSf https://astral.sh/uv/install.sh | sh, or consult the uv official repository for alternative installation routes.
4. Modify the configuration file located at Claude > Settings > Developer > Edit Config > claude_desktop_config.json to incorporate the following JSON structure:

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

If operating on a Windows environment, ensure that "Developer Mode" is activated within the Claude Desktop application to enable MCP server functionality. This is accomplished by navigating to "Help" in the top-left hamburger menu and selecting "Enable Developer Mode".

Illustrative Scenarios

Engage Claude with prompts such as:

• "I require assistance designing a questionnaire intended for assessing guest satisfaction with a hospitality establishment."
• "Develop a structured inquiry instrument mapping the complete consumer acquisition path for automotive purchases, designed to capture critical data points from the initial exploratory phase, through dealership engagement, to the final transaction and subsequent post-purchase feedback."

Development Lifecycle

Fabrication and Dissemination

To prepare the software package for public availability:

1. Synchronize required dependencies and update the resolution manifest:

uv sync

1. Compile the distribution artifacts:

uv build

This action generates source and wheel distribution files within the dist/ directory.

1. Deploy to the Python Package Index (PyPI):

uv publish

Observation: PyPI authentication prerequisites necessitate setting relevant environment variables or supplying command-line parameters: - Authentication Token: Utilize the --token flag or the UV_PUBLISH_TOKEN environment variable. - Alternatively, credentials can be supplied via username/password: --username/UV_PUBLISH_USERNAME and --password/UV_PUBLISH_PASSWORD.