Voicepanel

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

get_account

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 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. Studies are also called "projects".

get_study

Get response statistics for a study (counts by status and distribution). Studies are also called "projects".

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 responses for a study (excludes full conversation transcripts — use get_response for that)

list_responses

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 project name as it appears in the dashboard. Archived studies are excluded. Studies are also called "projects".

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. Studies are also called "projects".

list_tags

List available distribution templates

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. Studies are also called "projects".

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

How to design a good Voicepanel study, and how to express it as a study plan. Covers research best practices (including this account's own AI rules, if it has customized them), every step and stimulus type with its exact fields, the template variables you can interpolate into question text and stimulus URLs, conditional sections, section randomization, and the constraints that fail validation. Call this before writing or editing a `plan` by hand — `generate_study` already applies this guidance internally. Read-only. Studies are also called "projects".

get_study_design_guide

Given a plain-text description of the target audience, recommend which research panel to recruit from, with a rationale and ranked alternatives. Call this before create_panel_distribution to decide the `provider` — then present the recommendation to the user and let them override. Returns `recommended_provider` (the best-fit panel this account can use — 'user_interviews' or 'respondent'), `rationale`, `best_fit_label` (the ideal panel, which may be a specialty we don't self-serve), `requires_contact` (true when the ideal fit isn't self-serve), and `options` (accessible panels ranked best-fit first).

suggest_panel_provider

Update a response's status and/or whether it is included in analysis

update_response