Usercall MCP server

Usercall MCP - AI agents that run real user interviews

AI can build products. But it still doesn't talk to users.

Give your AI agents the ability to ask real users why.

Usercall MCP lets AI agents run user interviews via voice or text and return structured insights with themes and verbatim quotes.

Why this exists

AI agents can now build and ship products extremely quickly.

But most agents still rely on synthetic feedback or assumptions about users.

Usercall MCP lets agents gather real qualitative feedback directly from users.

Choose a connection

Recommended: hosted MCP (Claude, ChatGPT, Cursor, Grok Bot)

Add https://mcp.usercall.co as a remote MCP connector / custom connector.

• OAuth sign-in (no API key, no npx)
• Same tools as this package (studies + Research Triggers)
• Docs: app.usercall.co/docs/mcp
• Cursor Directory / Grok Bot: this repo ships .mcp.json so cursor.directory can install the hosted connector. Grok Bot cannot run the local npx package.

This package: local / API-key / machine-to-machine

Use @usercall/mcp over stdio when you want a Bearer API key (scripts, local clients, M2M).

1. Sign in at app.usercall.co → Home → Developer → Create API key
2. Run npx -y @usercall/mcp with USERCALLAPIKEY

Example workflow

Agent: "Why are users confused about onboarding?"

→ create_study
→ share interview_link with users
→ get_study_results

The returned interview_link can be shared with participants through email, Slack, Discord, or in-product prompts.

Example result:

{
  "themes": [
    {
      "name": "Onboarding confusion",
      "summary": "Users struggled to understand the second step.",
      "quotes": [
        "I wasn't sure what the app was asking me to do.",
        "I didn't know I had to verify my email before continuing."
      ]
    },
    {
      "name": "Pricing confusion",
      "summary": "Free plan limits were not clearly communicated.",
      "quotes": ["I wasn't sure if the free plan included analytics."]
    }
  ]
}

How it works

AI Agent

Usercall MCP (hosted OAuth or this stdio package)

Usercall Agent API

Real user interviews

Themes and verbatim quotes returned to the agent

With Research Triggers, the agent can also target users in your product:

Analytics MCP (PostHog, Mixpanel, …) finds a behavior

Usercall MCP creates a study and a paused Research Trigger

You activate it in Usercall

The Usercall SDK invites matching users to an interview right after the behavior

Research Triggers

Analytics tells an agent what users do. Research Triggers let it ask them why.

User:  "Look at our PostHog data and find something worth investigating."

Agent (PostHog MCP):  users who test a study rarely launch one.

Agent (Usercall MCP):
  list_trigger_events()                  → study_tested, study_launched, …
  get_trigger_event_schema("study_tested")
                                         → properties: source, interview_type
                                           traits: plan ("free", "pro"), account_type
  create_study(...)  or  list_studies()
  create_research_trigger({
    study_id, event_name: "study_tested",
    traits: { plan: "free" }, sampling_percent: 25, max_invites_per_day: 10
  })                                     → status: "paused", summary, activation_url

Shortened. The full README is on GitHub.