UserDelphiGet started →

Developer guide

Run user research from your coding agent

UserDelphi plugs into Claude Code, Cursor and Codex over MCP. Hand your agent a prototype link and it orders a study, watches it run, and pulls the synthesised insight back into your editor — without you leaving the terminal.

Overview

UserDelphi tests prototypes with real users (or realistic AI personas), runs an AI moderator that probes when something interesting happens, and turns the sessions into a decision-ready report: the one thing to fix, top issues with severity, and verbatim quotes.

For developers, all of that is drivable from chat through an MCP server. You connect once, then just talk to your agent: “get feedback on staging.myapp.com/checkout.”

Three ways to test

Pick the tier that matches how much signal you need:

InstantFree

AI personas

A panel of synthetic personas explores your prototype and answers your questions in ~a minute. A directional preview — clearly labelled, not real users.

LiveFree

Your own users

Get a share link and drop it to your beta list or Slack. Real humans, on your own audience, at no cost.

RecruitedPaid

Matched panel

Real, screened participants matched to your targeting. Priced per session in credits — get a free estimate first.

Instant and Live are free and available now. Recruited-panel estimates work today; paid ordering is rolling out — see Credits & pricing.

Connect your editor

1. Register the server. One line — nothing to clone or install. It runs straight from npm. No API key needed up front; you'll approve access in the browser.

Claude Code

claude mcp add userdelphi -s user \
  --env UD_BASE_URL=https://userdelphi.vercel.app \
  -- npx -y userdelphi-mcp

Cursor / Codex (mcp.json)

{
  "mcpServers": {
    "userdelphi": {
      "command": "npx",
      "args": ["-y", "userdelphi-mcp"],
      "env": { "UD_BASE_URL": "https://userdelphi.vercel.app" }
    }
  }
}

2. Restart your editor. MCP servers load when the editor starts — not when you add them — so quit and reopen (or start a new session). In Claude Code, run /mcp to confirm userdelphi is connected and showing its tools. The first launch downloads the package, so give it a few seconds.

3. Connect. Ask your agent to “connect to UserDelphi.” It prints a short code and a link — open the link, sign in, approve the code, and the key is saved locally. That's it.

Agent says it can't find UserDelphi? The server isn't loaded in that session — restart the editor (step 2) and check /mcp. If it still shows as failed, reset it and warm the cache so the first launch doesn't time out:claude mcp remove userdelphi -s user && npx -y userdelphi-mcp </dev/nullthen re-add and restart. Once the tools are listed you can also be explicit: “use the userdelphi connect tool.”

Prefer to manage the key yourself? Create one under Settings → API keys and pass it as UD_API_KEY instead of connecting.

Commands

Once connected, your agent has these tools. You rarely call them by name — just describe what you want and the agent picks the right one.

connect

Link this editor to your workspace via browser approval. Pair with connect_poll to finish.

launch_study

Order a study. mode: "instant" runs AI personas now; mode: "live" returns a share link for your own users.

instant_feedback

Run (or add more) AI-persona feedback on an existing study, right now.

estimate_study

Price a recruited-panel study (real, matched humans). Returns an itemised USD quote — free, nothing is charged.

list_studies

List your studies with status and report links.

get_study_report

Pull the synthesised insight — the one thing to do, top issues, themes — plus per-session analyses. The response includes a report_web_url you can open in a browser (the raw /api/…/report URL needs an API key).

Credits & pricing

Instant and Live studies are free. Synthetic personas cost nothing, and a share link to your own users costs nothing. You only pay to recruit real, matched participants.

Recruited panels are priced in credits (1 credit = 1 US cent). A study's price is built from a few factors:

  • Base — about $8 for a 5-minute prototype session with no targeting.
  • Session length — longer sessions cost more (5, 15, 20, 30 min).
  • Targeting — each requirement you add (region, occupation, industry, age, language…) adds a surcharge, capped at 3×.
  • Volume — 5%–20% off as you order more participants (5+, 10+, 20+, 50+).
  • Study type — task-based studies cost a bit more than open prototype feedback. There's a $25 order minimum.

Estimates are always free. Ask your agent “what would 10 recruited testers cost for this?” and it returns an itemised quote. For example, 10 testers · 20-minute session · targeting occupation + industry comes to $362.88 ($36.29 per completed session). You only ever pay for sessions that are actually delivered — unfilled slots are refunded.

Adding credits. Paid recruiting is in early access. Estimates work today; to fund a panel and join the pilot, reach out to the team — automated top-up (card) is rolling out next.

Example sessions

Instant feedback in a minute

You: Get feedback on my new checkout — https://staging.myapp.com/checkout
Agent: Running an instant study with 5 AI personas…
       Done. 3 of 5 missed the promo-code field — it reads as
       "apply discount". Here's the full report: …

Price a real panel before ordering

You: What would 10 real testers in tech, 20-min sessions, cost?
Agent: $362.88 for 10 completed sessions ($36.29 each) —
       targeting occupation + industry. Want me to order it?

Pull the report later

You: What's the top issue from the checkout study?
Agent: The promo-code field. 6 of 8 participants tried to use it
       as the coupon entry and got confused. Recommended fix: …

FAQ

Do I need an API key to start?

No. Run the connect flow and approve once in your browser — the key is created and stored for you. You can also create and paste a key manually from Settings → API keys.

Is the instant feedback from real people?

No — instant feedback is AI personas reacting to your prototype. It’s a fast, directional preview and is labelled as synthetic everywhere. Use Live or Recruited for real humans.

Do testers need to install anything?

No. They open a link in a desktop browser. Sessions record the screen and voice, so test-taking needs a computer (not a phone).

What do I get back?

A structured report: an executive summary, ranked issues with severity, recurring themes, sentiment, and verbatim quotes — grounded in the transcript and screenshots from the session.

Where does my data live?

Recordings are kept in private storage; reports are scoped to your company and only reachable with your API key. Synthetic studies never involve real participants.

Which models power it?

Claude runs the live moderator, the per-session analysis, the cross-session synthesis, and the synthetic personas.

Ready to try it? Create a workspace, then connect your editor.

Get started