MCP server

Your research,
in your AI assistant.

Connect ChatGPT, Claude, Claude Code, Cursor or VS Code to User Evaluation. The assistant reads your studies, transcripts and study reports, searches what participants said and asks Eva. It cites the evidence.

Connect your assistant Read the set-up guide

17 toolsStreamable HTTPOAuth or API keyNothing to install

Tools

What the assistant can do

The server has 17 tools. Most tools read. Two tools write: ask Eva, and make a draft study.

list_studies · get_study · get_study_status

Studies

List your studies. Read the question, guide, screener and audience of a study. See its status and progress.

list_sessions · get_session

Sessions

List the sessions of a study. Read one session with its full transcript, chapters and signals.

get_readout · list_reports · get_report

Study reports and reports

Read the themes, claims and clips of a study report. List reports and read one report.

list_swarm_runs · list_findings · get_finding

Swarm

List Swarm runs and their findings. Read one finding with its evidence.

search · search_evidence

Search

Find studies, reports, files and people by name. Search what participants said in transcripts, clips and study report claims.

list_library_files · get_library_file

Library

List your Library files. Read one file with its transcript.

ask_eva

Eva

Ask Eva a question. The answer cites its evidence. The app keeps it as a chat.

create_draft_study

Draft a study

Make a draft study from a research question. It does not publish or charge. You check and launch it in the app.

Set up

Connect a client

The server address is https://api.userevaluation.com/mcp. ChatGPT, Claude and Claude Code sign in with your account. For Cursor and VS Code, put your API key in place of ue_live_….

01
Add the server
In ChatGPT or Claude, add a custom connector with the server address. For other clients, use the snippet below.
02
Sign in and allow
Sign in to User Evaluation. Select the workspace and what the assistant can do. Then click Allow.
03
Or use an API key
For Cursor and VS Code, go to Settings, then API & MCP. Make a key and put it in the snippet. You see the key one time.

ChatGPT · Settings → Apps & Connectors → Createtext

Name:  User Evaluation
URL:   https://api.userevaluation.com/mcp
Auth:  OAuth

Claude · Settings → Connectors → Add custom connectortext

Name:  User Evaluation
URL:   https://api.userevaluation.com/mcp

Claude Codebash

claude mcp add --transport http userevaluation https://api.userevaluation.com/mcp
# then type /mcp in Claude Code and sign in

Cursor · ~/.cursor/mcp.jsonjson

{
  "mcpServers": {
    "userevaluation": {
      "url": "https://api.userevaluation.com/mcp",
      "headers": { "Authorization": "Bearer ue_live_…" }
    }
  }
}

VS Code · .vscode/mcp.jsonjson

{
  "servers": {
    "userevaluation": {
      "type": "http",
      "url": "https://api.userevaluation.com/mcp",
      "headers": { "Authorization": "Bearer ue_live_…" }
    }
  }
}

Access

What a connection can do

Same rules as the API

It acts as you

A connector or a key has your workspace role, up to Member rights. It sees only one workspace.

Read or write

You select the access

With read access, the assistant can use each tool that reads, and it can ask Eva. To make a draft study, it needs write access.

Settings

You see each connection

Settings shows each connected assistant and the MCP calls. Revoke access to stop an assistant at once.

Questions about MCP

For other questions, send an email to support@userevaluation.com. A person answers.

Which clients can connect?

ChatGPT, Claude, Claude Desktop and Claude Code sign in with your User Evaluation account (OAuth). Cursor and VS Code connect with an API key. Other clients can connect if they support OAuth sign-in or can send an Authorization header.

Can I connect ChatGPT or a Claude custom connector?

Yes. Add a custom connector and type the server address. ChatGPT or Claude opens a User Evaluation page. Sign in, select the workspace and select what the assistant can do. Then click Allow. You do not need an API key.

What can the assistant change?

It can ask Eva and make a draft study. A draft study does not publish or charge. Before Eva spends money or contacts people, Eva asks for your approval in the app. A read-only key can read and ask Eva, but Eva cannot change anything for it.

Which plans include the API?

The API and the MCP server are part of the Pro, Team and Scale plans. They are not on the Free plan. The MCP server uses the same API keys. Each key can send 600 requests a minute.

How do I stop access?

Go to Settings, then API & MCP. For a connector, click Revoke access in the Connected list. For a key, revoke the key. Access stops at once.