Dscout MCP tools
Note: The Dscout MCP is currently in closed beta, meaning only certain users have access and the feature will undergo changes prior to general availability. For more information, contact your Dscout Account Director.
The Dscout MCP lets you build and launch studies and interact with your data in a conversational way without having to leave your favorite AI tools. To do that, the MCP uses the following tool calls to read and write data within your Dscout account.
Account management
list_accounts
Read
Lists all Dscout accounts you have access to.
get_account_balance
Read
Lists the balance of incentives and activity credits in your Dscout account.
get_researcher_profile
Read
Lists the name and email address associated with your individual Dscout account.
Projects and workspaces
create_project
Write
Creates a new project in your Dscout account.
list_projects
Read
Lists all projects you have access to in your Dscout account.
list_workspaces
Read
Lists all workspaces you have access to in your Dscout account.
Entries and responses
list_entries
Read
Lists accepted submissions from a study, including:
Participant name.
Date and time of submission.
Submission status (accepted or queued for payment).
Note: The queued for payment submission status indicates submissions within the 7-day window you have to review submissions before they are automatically paid.
get_entry
Read
Retrieves details for a single entry, including every question response and transcript (if applicable).
filter_entries
Read
Identifies entries based on your stated criteria. For example, “Find all entries that mention Amazon” will call this tool.
list_clips
Read
Provides a list of clips from your study, including a direct link to view them in the Dscout web app.
create_clip
Write
Creates a new clip from a response entry.
cite_evidence
Read
Cites specific evidence from a participant’s response to support a stated research finding. For example, “Tell me why this participant found the task difficult” will call this tool.
Recruiting
Note: The Dscout MCP does not currently support recruiting from Partner Panels or Private Panels, nor does it support behavioral or custom targeting attributes.
set_target_attributes
Write
Creates, adds, or edits a targeting attribute from your study.
delete_target_attribute
Write
Removes a targeting attribute from your study.
set_recruiting_method
Write
Assigns a recruitment method to your study:
Recruit from the Dscout Scout Panel.
Add from a Dscout screener.
Bring your own participants.
set_incentive
Write
Sets the incentive amount to be paid to each participant in your study.
Screeners
upsert_screener_question
Write
Creates and/or updates a screener question.
delete_screener_question
Write
Removes a screener question from your study.
Study setup
draft_study_plan
Write
Drafts a full study plan (targeting attributes, screener questions, study questions).
apply_study_plan
Write
Applies a previously drafted plan to a study.
update_mission_settings
Write
Edits the settings in an existing usability test, including:
Name.
Device type.
Recording option.
Mission description.
Incentive amount.
Participant limit.
Time frame.
Custom instructions.
Custom thank-you message.
Knockout message.
list_mission_templates
Read
Lists study templates available in your Dscout account.
Note: Only usability test templates are currently supported.
Question groups and multi-variate testing
upsert_question_group
Write
Creates and/or updates a question group in your study.
set_question_group_members
Write
Assigns questions to (or moves questions to a new) question group in your study.
delete_question_group
Write
Removes a question group from your study.
Study questions
upsert_study_question
Write
Creates and/or updates a study question.
delete_study_question
Write
Removes a mission question from your study.
add_questions_from_bank
Write
Adds a question from a question bank to your study.
list_question_banks
Read
Lists available questions from the question bank in your Dscout account.
Media and stimuli
prep_stim_upload
Write
Prepares a file to be uploaded as a stimulus to a question in your study. This tool prompts you to provide your image file in the chat with your AI tool.
For information on supported file types and limits, see Question stimuli.
set_mission_image
Write
Assigns a hero image to your study.
Study management and analysis
get_study
Read
Gets details about a specific study, including title, launch status, and more.
list_studies
Read
Lists studies across the projects you have access to in your Dscout account.
clone_study
Write
Duplicates an existing study, letting you enter a new study title and destination project (if desired). Recruitment criteria, questions, and stimuli remain the same.
create_study_from_template
Write
Creates a new study from a template.
move_study_to_project
Write
Relocates an existing study from one project to another in your Dscout account.
Note: It is not possible to move studies from one Dscout account to another.
preview_study
Write
Generates a preview link for your study through which you can preview the study as a participant would see it.
launch_study
Write
Launches your study, opening it to participants.
check_launch_readiness
Read
Verifies whether your study meets the required launch criteria, reporting any unmet requirements.
query_study
Read
Retrieves raw response data from your study.
compute_study_metric
Read
Calculates quantitative metrics from your raw response data. For example, “How many participants rated difficulty 3 or higher?” will call this tool.
Learn more
Learn more about the Dscout MCP in these articles:
Last updated