@userevaluation/mcp

Local Model Context Protocol server for User Evaluation. Connects your UE workspace to Claude Desktop, Cursor, ChatGPT, Claude Code, and any other MCP-aware AI client.

Install

You don't need to. The recommended invocation is npx:

npx @userevaluation/mcp

Configure

Generate an API key at app.userevaluation.com/settings → API Keys. The key is shown once at creation — copy it then.

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "userevaluation": {
      "command": "npx",
      "args": ["-y", "@userevaluation/mcp"],
      "env": { "UE_API_KEY": "ue_live_..." }
    }
  }
}

Restart Claude Desktop. The hammer icon in the conversation should now list the UE tools.

Cursor

Settings → MCP → Add Server. Same command / args / env shape as above.

Claude Code

claude mcp add-json userevaluation '{"command":"npx","args":["-y","@userevaluation/mcp"],"env":{"UE_API_KEY":"ue_live_..."}}'

Tools

| Tool | What it does | |---|---| | me | Identify the authenticated researcher. | | list_projects | Page through projects in the workspace. | | get_project | Fetch one project by id. | | list_project_files | List files (videos / audio / PDFs / docs) attached to a project. | | list_project_tests | List engage tests inside a project. | | list_project_tags | List tags defined on a project. | | list_project_cards | List insight cards on a project. | | list_project_reports | List AI-generated reports on a project. | | get_file | Fetch a file's metadata + signed download URL. | | get_transcript | Fetch a file's speech-to-text transcript. | | create_card | Create an insight card on a project. | | list_engage_tests | List engage tests across the entire workspace. | | get_usage | Return your /v1 usage stats (rate-limit + audit log). |

Hosted alternative

A hosted MCP server is also available at https://api.userevaluation.com/mcp so you can connect remotely without a local process. Same tools, same auth.

License

MIT