Usercase MCP server

Q: How do I add Usercase MCP to Claude Code?

Run `claude mcp add --env USERCASE_API_KEY= mcp -- npx -y @usercase/mcp` in your terminal. Add `--scope user` to make it available in every project.

Q: How do I add Usercase MCP to Cursor?

Open `~/.cursor/mcp.json` and add the server under `mcpServers`, using the Cursor config shown in the install section above.

io.usercase/mcp

Ask real users on your site and run virtual users in a real browser, then fix what they hit.

Also known as mcp, @usercase/mcp

stdio

Install

Stars: 0
Tools: —
Downloads, 30 days: —
Latest version: 0.2.15
Last commit: —
License: —

What is Usercase MCP?

Usercase is an MCP server. Ask real users on your site and run virtual users in a real browser, then fix what they hit.

How to install Usercase MCP

Formats verified 10 Nov 2026

Claude CodeCursorVS CodeClaude DesktopCodexGemini CLI

$ claude mcp add --env USERCASE_API_KEY=<YOUR_USERCASE_API_KEY> mcp -- npx -y @usercase/mcp

~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@usercase/mcp"
      ],
      "env": {
        "USERCASE_API_KEY": "<YOUR_USERCASE_API_KEY>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@usercase/mcp"
      ],
      "env": {
        "USERCASE_API_KEY": "<YOUR_USERCASE_API_KEY>"
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@usercase/mcp"
      ],
      "env": {
        "USERCASE_API_KEY": "<YOUR_USERCASE_API_KEY>"
      }
    }
  }
}

~/.codex/config.toml

[mcp_servers.mcp]
command = "npx"
args = ["-y", "@usercase/mcp"]

[mcp_servers.mcp.env]
USERCASE_API_KEY = "<YOUR_USERCASE_API_KEY>"

~/.gemini/settings.json

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@usercase/mcp"
      ],
      "env": {
        "USERCASE_API_KEY": "<YOUR_USERCASE_API_KEY>"
      }
    }
  }
}

Set 2 environment variables before starting the server (below).Setup guides:Claude Code Cursor VS Code Claude Desktop

Configuration

USERCASE_API_KEYSecret
Optional. Leave empty to connect in the browser on first use, or paste a key from Dashboard → Settings → API keys.
USERCASE_DIAGNOSTICS
Optional. Set to off to stop sending tool failure diagnostics to the Usercase team.

Name	Description
USERCASE_API_KEY	Optional. Leave empty to connect in the browser on first use, or paste a key from Dashboard → Settings → API keys.	Secret
USERCASE_DIAGNOSTICS	Optional. Set to off to stop sending tool failure diagnostics to the Usercase team.

Usercase MCP questions

How do I add Usercase MCP to Claude Code?

Run claude mcp add --env USERCASE_API_KEY=<YOUR_USERCASE_API_KEY> mcp -- npx -y @usercase/mcp in your terminal. Add --scope user to make it available in every project.

How do I add Usercase MCP to Cursor?

Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.

Facts

Nov 14, 2026

Stars: 0
Downloads, 30 days: —
Latest version: 0.2.15
Last commit: —
License: —
Transport: stdio
Package: @usercase/mcp

usercase

Community publisher

Published by an independent maintainer.

Works with

Claude Code Cursor VS Code Claude Desktop Codex Gemini CLI Windsurf Devin

Badge for your README

Show your HostedMCP checks score. The badge links readers to install instructions for every client.

[![HostedMCP checks](https://api.hostedmcp.org/v1/badge/server/usercase/mcp.svg)](https://hostedmcp.org/servers/usercase/mcp/checks)

Maintainer?

Claim this listing to edit it and add the HostedMCP badge to your README.

Claim listing

Before you install

Servers run with the permissions you give them. Use the narrowest token or database role that does the job.

{ "mcpServers": { "mcp": { "command": "npx", "args": [ "-y", "@usercase/mcp" ], "env": { "USERCASE_API_KEY": "<YOUR_USERCASE_API_KEY>" } } } }

{ "servers": { "mcp": { "type": "stdio", "command": "npx", "args": [ "-y", "@usercase/mcp" ], "env": { "USERCASE_API_KEY": "<YOUR_USERCASE_API_KEY>" } } } }

{ "mcpServers": { "mcp": { "command": "npx", "args": [ "-y", "@usercase/mcp" ], "env": { "USERCASE_API_KEY": "<YOUR_USERCASE_API_KEY>" } } } }

Configuration

USERCASE_API_KEYSecret

Optional. Leave empty to connect in the browser on first use, or paste a key from Dashboard → Settings → API keys.

USERCASE_DIAGNOSTICS

Optional. Set to off to stop sending tool failure diagnostics to the Usercase team.

Name	Description
USERCASE_API_KEY	Optional. Leave empty to connect in the browser on first use, or paste a key from Dashboard → Settings → API keys.	Secret
USERCASE_DIAGNOSTICS	Optional. Set to off to stop sending tool failure diagnostics to the Usercase team.

Usercase MCP questions

How do I add Usercase MCP to Claude Code?

Run claude mcp add --env USERCASE_API_KEY=<YOUR_USERCASE_API_KEY> mcp -- npx -y @usercase/mcp in your terminal. Add --scope user to make it available in every project.

How do I add Usercase MCP to Cursor?

Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.

Usercase MCP server

What is Usercase MCP?

How to install Usercase MCP

Install Usercase MCP in Claude Code

Install Usercase MCP in Cursor

Install Usercase MCP in VS Code

Install Usercase MCP in Claude Desktop

Install Usercase MCP in Codex

Install Usercase MCP in Gemini CLI

Configuration

Usercase MCP questions

Usercase MCP server

What is Usercase MCP?

How to install Usercase MCP

Install Usercase MCP in Claude Code

Install Usercase MCP in Cursor

Install Usercase MCP in VS Code

Install Usercase MCP in Claude Desktop

Install Usercase MCP in Codex

Install Usercase MCP in Gemini CLI

Configuration

Usercase MCP questions