Recruiting method
Ask the user when the choice is not explicit. Do not infer it from the research topic.
Interview format
When the user does not specify a format,create_study defaults to voice. Set interview_format to chat or video only when the user requests it. Call list_available_modes for discovery when needed.
Concept links are incompatible with chat interviews. Send the concept request through customize_study and relay its question so the user can choose voice or video.
Language and voice
Omitted settings default to English (en) and Elliot (male). Use list_available_languages when the user requests another language; use a returned ISO code or auto. The public voice choice is male (Elliot) or female (Clara). Never supply voice for chat. list_voices is a supplemental discovery catalog; its provider-specific IDs are not accepted in the public voice field.
Study type and plan
Public writes acceptstudy_type: "in-depth-interview", "concept-test", or "prototype-test". The default is in-depth-interview. A prototype test cannot use chat; it uses the default voice format or an explicitly requested video format. list_study_types and get_study_type can explain the available planning templates, but the MCP host must not build the plan from internal prompt fields.
Create the metadata draft, then send the user’s brief to customize_study. The backend applies the study type’s current chat_prompt instructions and persists the resulting plan, duration, audience, screeners, and concept material.
Concept material
Describe links and images in thecustomize_study conversation. For an image attachment that the client exposes as bytes or a readable local path, the agent can send the base64-encoded bytes through customize_study.concept_image; no public URL is required. A public downloadable URL and label can still be supplied in the message.