MCP Tools Reference

The UserHero MCP server provides tools organized by resource type. All tools respect your workspace role permissions.

Workspaces

list_workspaces

List all workspaces you have access to.

Parameters: None

Returns: Array of workspaces with id, name, plan, and your role

Example prompt:

"Show me all my UserHero workspaces"

get_workspace

Get detailed information about a specific workspace.

Parameters:

Returns: Workspace details including members, plan, and settings

get_workspace_usage

Get usage statistics and plan limits for a workspace.

Parameters:

Returns: Current usage, limits, and billing period info

Example prompt:

"How much of our feedback quota have we used this month?"

Projects

list_projects

List all projects in a workspace.

Parameters:

get_project

Get project details including privacy settings.

Parameters:

create_project

Create a new project. Requires member role or higher.

Parameters:

Example prompt:

"Create a new web project called 'Marketing Site' for domain marketing.example.com"

update_project

Update project settings. Requires member role or higher.

Parameters:

delete_project

Delete a project and all its data. Requires admin role or higher.

Parameters:

Widgets

list_widgets

List all widgets in a project.

Parameters:

get_widget

Get widget configuration details.

Parameters:

create_widget

Create a new feedback widget. Requires member role or higher.

Parameters:

Available templates:

• feedback - General feedback form
• bug-report - Bug report with screenshot
• rating - Star rating
• nps - Net Promoter Score (0-10)
• satisfaction - Customer satisfaction
• feature-request - Feature requests
• contact - Contact form

Example prompt:

"Create a floating NPS widget called 'Monthly Survey'"

update_widget

Update widget configuration. Requires member role or higher.

Parameters:

delete_widget

Delete a widget. Requires admin role or higher.

Parameters:

Feedback

list_feedback

List feedback with optional filters.

Parameters:

Example prompt:

"Show me all unresolved bug reports from the last week"

get_feedback

Get full feedback details including internal notes.

Parameters:

update_feedback_status

Update feedback status. Requires member role or higher.

Parameters:

Example prompt:

"Mark feedback abc123 as resolved"

add_note

Add an internal note to feedback. Requires member role or higher.

Parameters:

Example prompt:

"Add a note to feedback abc123 saying 'Fixed in release 2.1.0'"

delete_feedback

Delete a feedback item. Requires admin role or higher.

Parameters:

Integrations

list_integrations

List integrations for a project.

Parameters:

create_integration

Create a new integration. Requires admin role or higher.

Parameters:

Slack config:

{
  "webhookUrl": "https://hooks.slack.com/...",
  "channel": "#feedback"
}

Email config:

{
  "emails": ["team@example.com"]
}

Webhook config:

{
  "url": "https://api.example.com/webhook",
  "secret": "whsec_..."
}

delete_integration

Delete an integration. Requires admin role or higher.

Parameters:

Permission Requirements