MCP Hub
Back to servers

userdispatch

CLI installer for UserDispatch feedback widget + MCP server

npm266/wk
Stars
1
Updated
Mar 3, 2026

Quick Install

npx -y userdispatch

UserDispatch

UserDispatch beta

npm version npm downloads website docs license

Add a feedback widget to any web app in one command.
Your AI coding agent triages feedback, drafts PRs, and responds to users — via MCP.

UserDispatch — feedback widget + MCP server for AI coding agents


Quick start

npx userdispatch init

One command does everything:

  • Installs a feedback widget in your app (auto-detects framework)
  • Creates your org & app on userdispatch.com
  • Configures your AI coding agent with the MCP server
  • Sends a test submission to verify the full loop

Requires Node.js 18+. Full CLI reference: userdispatch.com/docs/cli

How it works

┌─────────────┐     ┌──────────────────┐     ┌─────────────────┐     ┌──────────────┐
│  1. User     │────▶│  2. Agent reads   │────▶│  3. Agent drafts │────▶│  4. Weekly    │
│  submits     │     │  via MCP          │     │  PRs, replies,   │     │  digest       │
│  feedback    │     │                   │     │  triage          │     │  summary      │
└─────────────┘     └──────────────────┘     └─────────────────┘     └──────────────┘
  1. User submits feedback — the widget captures feedback, bug reports, or questions with browser metadata and file attachments
  2. Agent reads via MCP — your coding agent pulls new submissions using the list_submissions and get_submission tools
  3. Agent proposes — triages issues, updates statuses, sends replies via email, and opens PRs informed by feedback patterns
  4. Weekly digest — the weekly-digest prompt generates a 7-day summary of submissions, trends, and actions taken

Framework support

The CLI auto-detects your framework and injects the widget into the right file.

FrameworkAuto-detectWidget injection
Next.js (App Router)Yes<Script> in app/layout.tsx
Next.js (Pages Router)Yes<script> in pages/_document.tsx
ViteYes<script> in index.html
Create React AppYes<script> in public/index.html
NuxtYesManual (nuxt.config.ts shown)
SvelteKitYes<script> in src/app.html
AstroYesManual (instructions shown)
Static HTMLYes<script> in index.html

Override with --framework <type>. Full guide: userdispatch.com/docs/widget

MCP server

UserDispatch hosts the MCP server at https://userdispatch.com/api/mcp. The CLI configures this automatically — or add it manually:

// .mcp.json (Claude Code, Cursor)
{
  "mcpServers": {
    "userdispatch": {
      "url": "https://userdispatch.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${USERDISPATCH_TOKEN}"
      }
    }
  }
}

Agent compatibility

AgentConfig fileAuto-configured
Claude Code.mcp.jsonYes
Cursor.cursor/mcp.jsonYes
Windsurf~/.codeium/windsurf/mcp_config.jsonYes
VS Code Copilot.vscode/mcp.jsonYes
Codex.codex/config.tomlYes
Claude Desktopclaude_desktop_config.jsonYes

Tools (17)

ToolDescription
list_submissionsList submissions with filters (app, type, status, date, search)
get_submissionGet full submission details with attachments and replies
update_submissionUpdate submission status
reply_to_submissionSend a reply via email or dashboard
delete_submissionPermanently delete a submission
list_appsList all registered apps
create_appCreate a new app
update_appUpdate app settings
delete_appDelete an app and all its submissions
rotate_app_keyRotate an app's API key
get_statsGet submission statistics
get_orgGet organization details
update_orgUpdate organization settings
list_membersList all organization members
invite_memberInvite a new member
update_memberUpdate member settings or role
remove_memberRemove a member

Plus 5 resources and 2 prompts (triage-submissions, weekly-digest). Full MCP reference: userdispatch.com/docs/mcp

Widget customization

<script
  src="https://userdispatch.com/widget.js"
  data-api-key="pk_your-api-key"
  data-position="br"
  data-trigger-label="Feedback"
  data-collect-email="true"
  data-collect-name="false"
  data-enable-logs="false"
  defer
></script>
AttributeRequiredDefaultDescription
data-api-keyYesYour app's API key (starts with pk_)
data-positionNo"br"Trigger button position: "br", "bl", "tr", "tl"
data-trigger-labelNo"Feedback"Text on the trigger button
data-collect-emailNo"true"Show email field. Set to "false" to hide.
data-collect-nameNo"false"Show name field. Set to "true" to enable.
data-enable-logsNo"false"Enable console log collector. Requires app-level setting.
data-api-urlNoAuto-detectedOverride the API base URL.

The widget renders in a Shadow DOM for full style isolation. Under 30KB gzipped. Full reference: userdispatch.com/docs/widget

CLI reference

npx userdispatch init [flags]
FlagDescription
--token <token>Skip browser auth and use this ud_ token directly. Auto-promotes to CI mode in non-TTY environments.
--org <name>Organization name (skips prompt).
--app <name>App name (skips prompt). Slug is auto-generated.
--framework <type>Override framework detection. Values: next-app, next-pages, vite, cra, nuxt, sveltekit, astro, static.
--agent <id>Override agent detection. Values: claude-code, cursor, windsurf, claude-desktop, vscode.
--ciNon-interactive mode. Skips all prompts, uses defaults or flag values.

Full CLI docs: userdispatch.com/docs/cli

Security

UserDispatch is built with security at every layer — nonce-based CSP, SHA-256 hashed API tokens, PostgreSQL-backed rate limiting, Zod input validation, parameterized SQL, and constant-time token comparison. File uploads are validated by MIME type and magic bytes.

Full security architecture: userdispatch.com/docs/security

To report a vulnerability, email security@kiruna.ai. Please do not open public issues for security reports.

Pricing

Every tier includes the full MCP server, all 17 tools, and the feedback widget.

FreeProTeamEnterprise
Price$0 forever$9/mo$49/moCustom
Submissions/mo1002502,500Unlimited
Users115Unlimited
Apps210UnlimitedUnlimited
Data retention3 monthsUnlimitedUnlimitedUnlimited
MCP server & 17 toolsYesYesYesYes
WidgetYesYesYesYes
Agent-sent emailsYesYesYesYes
Log captureYesYesYesYes
Custom brandingYesYesYes
Team rolesYesYes
SSOYes

Links

License

MIT — Kiruna Labs

Reviews

No reviews yet

Sign in to write a review