Skip to content
MCP server

Usercase

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

Runs locallyStatus and history
Install
Runs
Locally
Version
0.2.17
Listing updated
3 days ago

About Usercase

Usercase is an MCP server. It runs locally on your machine and is started by your AI client.

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

Install

Run in a terminal

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

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Configuration

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

Usercase FAQ

How do I add Usercase to Claude Code?

Run this command in your terminal: claude mcp add mcp --env USERCASE_API_KEY='<USERCASE_API_KEY>' -- npx -y @usercase/mcp