Skip to content
verify mcp Beta VerifyMCP is currently in beta. If you notice any issues, get in touch and we’ll put it right.

Usercase

NPM · @USERCASE/MCP

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

Available components

+19 this week 64 Trust /100

Last scanned (23 hours ago)

Scores higher than 37% of npm servers

Category Testing and QA

Trust breakdown (7 categories)

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score → Why this is hard to score →

Supply Chain Security98
  • No malware found by supply-chain analysis.Pass
  • No known CVEs affecting this package version or its production dependencies.Pass
  • No install/post-install scripts declared.Pass
  • 31 of 96 dependencies flagged as unhealthy. View diagnostics → Partial
Provenance & Transparency6
Schema Quality & AI Usability78
  • 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).Pass
  • AI-judged instruction clarity (good).Pass
  • Context-footprint check failed: tool/resource definitions use about 4635 tokens (~136/item across 34 items; 34 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
  • Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management23
  • Stability observed for 7 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage90
  • 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
  • 70% of tool parameters carry a description.Partial
Tool Safety75
  • No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
  • 0 of 1 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation; "steps_send" implies "send" and declares no destructiveHint at all, which the MCP spec reads as destructive by default. See how to fix → Fail
  • An AI judge read all 35 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
  • Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
What we tested

Checks we ran (15)

  • Malware scan
  • Known CVEs
  • Install scripts
  • Dependency health
  • Source repository
  • Provenance
  • License
  • Maintenance
  • Schema quality
  • Stability
  • Tool coverage
  • Injection markers
  • Destructive annotations
  • Judged manipulation
  • MCP protocol

Checks we could not complete (1)

These are gaps on our side, not findings about this package. We only credit what we can confirm, so a category made up entirely of them scores 0.

  • Security disclosure in Provenance & TransparencySecurity-disclosure policy not yet verified: we couldn't inspect the source repository.

Does not apply to this package (2)

  • Endpoint SecurityScored on hosted endpoints only. A package has no live endpoint of its own for us to probe.
  • Transport & ReachabilityScored on hosted endpoints only. A package has no live endpoint of its own for us to probe.

The score does not measure everything. What the score does not measure →

Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

  • 21 Nov 26 +1

    No change was recorded against any check on this day. Stability & Change Management went from 20 to 23. That category is still filling its 30-day observation window: 6 days of observed history at the previous scan, 7 at this one. The score rises as the window fills, whether or not the server changes.

  • 19 Nov 26 +1

    No change was recorded against any check on this day. Stability & Change Management went from 13 to 17. That category is still filling its 30-day observation window: 4 days of observed history at the previous scan, 5 at this one. The score rises as the window fills, whether or not the server changes.

  • 17 Nov 26 +1

    No change was recorded against any check on this day. Stability & Change Management went from 7 to 10. That category is still filling its 30-day observation window: 2 days of observed history at the previous scan, 3 at this one. The score rises as the window fills, whether or not the server changes.

  • 15 Nov 26 +16
    • Malware scan: unverified → pass ▲ security
    • Stability: unverified → 0.03 ▲ functional
    • Package version: 0.2.15 → 0.2.17 functional
    • Package version: 0.2.15 → 0.2.16 functional
  • 14 Nov 26 45

    First indexed and scored.

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 21 Nov 2026 · Analysed npm/@usercase/mcp@0.2.17

Provenance No attestation

The registry publishes no build provenance for this version, so there is nothing to verify.

Result No attestation
Ecosystem npm

Background: How many MCP packages publish verified provenance →

Dependencies 96 packages
Packages resolved 96
Stale 31
Tree resolution Complete

Background: SBOMs and build attestations, explained →

MCP tools · 34 exposed · ~4,473 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →

Tool Tokens
act ~347

Do one thing on the screen, as the person. Numbers refer to the latest screen you were shown — only what is in view; scroll to see more. It happens after the pause a real person would take on that screen, then you get the new screen — or a survey card, or the end of the visit.

NameTypeReqDescription
actionstringyes–
doneboolean–For leave: true if you got what you came for
indexintegeryesNumber of the thing to click, type into, hover over or drag. For scroll/scroll_up, the number of a part of the screen that scrolls on its own (or of something inside it) — or -1 to scroll the page. -…
textstring–For type: what you type (in the language of the site), or the option/value to choose in a dropdown, slider or date box. For press: the key (Escape, Tab, Enter, ArrowDown…). For drag without `to`: the…
timesinteger–For scroll, scroll_up, click or press: how many times in a row, quickly (scrolling down while skimming, clicking again because nothing happened, pressing an arrow key a few times). Default 1
tointeger–For drag: the number of the thing to drop it onto; -1 to drag in the direction given in text
visit_idstringyes–
whystringyesOne short sentence in English: what you are doing and why, as this person

No output schema declared.

No examples provided.

answer_card ~156

Respond to the survey card on screen, as the person. Decide `bothered` FIRST — most people close these without reading. Only if bothered, pick an option, write your own words, or still close.

NameTypeReqDescription
actionstringyes–
botheredbooleanyesWould this person, right now, bother to answer at all?
bothered_whystringyesEnglish, one sentence
choice_indexintegeryesOption number for choose; -1 otherwise
other_textstring–Your own words for other, in the language of the card, the way this person writes
visit_idstringyes–
whystringyesEnglish, one sentence: why this answer

No output schema declared.

No examples provided.

check_site ~115

Open the site once as a virtual user and report: does it load, is the Usercase SDK running (which project), is a firewall/bot protection blocking us (and how to unblock, per vendor), is the secret key set. Always run this before starting visits. If it reports a block, stop and tell the user. If you have not read the research procedure yet, call the instructions tool with command research first.

NameTypeReqDescription
urlstringyesThe site to test, e.g. https://staging.example.com

No output schema declared.

No examples provided.

connect ~70

Connect Usercase to a project in the browser, or switch to another project. Opens the Usercase dashboard where the user signs in and picks the project. Other tools connect by themselves when nothing is connected — use this only when the user wants another project, or check_site says the SDK sends to a different project.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

install_snippet ~119

Get the Usercase script for the connected project, with where to put it per framework. If nothing is connected yet, it opens the browser to connect and says what to tell the user. Use when check_site says the SDK is not running and you are in the site's repository: add the script once to the root layout/document, show the user the diff, then run check_site on the local site to confirm. Do not commit or deploy unless asked. If you have not read the install procedure yet, call the instructions tool with command install first.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

instructions ~392

Start here for any Usercase work — whether the user typed a command or just asked in their own words. Returns the step-by-step procedure; follow it as the user's request, and call this before the other Usercase tools. Commands: research (test or get feedback on the site with virtual users; `research` id to have them take part in a research), new-research (plan or create a research / usability study), install (add or install the Usercase script on the site), question (make a question to ask visitors at a moment on the site), steps (write the steps for the question open in the dashboard; `session` = its window id), path (record the expected paths of a research's tasks; `research` id, optional `task`), fix (fix a finding from a research report: `research` id + `finding` key like F1, `audience` real for the real-people report; or an issue from Issues: `issue` id), connect (connect this repository to another Usercase project).

NameTypeReqDescription
audiencestring––
commandstringyes–
countstring–How many people (default 5), or "unlimited" to keep going until you stop it
findingstring––
focusstring–Only people who come for this part of the site, e.g. calendar, or comments and sharing
issuestring–An issue id from the dashboard's Issues — fixes that issue instead of a report finding
researchstring–The research id, or its name as the user said it (the server finds it by name; if several or none match, it lists them — ask the user which one)
sessionstring–The window id shown in the dashboard command
taskstring––
urlstring––

No output schema declared.

No examples provided.

issue_fix ~140

Record on a Usercase issue that you are fixing it (status fixing, once the user approved the change) or have fixed it (status fixed, with the files, a one-sentence summary for the team, and the pull request link if any). After a finished fix, starting again records the next fix.

NameTypeReqDescription
filesarray–Repository paths of the files changed (or to be changed)
issuestringyesThe issue id
prUrlstring–Pull request link, if one was opened
statusstringyes–
summarystring–One sentence for the team: what visitors now see differently

No output schema declared.

No examples provided.

issue_list ~80

List the open issues of the Usercase project (problems found from visitors' answers to questions on the site): id, title, where, whether it is a clear fix, and whether one is being fixed. Use when the fix command has no issue id. If you have not read the fix procedure yet, call the instructions tool with command fix first.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

issue_read ~93

Read one issue of the Usercase project with all its evidence: the question and page, what people chose, what they wrote, the AI's reading, other issues with the same cause, and earlier fixes. Read it before looking for the code. If you have not read the fix procedure yet, call the instructions tool with command fix first.

NameTypeReqDescription
issuestringyesThe issue id, as in the dashboard command

No output schema declared.

No examples provided.

list_people ~26

List the virtual users in .usercase/people.json and whether each has visited yet.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

login ~306

Open a visible browser on the user's screen so THEY can sign in to the site with one demo account. Only the resulting session (cookies) is saved, under an account name in .usercase/sessions/ — the password never passes through you or us. Call it once per demo account, one at a time. Returns immediately; tell the user to sign in and close the window, then run check_site — it checks whether the sign-in really worked. If an account is not signed in or has expired, call login again with that same account name. Members (member=true) are spread across the signed-in accounts. Never ask the user for their password.

NameTypeReqDescription
accountstring–Account name to save it as (a1, a2 …). Leave out for a new account; give an existing name to sign in again
lifetimeHoursnumber–How long a sign-in lasts, if the auth code says (e.g. a session maxAge or ttl). Shown as time left, and the account is not used after it
urlstringyesThe sign-in page, or any page of the site
windowstring–Which window. chrome (default): the user's normal Chrome — Google and other sign-in buttons work, but a sign-in cookie that lasts only until the browser closes is lost. playwright: keeps such cookies…

No output schema declared.

No examples provided.

open_visit ~70

Start a visit as one virtual user from people.json. Returns a visit_id and what you see first. You ARE this person from now on. If it says the site is blocking us, stop and report that.

NameTypeReqDescription
personstringyesThe person's number from people.json, e.g. p3

No output schema declared.

No examples provided.

path_check ~54

Walk the recorded path again in a fresh browser: every clicked element must still be found at its recorded position with the same text, and every page must be reached. Lists the screenshots to show the user. Required before path_save.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

path_click ~112

Click a numbered element from the latest screen. By default it becomes a step of the path (the element is recorded; a new page reached is recorded too). record=false for clicks that are not part of the route (closing a cookie banner) — they are still repeated by path_check. press=false records the element as the final click without pressing it (a Pay or Submit button the safety guard will not press).

NameTypeReqDescription
indexintegeryes–
pressboolean––
recordboolean––

No output schema declared.

No examples provided.

path_pattern ~85

Make a page step match any page of its kind: /notice/6553c3ba → /notice/:id. Use when participants would open a different item than the one you did (the route reads from the code). Applies to every step on that page.

NameTypeReqDescription
stepintegeryes–
urlstringyesPath pattern with :name for the changing parts

No output schema declared.

No examples provided.

path_save ~107

Upload the checked path to the dashboard, replacing the task's expected path. Only after the user approved it. success: keep (default) leaves the task's success condition; page = done on reaching the last page of the path; click = done on the last recorded click. With page or click the saved path ends at that point (later steps are left out: the task ends there, so nobody could reach them). Ask the user before changing it.

NameTypeReqDescription
successstring––

No output schema declared.

No examples provided.

path_scroll ~23

Scroll the recording page to see more.

NameTypeReqDescription
directionstring––

No output schema declared.

No examples provided.

path_start ~147

Open a fresh browser on the page where the task's intended route begins and start recording its expected path. The page itself is step 1. Starting again discards the recording in progress.

NameTypeReqDescription
accountstring–Demo account saved by login (a1 …) if the route needs a signed-in user
devicestring––
taskstringyesTask id from path_tasks · plan-<n> for task n of a research not saved yet (new-research) · draft:<draft>:<index> for a saved draft
urlstringyesFull URL where the route starts — the local dev server is fine; only paths are saved

No output schema declared.

No examples provided.

path_tasks ~98

List the tasks of a Usercase research (from the dashboard) and whether each already has an expected path. Call first in the path procedure. If you have not read the path procedure yet, call the instructions tool with command path first.

NameTypeReqDescription
researchstringyesThe research id, or its name as the user said it (the server finds it by name; if several or none match, it lists them — ask the user which one)

No output schema declared.

No examples provided.

path_type ~46

Type into a numbered field (a search box, a quantity). Not a path step, but repeated by path_check.

NameTypeReqDescription
indexintegeryes–
textstringyes–

No output schema declared.

No examples provided.

question_check ~50

Run a condition over this project's recent visits: how many it matches, grammar problems, overlap with existing questions, and what matched visitors did. Repeat until there are no problems.

NameTypeReqDescription
conditionobjectyes–

No output schema declared.

No examples provided.

question_context ~63

Screens and element words from this project's recent real visits. Call first in the question procedure, before writing a condition — page globs and click targets must match what visitors actually saw. If you have not read the question procedure yet, call the instructions tool with command question first.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

question_save ~213

Save the question as a DRAFT in the dashboard Inbox, after the user approved it. The server checks the condition again and refuses it if there are problems. Nobody sees it until someone turns it on.

NameTypeReqDescription
acceptWarningsboolean–true only after the user said to save even though it does not match recent visits
allowOtherboolean–Let visitors write their own answer (choice only). Default true
answerTypestring––
choicesarray–For choice: 2–6 choices, exactly one with noProblem: true
conditionobjectyes–
questionstringyesEnglish, under 15 words. Asks about this moment
titlestring–English, a few words, for the Inbox
triggerEnstring–English. One plain sentence: when and in what situation it appears. No paths or class names
whystring–English. What the team wants to learn, shown in the Inbox

No output schema declared.

No examples provided.

report_finding ~150

Read one finding of a Usercase research report with all its evidence: why, who, the screen checks from the recordings, the paths people took, what they wrote, and the suggested changes. Read it before looking for the code. If you have not read the fix procedure yet, call the instructions tool with command fix first.

NameTypeReqDescription
audiencestring–Which report: virtual users (default) or real people
findingstringyesFinding key, e.g. F1
researchstringyesThe research id, or its name as the user said it (the server finds it by name; if several or none match, it lists them — ask the user which one)

No output schema declared.

No examples provided.

report_findings ~125

List the findings of a Usercase research's latest report (key, severity, title, who, and whether one is being fixed). Use when the fix command has no finding key. If you have not read the fix procedure yet, call the instructions tool with command fix first.

NameTypeReqDescription
audiencestring–Which report: virtual users (default) or real people
researchstringyesThe research id, or its name as the user said it (the server finds it by name; if several or none match, it lists them — ask the user which one)

No output schema declared.

No examples provided.

report_fix ~245

Record on the research report that you are fixing a finding (status fixing, once the user approved the change) or have fixed it (status fixed, with the files, a one-sentence summary for the team, and the pull request link if any). If the last fix of this finding is already live on the site, this starts the next fix (fix 2, 3 …); otherwise it adds to the current one. The report compares people after each fix goes live with the version right before it.

NameTypeReqDescription
audiencestring–Which report: virtual users (default) or real people
filesarray–Repository paths of the files changed (or to be changed)
findingstringyesFinding key, e.g. F1
prUrlstring–Pull request link, if one was opened
researchstringyesThe research id, or its name as the user said it (the server finds it by name; if several or none match, it lists them — ask the user which one)
statusstringyes–
summarystring–One sentence for the team: what visitors now see differently

No output schema declared.

No examples provided.

research_context ~83

What this project's data says is worth researching: open findings, where real visitors and virtual users left, what virtual users said when they left without getting what they came for, and the researches and drafts that already exist. Call first in the new-research procedure. If you have not read the new-research procedure yet, call the instructions tool with command new-research first.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

research_save ~311

Save the research as a DRAFT in the dashboard Inbox, after the user approved it. It becomes a research only when someone creates it there. Paths are page paths starting with / (no host), with :name for the parts that change. Expected paths recorded and saved beforehand as plan-<n> (n = the task's position in tasks, from 1) are uploaded with it.

NameTypeReqDescription
basisstringyesWhat the research came from: real visitor data, virtual user data, or neither (the user's question or the code)
findingIdsarray–Ids of the findings it answers, from research_context
hypothesesarray–Team only, never shown to participants: what the team expects to go wrong, one per item, 1–3 usually. The report judges each one. Each must be something these tasks can confirm or rule out
inviteobject––
minutesinteger–Minutes the whole session takes (tasks and questions). Shown on the invite card and the start screen
purposestringyesShown to participants (invite card and start of the study): one or two sentences, in their words, on what they will help with. Never the team's evidence, suspicions or hypotheses
questionsarray–Asked after all tasks
start_screenobject–What participants read before the first task
tasksarray––
titlestringyesShort, for the team

No output schema declared.

No examples provided.

results ~54

Recent visit results (one summary per visit) and what the safety guard blocked. Call after each round of visitor sub-agents finishes — it also says whether the research run goes on to another round.

NameTypeReqDescription
limitinteger––

No output schema declared.

No examples provided.

save_people ~175

Save virtual users to .usercase/people.json (adds to what is there). People have no names — like real visitors; each gets a number (p1, p2…) to refer to them by. Make people who would really come to this site — varied goals, devices, arrival paths, and states of mind. Do not make everyone a perfect fit for one feature. Show the list to the user before running visits.

NameTypeReqDescription
peoplearrayyes–
researchstring–Only when the run takes part in a research — its id, as path_tasks shows it: everyone saved in this call takes part in it
sitestringyesSite origin the visits go to
site_aboutstringyesOne or two English sentences on what the site is, as a visitor would understand it

No output schema declared.

No examples provided.

set_writes ~144

Choose whether visitors' writes reach the site: signing up, posting, commenting, saving, liking. 'block' (the default) sends nothing to the site; 'send' lets those through for real. Only the user can decide this — ask them, and only call this with their answer. 'send' suits a test or staging site, or data that may be messed up; on a live site real users will see what visitors post. Payments, deleting, wallet connections and sign-out stay blocked either way. Saved in .usercase/settings.json.

NameTypeReqDescription
modestringyesblock = nothing is sent to the site; send = writes really reach the site

No output schema declared.

No examples provided.

setup ~69

Install the visitor sub-agent definition (Claude Code: ~/.claude/agents/, Codex: ~/.codex/agents/ — user-wide, nothing is added to the repository) so visitors can be started. Run once if that agent type is not available. The user may need to restart Claude Code afterwards.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

steps_brief ~80

What is in the user's Several steps window: whether the card is a question or a research invite, the page under Where, and the words they wrote. Call first in the steps procedure. If you have not read the steps procedure yet, call the instructions tool with command steps first.

NameTypeReqDescription
sessionstringyesThe window id from the dashboard command

No output schema declared.

No examples provided.

steps_send ~125

Send the condition back to the user's Several steps window (a question or a research invite), after question_check shows no problems. The server checks it again and refuses it if there are problems. The user saves it there.

NameTypeReqDescription
acceptWarningsboolean–true only after the user said to send it even though it does not match recent visits
conditionobjectyes–
sessionstringyesThe window id from the dashboard command
triggerEnstringyesEnglish. One plain sentence: when and in what situation it appears. No paths or class names

No output schema declared.

No examples provided.

Install

How do I install the Usercase MCP server?

Usercase runs locally as an npm package, launched with npx -y @usercase/mcp. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

npm · @usercase/mcp

# add to Claude Code
claude mcp add io-usercase-mcp -- npx -y @usercase/mcp
Common questions

What is the Usercase MCP server?

Usercase is an MCP server listed in the public MCP registry as io.usercase/mcp. Ask real users on your site and run virtual users in a real browser, then fix what they hit. This page covers its npm package (@usercase/mcp).

Is the Usercase MCP server safe to use?

Usercase scores 64 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 21 November 2026. It declares no install or post-install scripts. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

What tools does the Usercase MCP server expose?

Usercase exposes 34 tools: check_site, install_snippet, save_people, list_people, results, and 29 more. Their descriptions and schemas cost roughly 4,473 tokens of context every time the server is loaded.

Is the Usercase MCP server still maintained?

Usercase is still listed as active in the MCP registry. We last reached this channel on 21 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

What licence is the Usercase MCP server under?

Usercase declares the UNLICENSED licence, which is not on the OSI-approved list. Read the terms before using it at work, and note this covers the source only, not the cost of any service it calls.

What did VerifyMCP test on the Usercase MCP server?

VerifyMCP ran 15 checks on Usercase, covering Malware scan, Known CVEs, Install scripts, Dependency health and 11 more. One item could not be completed, a gap on our side rather than a finding about Usercase: Security disclosure. Endpoint Security and Transport & Reachability do not apply to an npm package, so they were not tested. The score does not measure everything, and the scoring documentation lists what it leaves out.