The User Intuition MCP server brings customer research into the AI conversation: design a study, approve recruitment, and retrieve interviews and cited findings.
This launch article’s setup and capability reference have been updated to the current published package, @userintuition-ai/mcp 0.9.0. Use the current catalog below when implementing an integration.
What is available now?
The package supports hosted Streamable HTTP with OAuth and local stdio with an API key. It also includes a CLI for the same research tools, browser login, and API-key management. Research skills guide agents through planning, fielding, monitoring, and analysis.
The six research tool groups
MCP exposes study planning, recruitment, interviews, results, evidence search, and supporting configuration operations. The CLI provides shell access to research workflows. Use the current tool catalog and API reference for exact names and arguments; tool counts vary by release.
| Group | Tools | What agents can do |
|---|---|---|
| Studies | 12 | Create and customize drafts, inspect and update metadata, launch or control fielding, delete a study, generate and retrieve its report |
| Participants | 5 | List, create, inspect and update participant records; send a requested reward |
| Interviews | 5 | List and inspect interviews, retrieve usage and participant-grouped records, delete an interview |
| Panel reference and feasibility | 4 | Discover country/language combinations; submit, list and retrieve feasibility requests |
| Webhooks | 2 | Create or delete completed-interview callbacks |
| Configuration catalogs | 5 | Discover languages, modes, study types, individual types and voices |
The study workflow connects the research brief to interviews, reports, and source references that the calling agent can inspect and reuse.
Agents can search findings and participant responses across authorized studies, then retrieve the underlying reports and interviews. Results preserve study context and source links; the calling agent interprets the evidence. Search coverage is explicit, and retrieving evidence does not launch research.
Connect your agent
Use the hosted endpoint, https://mcp.userintuition.ai/mcp, with OAuth in compatible clients. For local stdio, run npx -y @userintuition-ai/mcp with USERINTUITION_API_KEY set to your ui_sk_ key. The CLI supports browser login and API-key management. Hosted OAuth does not require exchanging a user-supplied API key.
For a local stdio client that uses an MCP configuration file:
{
"mcpServers": {
"userintuition": {
"command": "npx",
"args": ["-y", "@userintuition-ai/mcp"],
"env": {"USERINTUITION_API_KEY": "ui_sk_your_key_here"}
}
}
}
Keep real keys out of version control. For shell workflows:
npm install -g @userintuition-ai/mcp
userintuition-mcp login
userintuition-mcp list
userintuition-mcp list_studies
Start with a read such as list_studies to check your connection. See the current MCP setup guide for client-specific instructions and the research skills for workflow guidance.
Why agent-native research matters
A product agent can ask for evidence before writing a feature specification. A marketing agent can test a claim before drafting a campaign. A strategy agent can commission interviews when public sources leave a decision-critical question unanswered.
The researcher stays in the conversation to choose the audience, review the saved plan, and approve recruitment. The platform handles interview delivery and analysis. This makes research a practical step in an agent workflow while retaining the decisions that need human judgment.
Your first study
Create a metadata draft with create_study, then send the research brief through customize_study. Relay any planning questions to the user. Retrieve the persisted plan with get_study and obtain approval before recruitment. The user must choose panel or BYOP explicitly. For a panel study, use launch_panel with dry_run: true to obtain the recruitment estimate. Show the country, language, cost, and timeline; launch with the same settings after approval. Each launch specifies one country. Audiences below 10% incidence require a feasibility request.
Study results expose findings, participant responses, sample profiles, recommendations, and source references in JSON. Use generate_report when analysis is needed, and get_interview to verify supporting messages and recording links. Preference shares, credibility scores, and ranked themes are not guaranteed typed fields in this response.
The same account’s study records are available through the dashboard and supported research tools. The Customer Intelligence Hub remains available in the dashboard for broader research-library analysis.
Pricing
The MCP connection itself has no separate fee. Research uses platform credits, with panel recruitment priced separately in the estimate. User Intuition voice interviews cost $30 each with no subscription required. Recruitment is priced separately. Chat uses 0.5 credit, voice 1, and video 2 per interview. Three free interviews are available on signup; review recruitment charges before launching a panel study.
See current pricing and agentic research.