Documentation

Choose the job you want to complete. Each link goes directly to the focused guide or reference.

Start in the dashboard

Take the shortest path from account setup to a live study.

• Open the dashboard — create or choose a project.
• Quickstart — Set up a project and launch your first study from the dashboard.
• Studies — Create, activate, pause, and operate studies.

Embed the widget

Add participant-facing interviews to your product.

• Widget Integration — Embed the interview widget and configure its runtime behavior.
• Study Runtime — Understand talk, observe, and scripted speak segments at runtime.
• AI-Moderated User Interviews In Your Product — Plan an in-product interview experience around the embedded widget.

Connect MCP

Give an MCP-compatible agent access to UserTold workflows.

• MCP Integration — Connect an MCP client and discover tools, resources, and prompts.

Use CLI automation

Run repeatable, machine-readable workflows from a shell or coding agent.

• CLI Reference — Automate auth, project setup, studies, and evidence workflows.

Integrate REST and OpenAPI

Build directly against the HTTP API and generated schema.

• OpenAPI schema — inspect the generated endpoint contract.
• API Reference — Use the stable REST contract, errors, retries, and webhook workflows.

Authenticate an agent

Choose the correct credential flow for autonomous access.

• Agent authentication protocol — register, claim, and use agent credentials.

Design studies

Choose a research method and turn it into a focused study.

• Methodology — Apply the evidence-first research principles behind UserTold interviews.
• Study Design Guide — Turn a research goal into a valid, focused study script.
• Research Script Templates — Adapt practical scripts for common product research questions.
• Participant Consent — Design a clear consent experience before recording begins.
• AI Usability Testing With Real Users — Design observation studies that preserve moments of user friction.
• Learn Why Users Switch — Design interviews that uncover switching decisions and tradeoffs.

Understand evidence to delivery

Follow the path from recorded user reality to reviewed and shipped work.

• Glossary — Look up the shared vocabulary used across interviews, evidence, and delivery.
• Core Concepts — Understand how interviews become evidence, reviewed work, and delivery.
• Agentic User Research — See the complete agentic research loop from interview to action.
• Interviews to Issues — Turn verified interview evidence into Linear and GitHub issues.
• Track Resolved Evidence — Keep shipped work connected to resolved evidence and recurrence review.
• Prioritize Fixes With Evidence — Review source-linked evidence before deciding what to ship.