ai.userintuition/research MCP server

Legacy bulk selection: add every currently available study to this research session. Use sync_research_study for a selected study.

Fastest cited answer to one question across selected studies ("why did customers churn?"). For multi-turn follow-ups with clickable quote cards use chat_research_session. Uses indexed research across selected accessible studies. Returns generated statements with numbered citations to canonical content IDs, plus source details and index status. Use search_research to inspect the underlying records.

MCP App button action. Consumes one short-lived approval challenge, rechecks the saved study and price, then launches one paid panel cycle.

Withdraw a pending feasibility request. A request already answered cannot be cancelled.

Cancel one durable analysis run only when the user requests it. Existing results remain available for inspection.

Cancel a queued or running research export. A cancelled worker cannot publish its file.

Ask a multi-turn question about your User Intuition studies and get an answer grounded in verified participant quotes. Waits for the answer; use queue_research_chat to return immediately. If still running, returns the same durable job without cancelling it. For findings, feedback, comparisons and quotations from your User Intuition studies, use this tool; answers are grounded in document search over the session sources with verified quotations. Resolve ambiguous study names first. Reuse the selected research session; if absent create one with create_research_session and a stable retry key, inspect sources and add only missing requested studies. Do not resync unchanged sources or broaden the session silently. After completion always call view_research_answer to display the answer and clickable quote/recording cards inside this conversation, without redirecting to a dashboard; preserve the answer and citation labels. Poll inspect_research_session view=job. Set parent_job_id for a follow-up in the same session. Reuse the same idempotency_key and prompt after a timeout; sync and async share the job.

Legacy bulk removal: remove all sources from this research session without deleting the underlying studies or files. Use only when the user requests clearing the session.

Create or replace a customer-supplied panel bridge on an owned BYOP study. Supply completion and screen-out redirect URLs; set the provider's respondent ID query parameter and placeholder if the defaults differ. Optional session, external study, quota-full, and technical-failure mappings are supported. Before sharing entry_url with the provider, call get_study, verify provisioning_status=provisioned, and have the human approve the current plan and URL mapping. This does not recruit respondents or launch the paid User Intuition Panel. Repeating the same PUT preserves the current entry token.

Invite people you recruit yourself by email, such as your customers, to a study (BYOP = bring your own participants). Queues creation of 1–100 unique BYOP participants. Poll get_participant_job until succeeded, then list participants. Before creating participants, call get_study, require provisioning_status=provisioned, and verify or obtain explicit approval of the current plan. Carry a trusted unchanged approval forward using study_id and updated_at; changed plan or participant settings invalidate it. Invitation emails send unless silent is true.

Create a research session (a saved analysis workspace) for selected studies and uploaded sources. Reuse the same idempotency key after an uncertain response.

Start a qualitative research study with real people: AI-moderated in-depth interviews (user interviews, customer interviews, market research; the moderator probes and ladders, typically 20–30 minutes), concept tests (packaging, claims, ad creative, designs), or prototype tests (clickable prototypes, websites, landing pages), by voice, video or chat in 80+ languages. Participants come from a 4M+ vetted consumer panel, your own customers by email, or synthetic respondents. Use for "interview N shoppers about X", "test this concept with real people", "why did customers churn / switch / buy", win-loss, onboarding. Not for multiple-choice surveys. Creates an in-depth-interview, concept-test, or prototype-test draft using ordinary metadata only. Choose recruiting_method from the brief: panel when User Intuition should recruit real participants, byop when the user will supply their own participants, or synthetic_respondents when the brief calls for simulated participants. Ask only if the recruiting method is unclear. Unless the human requests otherwise, use a voice interview in English with the male interviewer voice; these defaults are applied when interview_format, language, or voice are omitted. Synthetic respondents require chat. A prototype-test must use video or voice, never chat. Do not draft or pass the study plan, audience targeting, screener questions, concept links, or concept images here; they come from the user's natural-language research brief in the next call. For a concept test, pass an accessible attachment through customize_study.concept_image or include a publicly downloadable concept-image URL in the message, plus its participant-facing label, stimulus context, audience, and learning goals. For a prototype test, include the prototype URL, participant-facing label, intended tasks, audience, and learning goals. customize_study validates and attaches the asset. Voice configuration is kept for chat as well as voice and video. Next: send the brief to queue_customize_study.

Create a webhook for an account or one owned study. Choose interview, study lifecycle, participant lifecycle, or quota events. The signing secret is shown once; store it securely.

Draft or revise a study's discussion guide, interview questions, screener, and audience from the research brief, one design turn per call. May fetch a researcher-provided concept URL. Clients that support MCP background tasks receive a task for turns without concept_image; wait on that task for the result. Calls with concept_image return the result directly. Put operational workflow constraints in execution_policy, never in message. Set decisions=agent only when the human delegated research-design choices; report assumptions and relay only remaining required questions. Otherwise use human mode and relay questions[]. If the client exposes an attached image as bytes or a readable local path, ask for a participant-facing label when missing, base64-encode the raw bytes, and send concept_image. Completed plans and setting changes are persisted. Then get_study, return the full saved plan for review, and obtain approval before invitations or paid launch.

Disable the external-panel entry link for an owned BYOP study. Existing interviews remain; the provider can no longer send new respondents through this link. A repeated deletion returns 404.

Soft-delete an interview owned by the authenticated user. Call only when the human explicitly requests deletion of this interview.

Soft-delete one BYOP participant after the user explicitly requests it. Deletion also removes its personal link. If interviews exist, the request returns a conflict unless the user separately approves deleting those interviews and cascade_interviews is true.

Permanently delete an existing saved output (report, deck or video) in its session only when the user requests deletion. Read the output first.

Delete one research session only when the user explicitly requests it.

Soft-delete a study and its linked participants, interviews, and reports from normal reads. Participant links stop working. There is no public restore endpoint. Uploaded assets may have separate retention. Call only when the human explicitly requests deletion of this study.

Deprecated compatibility tool. List webhooks, then use delete_webhook_by_id so deletion works through clients that omit DELETE request bodies. A repeated deletion returns 404.

Stop future deliveries to one registered webhook. A repeated deletion returns 404.

Retrieve a saved report as Markdown, PowerPoint as PPTX/PDF, or Highlights as a short-lived private MP4 link. Files return filename, mime_type and data_base64 (up to 64 MB); decode to an artifact rather than showing base64 to the user. Access is checked again. Preserve verified references; never invent download URLs.

Apply the requested prompt to an existing report or PowerPoint in place. Read the output first. Retains its ID and reuses saved evidence; default reports and Highlights cannot be edited. Poll inspect_research_session view=job and read the original output after success. Reuse the key on retry.

Estimate the cost and timeline of recruiting real interview participants from User Intuition's 4M+ vetted consumer panel for one study, without spending. Returns per-interview and total cost before any commitment. Read-only estimate for one Panel recruitment cycle. Returns per-interview and total credit cost, available balance and deficit, participant reward, card hold, recurrence, and a heuristic timeline. launch_panel shows this estimate for human App approval, or human chat confirmation in clients without Apps, before the paid request. The price and balance can change before launch; use submit_feasibility_request for incidence below 10% or more than 1,000 interviews.

Queue an AI analysis of completed interviews into a cited report (findings, themes, quotes). Clients that support MCP background tasks receive a task to wait on; other clients receive a job ID and poll get_report_job. Then call get_study_report. report.ready webhooks also signal completion.

Queue a report, native PowerPoint or saved Highlights video in a research session. Reuses saved reports and findings; no need to run exhaustive analysis first. Highlights follow default-report learning goals/quotes, with original audio when available and no artificial narration for chat studies; prompt does not select different quotes. Poll inspect_research_session view=job until succeeded; then read its output_id. Retry with the same key.

Read the effective workspace, role, billing plan, available credits, payment readiness, and incentive limits. Check the plan before using Intelligence Hub tools. A payment method on file does not approve a Panel launch; use the current estimate and its MCP App for human approval.

Poll a queued study customization turn. On succeeded, inspect result and call get_study to return the persisted plan. On failed, inspect the saved study before retrying.

Read the customer-supplied panel entry link, respondent ID parameters, and outcome redirects for one owned BYOP study. This is distinct from individual BYOP participants and paid User Intuition Panel recruitment.

Get one feasibility request and its status or estimate.

Get qualifying completions versus the current target, completed interview quality counts, and a rate-based expected finish when enough progress exists.

Get one interview: transcript, participant details, recording links, screener answers, timing, stored format, current configured study language, and up to 100 spoken transcript segments bounded to about 20 KB of text. Use next_message_offset to fetch the next page. Each segment keeps its original turn ID and text_offset; system prompts and internal metadata are excluded.

Aggregate eligible non-test interview counts and billed units over a date range. The backend resolves the default app and a 30-day UTC range when omitted. The response includes the applied scope.

Read one BYOP participant, including its current status, personal interview link, interview count, and reward state. Use it to verify the participant before changing their email, deleting the participant, or sending a reward. Panel respondents are not returned by this tool.

Poll a participant batch. On success, list_participants for the study to retrieve the participants.

Poll an asynchronous report request. A succeeded job provides result_url; then fetch the report with get_study_report.

Poll an editable PowerPoint export. A succeeded job returns a fresh private download URL valid for 15 minutes. The export expires after seven days.

Read a run and verified claims, its evidence, eligible timed highlights, exports, source coverage or session history. Follow next_cursor until exhausted. Evidence includes canonical transcript locators; audio eligibility requires a complete participant turn and owned recording. Authorization is checked on every read.

Poll a research export. A succeeded job returns a fresh private download_url with source access rechecked at download. Expired or revoked sources cannot be downloaded.

Get the full persisted study, including the plan, audience targeting, screeners, and concept assets managed by customize_study. Call before metadata updates and after customization to verify the result. After customization, return the complete persisted study_plan to the user in a readable form. Panel launch approval happens in the launch_panel MCP App, or explicit human chat confirmation when the client does not support Apps. Obtain explicit approval of the current plan before BYOP participant creation; retain study_id and updated_at so unchanged approval survives a resumed workflow. When provisioning_status is provisioned, include both returned links in the completion response. dashboard_url is the researcher management link. study_link is the live participant interview link, not a test or preview link; opening it starts the participant experience. The public API does not expose a separate researcher-preview URL.

Read one study's finished report (findings, themes, quotes); does not answer new questions. Returns a small overview by default. Set view to one section (study_findings, participant_profiles, participant_responses, evidence_coverage, recommended_next_steps, or references), or full when all data is needed. included_sections distinguishes omitted sections from empty ones. Findings include structured prevalence and source quotes when available.

Get a webhook by ID without revealing its signing secret.

Read research sessions (each a saved analysis workspace of selected studies and uploaded files), one session, its sources, chronological chat history, a background job, or saved outputs such as reports and slide decks. Set session_id except when view=sessions; job needs job_id, output needs output_id. Follow next_cursor unchanged as after. Job success includes answer/references or output_id; partial remains explicit. Read the existing output before editing it.

Recruit real interview participants from User Intuition's 4M+ vetted consumer panel. If an owner or admin enabled automatic launches in Wallet, this tool launches one cycle within the workspace cap with a current estimate and idempotency key. Otherwise, the first call previews the saved plan and complete current panel estimate; nothing is spent until a human explicitly approves. For App clients, a human must click Approve and launch in the App. For clients without MCP Apps, return the saved plan and quote in chat, ask the human to confirm, then call this tool again with the returned chat_approval_nonce and human_confirmed=true. Never infer confirmation from a prior study or quote. The estimate must match the study, country, inputs, balance and price at approval time.

List the account feasibility requests, newest first, in bounded pages.

List lightweight interview rows. Fetch an interview to get messages, recordings, and screener responses.

List organizations you can access. Users can belong to multiple organizations. Search by organization name, active owner name, or owner email; returns IDs and owner contacts. Ask the human which organization to use, then supply organization_id on subsequent tools.

List participants (BYOP invitations) with each personal interview link, status and visible interview count. These are study participations, not deduplicated people; use list_interviews(participant_id) for the sessions. Panel and open-link respondents are anonymous interviews.

List lightweight studies, sorted by updated_at descending then ID. Filter before pagination by provisioning status, recruiting method, creation date, or report availability. interview_count is completed visible non-test interviews; use get_study for the full plan, screeners, and targeting.

Search the panel targeting catalog by name or category. Use its qualification and option IDs when configuring a panel study. The full study response also resolves saved targeting to readable labels; age bands can be approximate.

List bounded delivery attempts, status codes, and coarse failure reasons without payloads.

List account webhooks and their study scopes. Signing secrets are never included.

Pause a study while preserving its panel survey, target cycle, progress, and reward hold.

Queue one design turn that drafts or revises the study's discussion guide, questions, screener, and audience from the research brief. May fetch a researcher-provided concept URL. Clients that support MCP background tasks receive a task to wait on; other clients receive a job ID and poll get_customize_study_job. Then call get_study and show the full saved plan for human review. Reuse an idempotency_key after an uncertain response. Native concept images require the synchronous customize_study tool.

Queue an editable PowerPoint deck from the latest saved report. Common text identifiers are masked by default. Poll get_report_slide_job for a private download URL, which expires after 15 minutes. The export is retained for seven days.

Same as chat_research_session but returns a job immediately; use when the answer may take longer than the client's tool timeout. For findings, feedback, comparisons and quotations from your User Intuition studies, use this tool; answers are grounded in document search over the session sources with verified quotations. Resolve ambiguous study names first. Reuse the selected research session; if absent create one with create_research_session and a stable retry key, inspect sources and add only missing requested studies. Do not resync unchanged sources or broaden the session silently. After completion always call view_research_answer to display the answer and clickable quote/recording cards inside this conversation, without redirecting to a dashboard; preserve the answer and citation labels. Poll inspect_research_session view=job. Set parent_job_id for a follow-up in the same session. Reuse the same idempotency_key and prompt after a timeout; sync and async share the job.

Use report_video for Highlights: generate one retained MP4 from the studies' default reports, with branded logo bookends, learning-goal chapters and their cited Quotes. Repeated requests return the saved video. No evidence selection is needed. Also supports an editable PowerPoint, an individual audio clip or a legacy audio reel ZIP from a completed/partial research analysis run. Use exact evidence_ids returned by get_research_analysis highlights; presentations include all findings. Audio requires explicit export instruction. Text masking defaults on. Poll get_research_deliverable, or wait on the MCP background task when the client supports tasks. Private links last 15 minutes; temporary audio and presentation files expire in seven days; report videos are retained while their source remains available. Reuse the idempotency key after a timeout.

Replace the external-panel entry token for an owned BYOP study. The old provider link stops working immediately; update the provider with the returned entry_url. Supply a unique idempotency_key and reuse it after an uncertain response; inspect the current link with get_external_panel if the replay is stale.

Remove one source from a research session by the opaque ID returned by inspect_research_session. The underlying study or uploaded file is not deleted.

Remove one study source from a research session; the underlying study remains available in User Intuition.

Rename an existing saved output (report, deck or video) in its session. Default reports cannot be renamed. Read the output first.

Rename one research session without changing its sources or analysis.

Resume a paused or partial durable analysis run with an additional call allowance. Poll get_research_analysis for the updated result.

Resume a paused study and continue its preserved panel recruitment.

Open an interactive, read-only view of the saved study plan and current fielding progress. The view does not approve a plan or launch recruitment. Ask the human for approval separately before fieldwork.

Replace a webhook signing secret. The new secret is shown only in this response; update the receiver before relying on further deliveries.

Search findings, participant responses, and study plans from your User Intuition study reports, across one or more studies. Results are grouped under studies[] with each study_id, index_status (ready, updating, or not_indexed), latest_report_id, indexed_report_id, and matching canonical content. No generated prose is returned. Pass next_cursor back with the same query, filters, and limit to continue; stop when it is null.

Send the configured incentive to a BYOP participant when the human requests it. Before calling, confirm the participant (get_participant) and the reward amount (byop_config.incentive_amount from get_study) with the user. Reuse idempotency_key on uncertain retries; the backend prevents duplicate rewards for an already-paid participant.

Start a durable analysis across the session sources. exhaustive processes every eligible interview; quick retrieves verified evidence through document search; aggregate computes exact counts; explore runs bounded computation. Poll get_research_analysis. Prefer chat_research_session or queue_research_chat for questions and generate_research_output for saved outputs. Completed or partial runs can produce presentations, clips or reels; retain coverage and limitations. Reuse the idempotency key on uncertain retries.

Stop panel recruitment, close the target cycle, and settle/release the active reward hold. Call only after the human explicitly chooses to end this study's fieldwork.

Submit a low-incidence, large, or specialized audience for manual feasibility review when direct panel launch is unavailable. This creates a review request, not a paid launch. Provide the target audience, target count, and incidence rate in percentage points; optionally link an accessible study. Use list_feasibility_requests or get_feasibility_request to follow its status.

Add or resync one study in a research session. Inspect existing sources and add only the study the user requested.

Send a signed test event containing no participant or study data. This makes an outbound request to the registered URL.

Change the email, external customer ID, or customer metadata fields on one BYOP participant. Call get_participant first to verify the intended participant. Send email=null only when the user explicitly wants to clear it. Pass only fields to change.

Update ordinary study metadata only, such as name, format, language, voice, or incentives. Use customize_study—not this tool—for the research plan, audience targeting, screener questions, concept links, or concept images. Only supplied fields change. Active panel studies must be paused or stopped first. Call get_study first.

Attach external evidence to a research session: TXT, Markdown, CSV, JSON, text PDF or DOCX, up to 10 MB. Send user-provided file bytes as base64. Uploading again creates another source; list sources after an uncertain response before retrying.

Upload a template up to 5 MB: report Markdown/TXT/DOCX with {{title}} and/or {{findings}} placeholders; presentation 16:9 PPTX theme/layout. Send raw file bytes as base64; pass the returned template id to generate_research_output. Repeated uploads create separate templates.

Show the full answer in this MCP chat with clickable verified quotes and original recordings. Use this to display the answer after research chat, rather than linking to an external dashboard. Use after chat_research_session or queue_research_chat; pending jobs can be checked here. Keep session_id and job_id for follow-ups. Set reference_label to read one cited quotation and its transcript/recording context. Preserves backend citation labels; never invent sources.