ATTENTION: LLM-GENERATED CODE

What is LimeSurvey MCP Server?

A Model Context Protocol (MCP) server that exposes LimeSurvey Remote API functionality as MCP tools. It provides a standardized way to interact with LimeSurvey's survey management capabilities through MCP clients.

How to use LimeSurvey MCP Server?

Install via git clone, npm install, npm build, then npm start. Configure a .env file with LIMESURVEY_API_URL, LIMESURVEY_USERNAME, LIMESURVEY_PASSWORD. By default the server uses stdio transport; set ENABLE_SSE=true for HTTP/SSE on /sse and /messages. Optionally set READONLY_MODE=true to prevent write operations.

Key features of LimeSurvey MCP Server

• Maps 40+ LimeSurvey RemoteControl2 methods to MCP tools.
• Supports survey lifecycle: create, copy, import, activate, delete.
• Manages questions, groups, responses, participants, tokens, and quotas.
• Read‑only and write tools are clearly separated with confirmation requirements.
• Built‑in READONLY_MODE to guard write operations.
• Supports headless survey construction using addSurvey, addGroup, importQuestion.

Use cases of LimeSurvey MCP Server

• Automate survey creation and deployment without the LimeSurvey UI.
• Integrate survey data export into data pipelines or dashboards.
• Manage participant tokens and send invitations or reminders programmatically.
• Perform idempotent survey rebuilds by deleting groups or questions and re‑importing.
• Build custom survey management interfaces on top of MCP clients.

FAQ from LimeSurvey MCP Server

What is READONLY_MODE?

When READONLY_MODE=true is set, all write tools (marked as "write (guarded)" in the API reference) will return an error message without calling LimeSurvey. This prevents accidental modifications.

How can I enable SSE transport for remote use?

Set ENABLE_SSE=true in your .env file. The server then listens on /sse for events and /messages for sending requests, allowing an MCP client to connect over HTTP instead of stdio.

What dependencies does this server require?

It requires Node.js (npm install/build) and access to a running LimeSurvey instance with the RemoteControl API enabled. Credentials must be provided via environment variables.

Do delete tools require confirmation?

Yes. Tools like deleteSurvey, deleteGroup, deleteQuestion, deleteParticipants, deleteQuota, and deleteResponse all require a confirmDeletion: true parameter to execute.

Are all RemoteControl2 methods covered?

The server exposes over 40 methods from the LimeSurvey RemoteControl2 API. Some methods are intentionally skipped (e.g., unstable or undocumented endpoints). Missing methods are listed as not implemented in the API reference table.