> For the complete documentation index, see [llms.txt](https://help.dscout.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.dscout.com/dscout-ai/dscout-mcp/set-up-the-dscout-mcp.md).
# Set up the Dscout MCP
*The Dscout MCP is currently in closed beta. Only certain users have access, and the feature may change before general availability. For more information, contact your Dscout Account Director.*
{% hint style="success" %}
**Tip:** Pass this document along to your organization's IT department so they can configure the Dscout MCP for you and your teammates. You may not have the permissions necessary in your chosen AI tool to enable the MCP yourself. If you have any questions, reach out to your Dscout Account Director.
{% endhint %}
The Dscout MCP lets you use Dscout research methods and analysis tools in AI workflows. Your data stays secure.
### Supported tools
You can connect the Dscout MCP to any AI tool that allows custom connectors/MCPs. If you're unsure whether an AI tool you use allows this, work with your organization's internal IT team to verify.
### Security measures
The Dscout MCP includes these security measures:
* OAuth sign-in ensures no API keys or tokens are shared.
* A Dscout account keeps a team member in the loop.
* Customizable read/write permissions let you choose what the Dscout MCP can do.
For supported tasks, see [Dscout MCP tools](/dscout-ai/dscout-mcp/dscout-mcp-tools.md).
### Dscout's MCP endpoint
Point your MCP client at the following endpoint to leverage the Dscout MCP:
```
https://app.dscout.com/astro/mcp
```
{% hint style="warning" %}
Opening this URL in a browser returns an error. Use it only when configuring a custom connection within an AI tool.
{% endhint %}
### Connect your AI tool
For tool-specific guidance on configuring the Dscout MCP, see the sections below:
{% hint style="success" %}
**Tip:** If you run into any issues when following the steps below, refer to the documentation provided directly by your chosen AI tool for more information on adding a custom MCP server.
{% endhint %}
{% tabs %}
{% tab title="Claude" icon="claude" %}
**To set up the Dscout MCP in Claude:**
{% hint style="success" %}
On certain Claude plans, you can share connectors at an organization level. On others, individual users must set up their own custom connectors.
{% endhint %}
{% stepper %}
{% step %}
Create a custom connector named `Dscout`.
{% endstep %}
{% step %}
Enter the Dscout MCP URL: `https://app.dscout.com/astro/mcp`
{% endstep %}
{% step %}
Click **Add**.
{% endstep %}
{% endstepper %}
Now, the Dscout MCP is available as a custom connector in Claude. You'll be prompted to authenticate using your standard Dscout credentials.
{% endtab %}
{% tab title="Claude Code" icon="claude" %}
**To set up the Dscout MCP in Claude Code:**
{% stepper %}
{% step %}
Run the following command in your CLI:
```
claude mcp add dscout --transport http https://app.dscout.com/astro/mcp
```
{% endstep %}
{% step %}
Run `claude` in your CLI to open Claude.
{% endstep %}
{% step %}
Run `/mcp`. A list of your enabled MCPs is displayed, with Dscout showing as `Needs authentication`.
{% endstep %}
{% step %}
Select Dscout and press **Enter**.
{% endstep %}
{% endstepper %}
The authentication page opens. Grant the MCP access to your Dscout account, loggin in with your standard Dscout credentials if prompted.
{% endtab %}
{% tab title="Figma Make" icon="figma" %}
**To set up the Dscout MCP in Figma Make:**
{% stepper %}
{% step %}
Create a custom connector named `Dscout`.
{% endstep %}
{% step %}
Enter `https://app.dscout.com/astro/mcp` as the MCP server URL.
{% endstep %}
{% step %}
Click **Connect**.
{% endstep %}
{% endstepper %}
Now, the Dscout MCP is available as a custom connector in Figma Make. You'll be prompted to authenticate using your standard Dscout credentials.
{% hint style="success" %}
**Tip:** If the connector asks for approval too often, you can set it to auto-run in Figma Make's connector settings. This will minimize the number of times you're prompted to approve the tool's permissions.
{% endhint %}
{% endtab %}
{% tab title="Codex" icon="openai" %}
**To set up the Dscout MCP in Codex:**
{% stepper %}
{% step %}
Add a custom MCP server named `Dscout`.
{% endstep %}
{% step %}
Enter `https://app.dscout.com/astro/mcp` as the URL.
{% endstep %}
{% step %}
Click **Save**. You're returned to your list of Codex MCPs.
{% endstep %}
{% step %}
Click **Authenticate** beside Dscout.
{% endstep %}
{% endstepper %}
The authentication page opens. Grant the MCP access to your Dscout account, logging in with your standard Dscout credentials if prompted.
{% endtab %}
{% tab title="Cursor" icon="cursor" %}
**To set up the Dscout MCP in Cursor:**
{% stepper %}
{% step %}
Add a custom MCP server named `Dscout`.
{% endstep %}
{% step %}
Enter `https://app.dscout.com/astro/mcp` as the **Server URL**.
{% endstep %}
{% step %}
Click **Add MCP**.
{% endstep %}
{% step %}
Locate **Dscout** in your list of custom Cursor MCPs.
{% endstep %}
{% step %}
Click **Login**.
{% endstep %}
{% endstepper %}
The authentication page opens. Grant the MCP access to your Dscout account, logging in with your standard Dscout credentials if prompted.
{% endtab %}
{% tab title="Antigravity" %}
**To set up the Dscout MCP in Antigravity:**
{% stepper %}
{% step %}
Follow the [Antigravity instructions for connecting custom MCP](https://antigravity.google/docs/mcp#connecting-custom-mcp-servers) servers and add the following to your `mcp_config.json` file:
{
"mcpServers": {
"Dscout": {
"serverUrl": "https://app.dscout.com/astro/mcp"
}
}
}
{% endstep %}
{% step %}
Save the configuration and restart Antigravity.
{% hint style="info" %}
**Note:** You will see an error in Antigravity at this point in the configuration. This is expected and will be resolved by following the steps below.
{% endhint %}
{% endstep %}
{% step %}
Navigate to the Antigravity **Settings** menu. Then, select **Customizations**.
{% endstep %}
{% step %}
Beside **Dscout**, click **Authenticate**. The Dscout authentication page is displayed.
{% endstep %}
{% step %}
Click **Approve** to grant Antigravity access to your Dscout account. An authentication code is displayed.
{% endstep %}
{% step %}
Copy and paste the authentication code into Antigravity. Then, click **Submit** to complete authentication.
{% endstep %}
{% step %}
Click **Refresh**.
{% endstep %}
{% endstepper %}
Now, the Dscout MCP is connected and ready for use in Antigravity.
{% endtab %}
{% tab title="VS Code (Copilot)" %}
**To set up the Dscout MCP in VS Code:**
{% stepper %}
{% step %}
Create a `.vscode/mcp.json` file in your workspace:
{
"servers": {
"Dscout": {
"type": "http",
"serverUrl": "https://app.dscout.com/astro/mcp"
}
}
}
{% endstep %}
{% step %}
Open the Command Palette (`Cmd+Shift+P` / `Ctrl+Shift+P`) and run `MCP: List Servers` .
{% endstep %}
{% step %}
Start the Dscout server and complete the OAuth flow when prompted.
{% endstep %}
{% endstepper %}
{% hint style="info" %}
To configure the Dscout MCP across all workspaces, run `MCP: Open User Configuration` from the Command Palette and add the server configuration there.
{% endhint %}
{% endtab %}
{% tab title="Copilot" %}
**To set up the Dscout MCP in Microsoft Copilot:**
{% stepper %}
{% step %}
Go to the **Tools** page for your agent.
{% endstep %}
{% step %}
Select **Add a tool**.
{% endstep %}
{% step %}
Select **New tool**.
{% endstep %}
{% step %}
Select **Model Context Protocol**. The MCP onboarding wizard is displayed.
{% endstep %}
{% step %}
Fill in the following fields.
* **Server name:** `Dscout`.
* **Server description:** `Give the agent read and write access to the Dscout research platform, including studies, screeners, participants, sessions, transcripts, highlights, and responses. Use it to create and configure studies, manage participants, pull transcripts and responses, and search past research for findings and highlights.`
* **Server URL:** `https://app.dscout.com/astro/mcp`
{% endstep %}
{% step %}
Select **OAuth 2.0** as the authentication method. Then, select **Dynamic discovery**.
{% endstep %}
{% step %}
Click **Create**.
{% endstep %}
{% endstepper %}
Now, the MCP is available for your Copilot agents, and you'll be prompted to authenticate using your Dscout credentials upon first use.
{% endtab %}
{% tab title="Windsurf" %}
**To set up the Dscout MCP in Windsurf (Devin):**
{% stepper %}
{% step %}
Add the following to Windsurf's `mcp_config.json` file:
```
{
"mcpServers": {
"Dscout": {
"serverUrl": "https://app.dscout.com/astro/mcp"
}
}
}
```
{% endstep %}
{% step %}
Save the file, completing authentication when prompted.
{% hint style="info" %}
**Note:** You may be prompted to grant Windsurf permission to open a window in your browser. You must grant this permission as this is how you will connect the tool to your Dscout account.
{% endhint %}
{% endstep %}
{% endstepper %}
Now, the Dscout MCP is available in Windsurf.
{% endtab %}
{% tab title="Other" %}
**Any MCP-compatible client can connect over streamable HTTP.**
**Point your client to the following endpoint:**
```
https://app.dscout.com/astro/mcp
```
**No authentication fields are required during configuration. Users will be prompted to authenticate with their standard Dscout credentials upon their first use.**
{% endtab %}
{% endtabs %}
{% hint style="info" %}
**Note:** Users must have an active Dscout account to use the Dscout MCP. They will be prompted to authenticate in the browser using their existing Dscout credentials on their initial use of the MCP.
{% endhint %}
### Verify the connection
After connecting to the Dscout MCP, verify the connection with one of these prompts:
> **What studies are currently launched across my Dscout projects?** You'll see a list of launched studies, including parent project, study type, number of entries, and launch date.
> **How many responses have I received in my most recently launched study?** You'll see the number of submitted responses for the study you launched most recently.
> **Show me the most recent entry submitted to my \[study].** You'll see the most recent response for your requested study, including the participant's name, submission date, and key takeaways from their response data.
> **What was one common thread across responses in my \[study]?** You'll see an underlying theme that appeared across participant responses in your requested study, including supporting quotes and participant names.
> **Create a new Dscout usability test for me.** You'll be prompted to enter some basic details about your study (study name, desired project, etc.) and to answer questions about your research objectives.
If your AI tool returns an error, see [Troubleshoot the Dscout MCP](/dscout-ai/dscout-mcp/troubleshoot-the-dscout-mcp.md) for help resolving it.
### Learn more
Learn more about the Dscout MCP in these articles:
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://help.dscout.com/dscout-ai/dscout-mcp/set-up-the-dscout-mcp.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.