Qualtrics MCP Server
No description available
Ask AI about Qualtrics MCP Server
Powered by Claude Β· Grounded in docs
I know everything about Qualtrics MCP Server. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
Qualtrics MCP Server
A Model Context Protocol (MCP) server that gives Claude full control over the Qualtrics platform. Build surveys, manage questions, configure logic flows, distribute via email, handle contacts, export responses, and more β all through natural language.
What Can It Do?
53 tools across 8 domains covering the entire Qualtrics API surface:
| Domain | Tools | Capabilities |
|---|---|---|
| Surveys | 8 | Create, list, get, update, delete, activate, deactivate, estimate export size |
| Questions | 7 | Full CRUD + simplified helpers for multiple choice, text entry, and matrix/Likert |
| Blocks | 4 | Create, list, update, delete survey blocks |
| Survey Flow | 7 | Get/update flow, add embedded data, add web services, list fields, piped text reference |
| Responses | 7 | Export (with smart filtering + auto-save), get/create/update/delete individual responses |
| Contacts | 7 | Mailing lists CRUD, individual + bulk contact import, update, remove |
| Distributions | 5 | Email distributions, anonymous links, reminders, list, delete |
| Webhooks | 3 | Event subscriptions for survey lifecycle events |
| Users | 2 | List organization users, get user details |
Survey Management
list_surveysβ List surveys with filtering and paginationget_surveyβ Get survey details, optionally with full definitioncreate_surveyβ Create a new surveyupdate_surveyβ Update name, status, expirationdelete_surveyβ Delete with name confirmation safety checkactivate_survey/deactivate_surveyβ Toggle collectionestimate_export_sizeβ Preview data size before downloading
Question Management
list_questionsβ List all questions with types and previewsget_questionβ Get full question definitioncreate_questionβ Create with full Qualtrics spec (any type/selector)update_questionβ Modify text, choices, validationdelete_questionβ Remove a questionadd_multiple_choice_questionβ Simplified MC creation from a list of choice stringsadd_text_entry_questionβ Simplified TE creation (single/multi/essay)add_matrix_questionβ Simplified Likert/matrix with statements + scale points
Block Management
list_blocks/create_block/update_block/delete_block
Survey Flow & Logic
get_survey_flowβ Full flow tree (blocks, randomizers, branches, embedded data, web services)update_survey_flowβ Replace the entire flowadd_embedded_dataβ Inject embedded data fields into the flowadd_web_serviceβ Call external APIs mid-survey with response-to-field mappinglist_embedded_dataβ List all declared embedded data fieldslist_web_servicesβ List all web service elementspiped_text_referenceβ Look up${e://Field/...},${q://QID.../...}, etc. syntax
Response Export & Data
export_responsesβ Export all responses (auto-saves large files to Downloads)export_responses_filteredβ Export with date ranges, completion filters, question selectioncheck_export_statusβ Poll an in-progress export jobget_response/create_response/update_response/delete_response
Contacts & Mailing Lists
list_mailing_lists/create_mailing_list/delete_mailing_listlist_contactsβ Paginated contact listadd_contact/update_contact/remove_contactbulk_import_contactsβ Import multiple contacts at once
Distributions
list_distributions/get_distribution/delete_distributioncreate_anonymous_linkβ Generate a shareable survey URLcreate_email_distributionβ Send survey invitations to a mailing listcreate_reminderβ Send follow-up reminders for existing distributions
Webhooks
list_webhooks/create_webhook/delete_webhook- Subscribe to events like
completedResponse.{surveyId},controlpanel.activateSurvey, etc.
Users
list_users/get_user
Server Control
set_read_only_modeβ Toggle read-only mode at runtime (blocks all write/update/delete operations)
Setup
Prerequisites
- Node.js 22+
- Qualtrics API token with appropriate permissions
- Qualtrics data center ID
Installation
git clone https://github.com/yrvelez/qualtrics-mcp-server.git
cd qualtrics-mcp-server
pnpm install
Configure environment variables:
cp .env.example .env
# Edit .env with your Qualtrics credentials
Configuration
Set these in your .env file:
| Variable | Required | Default | Description |
|---|---|---|---|
QUALTRICS_API_TOKEN | Yes | β | Your Qualtrics API token |
QUALTRICS_DATA_CENTER | Yes | β | Data center ID (e.g., yul1) |
QUALTRICS_BASE_URL | No | Auto-generated | Custom base URL override |
QUALTRICS_READ_ONLY | No | false | Block all write/delete operations (safe exploration mode) |
RATE_LIMITING_ENABLED | No | true | Enable/disable rate limiting |
RATE_LIMIT_RPM | No | 50 | Requests per minute |
REQUEST_TIMEOUT | No | 30000 | Request timeout in ms |
Read-Only Mode
Set QUALTRICS_READ_ONLY=true to block all write, update, and delete operations. This is useful for safely exploring surveys and exporting data without risk of accidental changes. You can also toggle this at runtime using the set_read_only_mode tool.
Claude Desktop Integration
Add to your claude_desktop_config.json:
{
"mcpServers": {
"qualtrics": {
"command": "npx",
"args": ["tsx", "/path/to/qualtrics-mcp-server/src/index.ts"],
"env": {
"QUALTRICS_API_TOKEN": "your_api_token",
"QUALTRICS_DATA_CENTER": "your_data_center_id"
}
}
}
}
Usage Examples
Once configured, ask Claude things like:
Survey building:
- "Create a survey called 'Customer Satisfaction Q1 2026'"
- "Add a 5-point Likert matrix question measuring service quality"
- "Set up a randomizer that splits participants into two conditions"
- "Add embedded data fields for condition assignment and participant ID"
Data collection:
- "Create a mailing list and import these 50 contacts"
- "Send the survey to my research participants mailing list"
- "Generate an anonymous link for the pre-screen survey"
- "Send a reminder to everyone who hasn't responded yet"
Data export:
- "Export all complete responses from the last 30 days as CSV"
- "How many responses does my survey have? Estimate the export size"
- "Download responses for questions QID1-QID5 only"
Flow & logic:
- "Show me the current survey flow"
- "Add a web service call to my API that sets the stimulus condition"
- "What piped text syntax do I use to reference embedded data?"
Architecture
src/
config/settings.ts β Environment config with Zod validation
services/
qualtrics-client.ts β HTTP client with auth, rate limiting, read-only enforcement
survey-api.ts β Survey + question + block CRUD
flow-api.ts β Survey flow management
response-api.ts β Response export + individual response CRUD
contact-api.ts β Mailing list + contact management
distribution-api.ts β Email distributions + anonymous links
user-api.ts β Organization user lookups
webhook-api.ts β Event subscription management
tools/
survey-tools.ts β Survey MCP tool definitions
question-tools.ts β Question MCP tools (raw + simplified helpers)
block-tools.ts β Block MCP tools
flow-tools.ts β Flow, embedded data, web service, piped text tools
response-tools.ts β Export + individual response tools
contact-tools.ts β Mailing list + contact tools
distribution-tools.ts β Distribution tools
user-tools.ts β User tools
webhook-tools.ts β Webhook tools
_helpers.ts β Shared tool result helpers
index.ts β Tool registry
types/ β TypeScript type definitions
utils/ β File saving utilities
Development
pnpm start # Run the server
pnpm dev # Run with file watching
pnpm typecheck # Type check with tsgo
Troubleshooting
| Problem | Solution |
|---|---|
"Unexpected token 'Q'" | Ensure no console.log statements interfere with MCP JSON protocol |
"Read-only file system" | Use absolute paths or let auto-save write to Downloads |
| Large file timeouts | Use export_responses_filtered with date ranges and questionIds |
| Rate limit errors | Built-in rate limiting handles this automatically; reduce RATE_LIMIT_RPM if needed |
License
MIT
