Identifies conversion fixes from real visitor sessions and provides specific file and line numbers to implement changes.
Also known as GetUserProof/userproof
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 3.3.0
- Last commit
- Nov 13, 2026
- License
- MIT
What is UserProof MCP?
UserProof identifies conversion fixes from real visitor sessions and provides specific file and line numbers to implement changes.
Summary generated from the project's README
About UserProof MCP server
UserProof helps developers identify specific conversion improvements by analyzing real visitor sessions. Instead of providing vague feedback, this server points to the exact file and line number required to implement a fix. It also allows you to verify if a change successfully addressed the user issue after you deploy the code.
This MCP server works with Claude Code, Codex, and Cursor. You can install it via the plugin marketplace or by adding it to your cursor mcp.json configuration using npx. The setup process involves creating an account and adding a tracking snippet to your website to record visitor behavior like clicks, scrolls, and errors. Once configured, you can run the /userproof:review command to find your top priority fix.
Security is handled by storing your API key in ~/.config/userproof/key with restricted permissions. The server only reads .userproof files and your API key, ensuring your source code is never uploaded to external servers. It requires Node 18+ to run.
What you can do with it
- 1Identify specific code fixesAsk the AI to find the exact file and line number needed to fix a conversion issue identified from visitor sessions.
- 2Verify deployment successCheck if a recently shipped code change actually resolved the problem reported by users.
- 3Automate initial project setupInstruct the agent to read the setup documentation and configure the tracking snippet for your domain.
Written from the project's README. Every use case is checked against a quote from it.
How to install UserProof MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall UserProof MCP in Claude Code
$ claude mcp add --env 'USERPROOF_API_KEY=<YOUR_USERPROOF_API_KEY>' userproof -- npx -y userproofInstall UserProof MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"userproof": {
"command": "npx",
"args": [
"-y",
"userproof"
],
"env": {
"USERPROOF_API_KEY": "<YOUR_USERPROOF_API_KEY>"
}
}
}
}Install UserProof MCP in VS Code
.vscode/mcp.json
{
"servers": {
"userproof": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"userproof"
],
"env": {
"USERPROOF_API_KEY": "<YOUR_USERPROOF_API_KEY>"
}
}
}
}Install UserProof MCP in VS Code CLI
$ code --add-mcp '{"name":"userproof","type":"stdio","command":"npx","args":["-y","userproof"],"env":{"USERPROOF_API_KEY":"<YOUR_USERPROOF_API_KEY>"}}'Install UserProof MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"userproof": {
"command": "npx",
"args": [
"-y",
"userproof"
],
"env": {
"USERPROOF_API_KEY": "<YOUR_USERPROOF_API_KEY>"
}
}
}
}Install UserProof MCP in Codex
$ codex mcp add userproof --env 'USERPROOF_API_KEY=<YOUR_USERPROOF_API_KEY>' -- npx -y userproofInstall UserProof MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.userproof] command = "npx" args = ["-y", "userproof"] [mcp_servers.userproof.env] USERPROOF_API_KEY = "<YOUR_USERPROOF_API_KEY>"
Install UserProof MCP in Gemini CLI
$ gemini mcp add -s user -e 'USERPROOF_API_KEY=<YOUR_USERPROOF_API_KEY>' userproof npx -- -y userproofInstall UserProof MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"userproof": {
"command": "npx",
"args": [
"-y",
"userproof"
],
"env": {
"USERPROOF_API_KEY": "<YOUR_USERPROOF_API_KEY>"
}
}
}
}Configuration
USERPROOF_API_KEYSecretUserProof API key. Run /userproof:setup in Claude Code to create one, or leave unset: the server also reads ~/.config/userproof/key.
| Name | Description | |
|---|---|---|
| USERPROOF_API_KEY | UserProof API key. Run /userproof:setup in Claude Code to create one, or leave unset: the server also reads ~/.config/userproof/key. | Secret |
Automated checks
Ran Nov 14, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablegetuserproof/userproof is public and reachablegithub.com/getuserproof/userproof ↗Pass
- Package names this repository as its sourceuserproof names getuserproof/userproof as sourcenpmjs.com/package/userproof ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-13github.com/getuserproof/userproof ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from userproofPass
- No critical advisory in the package or its dependencies99 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubUserProof for Claude Code, Codex and Cursor
UserProof shows you the one fix your real visitors are begging for, with the file and line, then checks whether it worked after you ship. https://getuserproof.com
Install
/plugin marketplace add GetUserProof/userproof
/plugin install userproof@userproof
/userproof:setup
Codex
codex mcp add userproof -- npx -y github:GetUserProof/userproof
codex "Read https://getuserproof.com/setup.md and follow it to set up UserProof for this project."
Cursor
Add to ~/.cursor/mcp.json under mcpServers:
"userproof": { "command": "npx", "args": ["-y", "github:GetUserProof/userproof"] }
Then ask the agent: "Read https://getuserproof.com/setup.md and follow it to set up UserProof for this project."
Setup creates your account, adds the tracking snippet to your site, and proves it records. After a Claude Code restart (or /mcp reconnect) run /userproof:review for the top fix.
What data it collects
- Your email and site domain, sent to api.getuserproof.com at signup.
- Visitor behavior on your site (page views, clicks, scrolls, errors) sent by the snippet to ingest.getuserproof.com.
- The plugin itself reads only
.userproofin your repo and your API key. The key is stored in~/.config/userproof/key(mode 600). It does not upload your source code.
No npm install is needed: the MCP server ships inside the plugin as one file (plugin/mcp/server.mjs, also run by npx github:GetUserProof/userproof) and needs Node 18+.
UserProof MCP questions
How do I add UserProof MCP to Claude Code?
Run claude mcp add --env 'USERPROOF_API_KEY=<YOUR_USERPROOF_API_KEY>' userproof -- npx -y userproof in your terminal. Add --scope user to make it available in every project.
How do I add UserProof MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
How do I set up UserProof for my project?
You can set it up by asking your agent to read the setup documentation at the provided URL to create an account and add the tracking snippet.
What data does the plugin collect?
It collects your email, site domain, and visitor behavior such as page views, clicks, scrolls, and errors.