Connecting via MCP
The Attest MCP server lets you query your survey results conversationally from your AI assistant — no code, no exports, no pivot tables.
MCP integration uses the same API key as the REST API. Generate an API key first before continuing.
Setup
Tip: Stuck on a step? Paste the error and ask your AI assistant for help troubleshooting.
The fastest way to connect is with the Attest extension file (.mcpb) — no config editing and no Node.js install required. If you'd rather edit the config file directly (or the extension isn't available on your setup), use the manual method below.
Option A — Install the extension (recommended)
- Download the Attest extension (attest.mcpb).
- Double-click the downloaded file. Claude desktop opens and shows an install prompt for the Attest extension. You can also install it from within Claude: Settings → Extensions → Advanced settings → Install Extension…, then select the downloaded file.
- When prompted, paste in your Attest API key and click Install. Claude stores the key securely and does not display it again. Don't have an API key? Follow this guide to get one
- Make sure to Enable the Attest MCP.
- Once installed, Attest appears in Settings → Extensions as connected — you can ask Claude about your studies directly, no restart needed.
Option B — Manual config
Step 1 — Find your config file
Claude desktop reads its settings from a JSON config file on your computer. Open it in any text editor (e.g. TextEdit on Mac, Notepad on Windows).
Mac:
~/Library/Application Support/Claude/claude_desktop_config.jsonTo open it quickly, press Cmd + Space, type Terminal, and run:
open -e ~/Library/"Application Support"/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.jsonIf the file doesn't exist yet, create it — open a text editor, paste in the config below, and save it at that path.
Step 2 — Add the Attest server
Paste the following into the file, replacing YOUR_API_KEY with your Attest API key. Don't have an API key? Follow this guide to get one
{
"mcpServers": {
"attest": {
"command": "npx",
"args": [
"mcp-remote@latest",
"https://mcp.askattest.com/mcp",
"--header",
"X-API-Key: YOUR_API_KEY"
]
}
}
}If you already have other servers in the file, add the "attest" block inside the existing "mcpServers" object.
Requirements: Node.js must be installed on your computer. Download it here if needed.
Step 3 — Restart Claude
Quit and reopen Claude desktop. Attest will appear as a connected tool — you can now ask Claude about your studies directly.
Requirements: A Plus, Pro, Team, Enterprise, or Edu plan.
Step 1 — Turn on developer mode
Go to Settings → Connectors and enable Developer mode.
Step 2 — Start adding a connector
Still in Settings → Connectors, click +.
Step 3 — Add the Attest server
Enter the server URL:
https://mcp.askattest.com/mcpStep 4 — Authenticate
When prompted, enter your Attest API key. Don't have an API key? Follow this guide to get one
Step 5 — Save
Click Save. Attest will appear as a connected tool.
Step 1 — Find your config file
Gemini CLI reads its settings from ~/.gemini/settings.json. Open it in any text editor.
To open it quickly, run:
open -e ~/.gemini/settings.jsonIf the file doesn't exist yet, create it and save it at that path.
Step 2 — Add the Attest server
Paste the following into the file, replacing YOUR_API_KEY with your Attest API key. Don't have an API key? Follow this guide to get one
{
"mcpServers": {
"attest": {
"command": "npx",
"args": [
"mcp-remote@latest",
"https://mcp.askattest.com/mcp"
],
"env": {
"X-API-Key": "YOUR_API_KEY"
}
}
}
}If you already have other servers in the file, add the "attest" block inside the existing "mcpServers" object.
Requirements: Node.js must be installed on your computer. Download it here if needed.
Step 3 — Restart Gemini CLI
Close and reopen your terminal session. Attest will appear as a connected tool and you can now ask Gemini about your studies directly.
Step 1 — Find your config file
Cursor stores its MCP config in a JSON file. Open it in any text editor.
Global (applies to all projects): ~/.cursor/mcp.json
Project-specific: .cursor/mcp.json in your project root
If the file doesn't exist yet, create it and save it at that path.
Step 2 — Add the Attest server
Paste the following into the file, replacing YOUR_API_KEY with your Attest API key. Don't have an API key? Follow this guide to get one
{
"mcpServers": {
"attest": {
"command": "npx",
"args": [
"mcp-remote@latest",
"https://mcp.askattest.com/mcp",
"--header",
"X-API-Key: YOUR_API_KEY"
]
}
}
}If you already have other servers in the file, add the "attest" block inside the existing "mcpServers" object.
Requirements: Node.js must be installed on your computer. Download it here if needed.
Step 3 — Restart Cursor
Quit and reopen Cursor. Attest will appear as a connected tool.
What the MCP unlocks
Once connected, you can ask questions about your study results in natural language. Instead of exporting data and building pivot tables, you can interrogate your results directly.
"What studies do I have in Attest?"
"Show me the results from our Q1 brand tracker."
"What were the top reasons people gave for choosing a competitor brand?"
"How did awareness vary across age groups in the latest wave?"
"Has brand consideration changed since the previous wave?"
"Which segments showed the biggest shift in sentiment this quarter?"
"Give me a short summary of the key findings from this study that I can paste into a slide."
Updated 6 days ago