Versive

Edit an existing logic rule. Only provided fields change. Use get_logic_rules first.

edit_logic_rule

Edit any aspect of a question: content, type, options, labels, scale settings, or behavior flags. Only provided fields change; props merge with the existing configuration. Changing question_type preserves the id and position but rebuilds props for the new type. The result warns when an edit orphans logic rules that match on removed option text. Use get_question_details first.

edit_question

Rename a question group or change whether it randomizes its direct children. Only provided fields change.

edit_question_group

Replace a randomizer's final arm configuration: rename it, add/update/remove arms, change weights or targets, or move it. Pass every arm that should survive — arms left out are removed with their content.

edit_randomizer

Edit study-level settings: title, description, status (published/paused), conversation mode, completion quota, pause redirect URL, org-visibility access_policy, interviewer branding (display name, personality, brand color), or languages (default_language / supported_languages — setting supported_languages triggers background translation). The personality is freeform prompt text describing any persona or tone; the interviewer defaults are tuned to work well, so leave name/personality/color untouched unless the user asks for a specific change or you are fixing a specific problem — and read the current values (get_study) before changing them. Only provided fields change.

edit_study_settings

Advisory cost estimate for recruiting a number of participants at a given incentive on Prolific or Respondent (rewards plus provider and platform fees), before creating a panel. For Prolific it reports screen_out_required when the study screens participants out, and then prices the required screen-out budget (defaults unless screen_out_reward / screen_out_slots are given); use those values in the plan and the create call. The charged amount is always computed at checkout in the dashboard.

estimate_panel_project_cost

Export interview responses as CSV: one row per interview, one column per question (answers come from what participants actually said). Paginated over interviews — check total_interviews in the result and page through for large studies. Useful for analysis in external tools or handing the raw data to the user.

export_study_data

How many Prolific participants match a set of filters (empty filters = the whole pool). Prolific reports 0 when fewer than masked_below (5) match. Use it to sanity-check targeting before creating a panel, and warn the user when the count is close to or below the participants they want.

get_prolific_eligible_count

Respondent targeting vocabularies: country, companySize, householdIncome, gender, educationLevel, ethnicity, ageGroup, seniorityLevel, industries, jobFunction, topics. Job titles and skills are NOT lookups: search them with search_respondent_options. Pass the ids or values returned here to create_respondent_panel_project.

get_respondent_lookups

Ground truth about what Versive studies support: the full question-type catalog with per-type props and their server-side defaults, logic-rule operations and actions per question type, question-group rules, known-unsupported features WITH their workarounds, and Versive's distinctive capabilities. Consult this before telling a user something is or is not possible, and before building questions of an unfamiliar type. Optional topic narrows the answer (e.g. "logic", "randomization", "question_types").

get_capabilities

Fetch a single interview by id, including the question/answer conversation. Use this to quote or analyze what a participant actually said. Long conversations are windowed: total_messages reports the full length, and message_offset/message_limit page through it. Requires read access to the study the interview belongs to.

get_interview

List conditional logic rules — for one question (question_id) or the whole study (study_id). Rules are returned in the same vocabulary the write tools accept (equals/contains/always, skip_to/move_to_group/end_interview/screen_out/redirect), so values can be passed back to add_logic_rule / edit_logic_rule as-is.

get_logic_rules

Fetch one recruiting panel with its provider-specific targeting: Prolific filters, naivety rate, device requirements, and readiness; or Respondent market type, demographic and professional targeting, and screener questions. Read before updating.

get_panel_project

Fetch one question's full configuration (content, type, props, media assets, attached logic rules). Use assets[].download_url to view media; private links expire at download_url_expires_at. Fetch details again for a fresh link. assets[].url is the stable identifier, not a private-media download link. Use before editing a question to see its current state.

get_question_details

Fetch a single Versive study by id: status, settings, quota, interviewer branding, participant-facing messages, languages, question/group/interview counts, and its share_url (participant link) and study_url (dashboard link). Always use these URLs when referring to the study — never construct one. Use before editing to see current values. Fails with an access error if you cannot read the study.

get_study

One-call answer to "how is my study doing?": totals and per-status counts of STARTED interviews (never-started invitation links are excluded), completion rate, median progress of incomplete interviews, approximate drop-off by question, and weekly started/completed trends. Real vs AI-simulated interviews are always split (completed_real vs completed_simulated) — report them separately, never as one number. active_interviews matches the default list_interviews total. Pass question_id to instead get answer aggregates for one quantitative question (the same numbers the dashboard charts show) — prefer that over reading every interview and tallying by hand.

get_study_stats

List interviews for a Versive study (paginated, with the total count). By default returns the ACTIVE set (in_progress + closed + processing) — 'open' invitation links that were never started, screened_out, paused, and canceled interviews appear only when filtered for explicitly by status. The default total matches get_study_stats active_interviews. Filter by status or exclude AI-simulated interviews with include_simulations: false. Requires read access to the study.

list_interviews

List recruiting panels (Prolific or Respondent projects): provider, status (DRAFT = not paid or published yet, PAID = live, CLOSED), recruiting status, participant counts, and dashboard links (panel_url; edit_url for drafts). Omit study_id to list EVERY panel in your organization in one call (each row carries its study_title) — never walk list_studies and query study by study. Pass study_id for one study. Use get_panel_project for targeting details.

list_panel_projects

List a study's question groups, hierarchy, display order, and randomization settings. Use with list_questions to understand the complete grouped interview structure.

list_question_groups

List a study's interview questions, including question type, group membership, per-parent display order, interviewer notes, and whether each question has logic rules attached (has_logic). For grouped studies, combine this with list_question_groups to reconstruct the interview tree.

list_questions

List a study's randomizers (weighted split tests) with their arms, weights, and each arm's target question or question group. A group whose routing_branch_id is set in list_question_groups is owned by one of these arms.

list_randomizers

List the research studies in your Versive organization that you have access to, newest first, paginated (returns items plus the total count). Optionally filter by status or a title/description query, and set include_activity for per-study response counts (which studies have interviews, completions, simulations). Use get_study for full details of one study.

list_studies

Move questions into a group, or pass null to move them to the study top level. Questions are appended to the target. Moves that would invalidate randomized-group skip logic are rejected.

move_questions_to_group

Read one help-center page as plain Markdown, optionally a single section. Use the slug from search_docs (e.g. "mcp/setup", "getting-started/concepts"); a docs.getversive.com URL is accepted too. Pass section to read just one heading (its text or anchor, e.g. "Troubleshooting") — the response lists every heading, so read a section first for long pages. Answer from the content and cite the page url. The pages describe the product in general; use get_study, list_interviews, etc. for anything about the user's own data.

read_doc

Remove a group. mode='ungroup' dissolves it and keeps its children; mode='delete' also removes descendant groups and questions. Prefer ungroup unless deletion is explicit.

remove_question_group

Remove (soft-delete) one or more questions from a study. This cannot be undone via MCP. The result reports logic rules on other questions that targeted a removed question and now need fixing.

remove_questions

Remove a randomizer. mode='ungroup' dissolves it and keeps every question (arm content moves back into the study in arm order); mode='delete' also removes the questions and groups inside its arms. Prefer ungroup unless deletion is explicit.

remove_randomizer

Reorder a study's questions. Provide ALL question ids in the desired order (use list_questions first to get the current order). Grouped studies must use move_questions_to_group instead.

reorder_questions

Search the Prolific participant-filter catalog by text (titles, ids, choice labels) or category. Returns filter ids, their type (select or range), and choice ids with labels to use in create/update_prolific_panel_project filters. Small filters list every choice; when choices_truncated is true, or the choice you need is not shown, call again with filter_id to list that filter's choices (query then narrows them). Never guess an id.

search_prolific_filters

Search Respondent job titles or skills by text and get the ids to use for B2B targeting (target_job_titles, target_audience_skills).

search_respondent_options

Search Versive's help center (docs.getversive.com) for product knowledge: how features work in the app, credits and billing, sharing and distribution, recruiting participants, results and insights, organizations, roles and permissions, MCP server setup, and API / SDK basics. Use it for "how do I…" and "how does … work" questions instead of guessing (get_capabilities stays the source of truth for what the study tools can literally do). Returns the best-matching pages with the matched section and a snippet; call read_doc with a result's slug for the full page or one section, then answer from it and link the page url.

search_docs

Cap completed interviews per option on a multiple choice question (replace-set: pass the FULL bucket list; an empty list clears the question's quotas). match 'equals' = that option is the only one selected (works on single- and multi-select), 'includes' = option among the selected values (multi-select only); limit 0 closes the option; options without a bucket are unlimited. When a bucket is full, new participants who choose that option are screened out when they answer; other options keep going. Independent of the study-level quota in edit_study_settings. Values must be the exact option text — use get_question_details first. Success returns {question_id, buckets} with the normalized saved buckets. Fails with a clear error for an unknown question, a non multipleChoice question, a value that is not one of the question options, or an 'includes' bucket on a single-select question.

set_question_quotas