List one Qualtrics-managed page of surveys with optional name filtering; use nextPage to continue

Get detailed information about a specific survey

Create a new survey in Qualtrics

Estimate export size from the survey's question count and an optional expected response count. Qualtrics survey metadata does not expose response totals, so omitting expectedResponseCount returns an honest per-response estimate.

Update survey metadata such as name, active status, or expiration

Delete a survey. Requires name confirmation as a safety measure.

Activate a survey to begin collecting responses

Deactivate a survey to stop collecting responses

List all questions in a survey with their types and a preview of the question text

Get the full definition of a specific question including choices, validation, and configuration

Create a question in a survey block with full payload control. For Matrix questions: Choices = rows/statements, Answers = columns/scale points (both required). Use additionalFields to pass any other Qualtrics question-definition fields (e.g., a template from get_question_template). For common types, prefer the add_*_question helpers.

Update an existing question. Performs a safe partial update: fetches the current definition and carries all fields forward, so only the fields you pass change. For Matrix questions, choices = rows and answers = columns.

Remove a question from a survey

Simplified helper to create a multiple choice question. Automatically maps to the correct Qualtrics QuestionType/Selector.

Simplified helper to create a text entry question (single line, multi line, or essay).

Simplified helper to create a descriptive text (DB/TB) question — commonly used for instructions, processing screens, or HTML content with optional JavaScript.

Simplified helper to create a single-item Likert scale as MC/SAVR. Includes preset scales so you don't have to enumerate choices manually.

Simplified helper to create a matrix question. Choices = rows/statements, Answers = columns/scale points. Defaults to a Likert single-answer matrix; use selector/subSelector for variants (e.g., selector 'CS' + subSelector 'WOTB' for matrix constant sum). Statements may be objects to enable an inline text-entry box on individual rows (e.g., an 'Other (please specify)' row).

Simplified helper to create a rank order question where respondents rank a list of items.

Simplified helper to create a constant sum question where respondents allocate values across items (e.g., percentages summing to 100). The default Choices/text-entry variation works in the New Survey Taking Experience; bars and slider variations require the legacy experience.

Get a question's full definition stripped of server-generated fields, ready to reuse as a create_question template (pass it via additionalFields). Best way to replicate complex question types (side-by-side, sliders, heatmaps): build one in the Qualtrics UI, then clone it via the API.

List all blocks in a survey

Get a block's complete definition, including question order, skip logic, randomization, loop-and-merge, and navigation options

Create a new block. Supports complete Qualtrics block definitions for reference blocks, question ordering, skip logic, randomization, and loop-and-merge.

Safely update part of a block definition. The current block is fetched and carried forward because Qualtrics PUT replaces the complete block. Supports question ordering, skip logic, randomization, and loop-and-merge.

Remove a block from a survey

Export survey responses in JSON or CSV format. IMPORTANT: This tool will automatically save large exports to a local file to avoid context limits. Small exports may be returned directly. For better control over data size, consider using 'export_responses_filtered' with date ranges, specific questions, or a saved Qualtrics filter.

Check the status of a response export job

Download a completed response export using the fileId returned by check_export_status. Saves large files automatically and can save any export to a requested filename.

Export survey responses with documented Qualtrics filters to reduce data size. Use date bounds, a saved Qualtrics filter, question selection, or inclusion of responses still in progress. Large exports will be automatically saved to your Downloads folder.

Get a single survey response by its response ID

Import/create a response for a survey programmatically

Start a Qualtrics job to update embedded data on one existing survey response. The public API does not support rewriting recorded answer values through this operation; use create_response or response import for answer data.

Delete a survey response

List one cursor-paginated page of distributions for a survey, with optional documented Qualtrics filters

Get detailed information about a specific distribution including delivery stats

Get per-recipient delivery history for an email distribution (sent, opened, bounced, blocked, responded), including the contactLookupId that ties each row back to a contact. This is the documented way to recover respondent identity for individual-link distributions after the fact.

List one page of generated individual survey links. WARNING: Qualtrics documents that this GET can update contact-frequency state and reset email-status dates when used on other distribution types, so the distributions write scope is required.

Look up the survey's BrandBaseURL and return its canonical anonymous survey-taking URL. Qualtrics anonymous links do not require creating a distribution; this tool performs no API write.

Send a survey via email to a mailing list

Delete a distribution

Send a reminder for an existing email distribution

Send or schedule a thank-you email for respondents in an existing email distribution

List the XM Directories (contact pools) available to this account. Use this first to discover the directoryId (POOL_...) that every mailing-list and contact tool requires.

List one cursor-paginated page of mailing lists in an XM Directory

Get complete metadata for a mailing list

Update the name or owner of an XM Directory mailing list

Create a new mailing list for contact management and survey distribution

Delete a mailing list

List one cursor-paginated page of contacts in an XM Directory mailing list

Get detailed information for one contact in an XM Directory mailing list

Add a single contact to a mailing list

Update an existing contact in a mailing list

Remove a contact from this mailing list only; the contact remains in the XM Directory

Create multiple contacts through the documented single-contact endpoint, returning per-contact successes and failures (non-atomic)

List users in your Qualtrics organization

Get detailed information about a specific user

List all event subscriptions (webhooks) in your Qualtrics account

Create an event subscription (webhook) to receive notifications for Qualtrics events

Delete an event subscription (webhook)

Get the full survey flow tree showing the order of blocks, embedded data, web services, branching, and randomization

Replace the entire survey flow tree. Use get_survey_flow first to get the current flow, modify it, then pass the full tree back.

Insert any Qualtrics flow element (Block, Branch, Group, BlockRandomizer, EmbeddedData, WebService, EndSurvey, Authenticator, etc.) at an exact position. Allocates a collision-free FlowID when one is not supplied.

Update one flow element by FlowID. By default this fetches and carries forward the existing definition so omitted fields are preserved, then writes the normalized complete flow tree.

Move an existing flow element anywhere in the top-level or nested flow while preserving its definition and FlowID.

Delete one top-level or nested flow element without rebuilding the rest of the flow

Read-only preflight for a programmed survey. Checks FlowID uniqueness/counts, flow block references, block question references, DataExportTag presence/uniqueness, and unreachable blocks before activation or publishing.

Add embedded data fields anywhere in the survey flow. Place declarations at the beginning, or place assignments after the question/web service that produces their values. Fields are referenced with ${e://Field/FieldName}.

Add a Web Service element anywhere in the survey flow. Response values can be mapped to embedded data fields for downstream piped text. For authentication, headers, or advanced Qualtrics fields, use additionalFields.

Look up Qualtrics piped text syntax. Returns the correct syntax for referencing question responses, embedded data, contact fields, and more in question text, default values, or web service configurations. Use this when you need to dynamically insert values into survey questions.

List all embedded data fields currently defined in a survey's flow

List all Web Service elements currently defined in a survey's flow

Advanced escape hatch for any Qualtrics API v3 endpoint not covered by a dedicated tool. Requests stay on the configured Qualtrics origin. GET is available in read-only mode; otherwise-unmapped writes require the HIGH-risk 'advanced' write scope. Known endpoints still require their normal least-privilege scope. Prefer dedicated tools when available because they validate payloads and provide safer defaults.

List complete quota definitions for a survey, including logic, limits, actions, schedules, and action options

Get a quota's complete raw Qualtrics definition, including its logic and actions

Create a quota from a complete raw Qualtrics quota definition. Optionally add it to a quota group in the same operation.

Replace a quota with a complete raw Qualtrics definition. Use get_quota first, modify the returned definition, and send the complete payload because PUT may replace omitted fields.

Permanently delete a quota from a survey

List complete quota-group definitions for a survey, including membership and multiple-match behavior

Get a quota group's complete raw Qualtrics definition, including its quota membership

Create a quota group from a complete raw Qualtrics quota-group definition

Replace a quota group with a complete raw Qualtrics definition. Use get_quota_group first, modify the returned definition, and send the complete payload because PUT may replace omitted fields.

Permanently delete a quota group AND every quota in that group. Qualtrics documents this as a cascading delete; inspect membership first and explicitly acknowledge the cascade.

Create a complete copy of an existing survey, preserving complex question types, scoring, flow, styling, and settings that do not have individual public mutation endpoints.

Create a survey from a complete Qualtrics Survey Format (QSF) object using the official multipart import API. Use a QSF exported by the Qualtrics UI; the Survey Version API's format=qsf response is not the same import format.

Create a survey from Qualtrics Simple or Advanced TXT format. Supports question IDs/tags, blocks, page breaks, embedded data, choice randomization, MC, Matrix, TE, Constant Sum, Rank Order, and descriptive text syntax.

Create a survey from a publicly accessible QSF, TXT, or DOCX URL. Qualtrics fetches the file, so private/local URLs will not work.

Create a survey from a base64-encoded DOCX prepared in Qualtrics Simple/Advanced import format. Prefer import_survey_text when possible because it is transparent and easier to validate.

List Qualtrics libraries available to the current API user

List reusable survey blocks in a Qualtrics library. Use these templates to discover complex block definitions before copying or recreating them through MCP.

List reusable survey questions in a Qualtrics library. Use these templates to discover complex question definitions before copying or recreating them through MCP.

List reusable survey surveys in a Qualtrics library. Use these templates to discover complex survey definitions before copying or recreating them through MCP.

List reusable email, survey, validation, SMS, and subject messages in a library. Use this to find messageId values for distributions.

Get the complete multilingual content of a library message

Create a reusable multilingual library message for invitations, reminders, thank-yous, end-of-survey text, validation, or other supported categories.

Safely update a library message. Existing description and language content are fetched and preserved unless explicitly replaced.

Permanently delete a reusable library message

Upload a non-confidential JPEG, GIF, or PNG graphic to a Qualtrics library from either a public HTTPS URL or base64 bytes. Uploaded graphics can be publicly accessible through their resulting URL.

Permanently delete a graphic from a Qualtrics library

Get survey-definition metadata, including ownership, status, language, and lifecycle dates