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

Tool	Access	Description
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

Tool	Access	Description
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

Tool	Access	Description
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.
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.

Tool	Access	Description
create_target_attributes	Read	Compares your described recruitment criteria against available attributes in Dscout.
add_target_attribute	Write	Adds a targeting attribute to your study.
edit_target_attribute	Write	Modifies a targeting attribute already added to 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.
capture_recruit_criteria	Write	Captures your stated recruiting criteria in plain language for later reference.
capture_research_objectives	Write	Captures your stated research objectives in plain language for later reference.
set_incentive	Write	Sets the incentive amount to be paid to each participant in your study.

Screeners

Tool	Access	Description
add_screener_question	Write	Adds a screener question to your study.
update_screener_question	Write	Edits an existing screener question in your study.
delete_screener_question	Write	Removes a screener question from your study.

Task questions

Tool	Access	Description
add_task	Write	Adds a task question to your study.
update_task	Write	Edits an existing task question in your study.
remove_task	Write	Removes a task question from your study.

Study setup

Tool	Access	Description
create_usability_mission	Write	Creates a new usability test in your Dscout project.
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

Tool	Access	Description
create_question_group	Write	Creates a new question group in your study.
update_question_group	Write	Edits the settings for an existing question group, including: Name. Position in your study. Randomization.
delete_question_group	Write	Removes a question group from your study.
add_question_to_group	Write	Creates a new question within a question group.
remove_question_from_group	Write	Moves a question from within a question group outside of it.
move_question_to_variant	Write	Moves a question into a multi-variate group.

Study questions

Tool	Access	Description
create_study_question	Write	Adds a mission question to your study.
edit_study_question	Write	Edits an existing mission question in your study.
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.

Study management and analysis

Tool	Access	Description
get_study	Read	Get 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.