Voicepanel

Create a link distribution — a shareable link the user sends directly to their own respondents. To qualify respondents before the study (useful for reaching a niche audience by sharing the link widely and screening), pass `screener_questions` directly, or pass an `audience` description to have the screener generated automatically. Only use this when the user has chosen link sharing; if they haven't said how they want to collect responses, ask them to choose between a link, an on-site intercept (create_intercept_distribution), or panel recruiting (create_panel_distribution). Returns `share_url`, the public link respondents open to take the study, and `url`, a dashboard link to view the distribution. Note the distribution starts in draft — publish_distribution makes the share_url live.

create_link_distribution

Create a panel distribution — participants are recruited automatically from a research panel. Created in draft status only; this tool does not contact the panel provider. Publishing a panel recruit is not available over MCP — tell the user to publish it from the Voicepanel dashboard, which is where credits are spent and recruiting starts. Only use this when the user has chosen panel recruiting; if they haven't said how they want to collect responses, ask them to choose between a link (create_link_distribution), an on-site intercept (create_intercept_distribution), or a panel. Call suggest_panel_provider first to pick the `provider`. Pass an `audience` description to have targeting filters and a screener generated automatically (required for 'respondent'). Returns `url`, a dashboard link to view the distribution — share it with the user.

create_panel_distribution

Create a new segmentation to categorize responses for a study

create_segmentation

Create a new study. If you are writing the `plan` yourself, call get_study_design_guide first — it covers the plan fields, the research rules this account applies, and the constraints that fail validation. Returns `url`, a dashboard link to open the study — share it with the user.

create_study

Edit an existing distribution. Panel distributions can only be edited while in draft status.

edit_distribution

Edit an existing study. If you are writing the `plan` yourself, call get_study_design_guide first — it covers the plan fields, the research rules this account applies, and the constraints that fail validation.

edit_study

Generate a complete study using AI from a natural language description. The AI will create a full study plan with sections, questions, and conversation guides based on best practices in user research. Use this when you have a research objective or description and want the AI to design the study structure. Use create_study instead if you want to manually specify study fields. Returns the study with `url`, a dashboard link to open it — share it with the user.

generate_study

Get one scenario set with its scenarios in order, and the treatment labels attached to it. A treatment is the artifact one variant shows for a scenario; `treatment_labels` gives each label and how many scenarios have it. Pass a label to start_eval_run. Add treatments with create_treatments.

get_scenario_set

Get current account information (name, subscription tier, credits, limits)

get_account

Get one eval and all of its runs, oldest first. Each run gives its treatment label, status, and summary: `mean_scores` per treatment on a 0–1 scale, and the number of scenarios graded. Use get_eval_run for the score and rationale of each scenario.

get_eval

Get one eval run: its status and summary, and one result per graded scenario. Each result gives the scenario title, `overall_score` on a 0–1 scale, and `scores` keyed by rubric ID, with the raw `scale_value` and the judge's `rationale`. While `status` is "running", `graded_count` rises toward `scenario_total`.

get_eval_run

Get a full analysis insight with evidence quotes and response IDs

get_analysis_insight

Get AI-generated analysis insights (the findings/summary) for a study — the latest completed summary, evidence omitted. Start here for high-level findings. Use get_analysis_insight for full evidence quotes. The returned `_versions` array lists prior summary versions you can fetch by id. Pass analyze_in_original_language to view the summary in the study's original language instead of English.

get_analysis_insights

Get a full analysis question with evidence quotes and response IDs per category

get_analysis_question

Get analysis questions with summaries and answer categories for a study — the latest result per question (continuously maintained, not tied to a run), evidence omitted. Use get_analysis_question for full evidence quotes. Pass analyze_in_original_language to view summaries in the study's original language instead of English.

get_analysis_questions

Get detailed distribution information including config, incentive, quota, and targeting. Returns `url`, a dashboard link to view the distribution, and — for link distributions — `share_url`, the public link participants open to take the study (share this one with respondents).

get_distribution

Get a highlight reel: its name, its page URL, and each highlight in the order the reel plays them. Each highlight gives its `index`, study_id, response_number, the quote it shows, its `duration_seconds`, and `trimmed` (true when a person trimmed the clip in the editor). Call this before update_highlight_reel: pass `{ keep: index }` to keep a highlight as it is.

get_highlight_reel

Get a single response with full conversation transcript

get_response

Get full segmentation details including segment definitions and matching criteria

get_segmentation

Read the caller-defined attributes stored on a stimulus — the tags used to group and compare stimuli during analysis (e.g. which model or price tier a variant represents). Stimulus IDs come from the `plan` returned by get_study, where each stimulus carries its `id` and, once set, its `metadata`.

get_stimulus_metadata

Get detailed study information including questions, plan, settings, and response statistics, plus `url`, a dashboard link to open the study.

get_study

Get response statistics for a study (counts by status and distribution).

get_study_stats

Retrieve the media a user uploaded via an upload session (see create_upload_session). Returns the uploaded files as `{ url, stimulus_type }` — use each url as a stimulus in a study plan (create_study/edit_study). Call this after the user confirms they have finished uploading; status stays 'awaiting_upload' until at least one file has been uploaded.

get_upload_session

Get current user profile (name, email, role in account)

get_user_profile

List all distributions for a study

list_distributions

List the evals in this account, newest first. An eval pairs a scenario set with a grader. Each run of an eval grades one treatment label across the scenarios. Each eval carries its run count, its three newest runs, and score stats per treatment. Use get_eval for every run.

list_evals

List the graders in this account, newest first. A grader is an LLM judge: a model, a system prompt, a user prompt template, and the rubrics it scores on (`rubric_ids`).

list_graders

List responses for a study (excludes full conversation transcripts — use get_response for that)

list_responses

List the rubrics in this account, newest first. A rubric is one numeric scale, from 0 upward, with a label and description for each level. A grader scores each treatment on one or more rubrics.

list_rubrics

List the scenario sets in this account, newest first, with the number of scenarios in each. A scenario set is a list of user needs that an eval grades treatments against.

list_scenario_sets

List segmentations for a study (name, key, description). Use get_segmentation for full segment definitions.

list_segmentations

List the active studies in the account, with response counts and a dashboard `url` per study. `internal_name` is the study name as it appears in the dashboard. Archived studies are excluded.

list_studies

List all labels in the account with the number of studies using each. Labels are stored as tags; a study has a single label.

list_tags

List the templates saved in the account. Each row carries a `type` of 'distribution', 'screener', or 'typing_tool'. A 'typing_tool' row is the account's typing tool, not a template to copy: a researcher uses it on a study from the study editor.

list_templates

Publish a distribution to make it live and start collecting responses. For link distributions, returns `share_url` — the public link to share with respondents, now live. Supports link and intercept distributions; publishing panel distributions is not currently available over MCP (publish those from the Voicepanel dashboard).

publish_distribution

Get an AI review of a study's configuration before publishing. Returns a score (1-5) and improvement suggestions. Results are cached per study version.

review_study

Generate a fresh analysis summary (findings/insights) for a study from its responses — the same action as the Update button on the analyze page. This does NOT regenerate per-question analysis (that is maintained automatically as responses complete); it produces a new summary version asynchronously. Requires at least one analysis question to have finished processing.

run_analysis

How to write screener questions that qualify the right respondents and resist gaming. Covers the qualification tags and the must_select/must_one_of trap, obfuscating the target so respondents can't guess the qualifying answer, honeypot options, option randomization and anchoring, early screenout, question order, and how to write open-ended and matrix questions. Includes this account's own AI rules if it has customized them. Call this before passing `screener_questions` to a distribution tool by hand — passing an `audience` description instead applies this guidance automatically. Read-only.

get_screener_design_guide

Tag a stimulus with caller-defined attributes so analysis can group and compare by them later. Pass `metadata` to set several attributes at once, or `key` plus `value` to set a single one — exactly one of the two. By default `metadata` is merged into what is already there; pass `replace: true` to drop every attribute it doesn't name. To remove one attribute, pass its `key` with a null `value`; to clear them all, pass an empty `metadata` with `replace: true`. Stimulus IDs come from the `plan` returned by get_study.

set_stimulus_metadata

Start a run that grades one treatment label across the eval's scenarios. The grader runs in the background and the tool returns at once with the run `status` "running". Call get_eval_run with the run `id` to see progress and scores. The first run freezes the eval: after it, the eval's scenario set and grader cannot change. Get the treatment labels from get_scenario_set. `scenario_limit` grades only the first N scenarios, for a quick check.

start_eval_run