Usertour MCP Server: Setup for Claude, Cursor and Other Apps

• Lists flows, checklists, banners and more

  Lists content in the project and filters by name, type, published state or date. Deleted content is listed on request.

  Try: “Show all published flows.”

  Network · list_content

• Reads one piece of content

  Returns content by id, with its draft and published versions and a link to review it in the dashboard.

  Try: “Open the Create Task flow.”

  Network · get_content

• Finds why content is not showing

  Checks a piece of content and reports problems that could keep it from reaching users.

  Try: “Why is my welcome flow not showing?”

  Network · diagnose_content

• Lists custom user and company fields

  Lists the attributes defined for users, companies, memberships and events, with filters by name and scope.

  Try: “What user attributes do we track?”

  Network · list_attribute_definitions

• Reads one attribute definition

  Returns one attribute definition by id.

  Try: “Show the plan attribute.”

  Network · get_attribute_definition

• Lists tracked events

  Lists the event catalog and filters by name.

  Try: “Which events do we track?”

  Network · list_event_definitions

• Reads one event definition

  Returns one event with its attached attributes.

  Try: “Show the project_created event.”

  Network · get_event_definition

• Lists your tracked end users

  Lists the end users in an environment, with filters by email, company, segment or date.

  Try: “Find users from company Acme.”

  Network · list_users

• Reads one end user

  Returns a user by their external id, including companies and roles.

  Try: “Show the user with id 123.”

  Network · get_user

• Finds why a user sees or misses content

  Checks a user and explains what content they qualify for and why.

  Try: “Why did user 123 not see the tour?”

  Network · diagnose_user

• Lists your style themes

  Lists the project's themes with whether each is the default and how many variations it has.

  Try: “What themes do we have?”

  Network · list_themes

• Reads one theme

  Returns a theme and optionally its stored or resolved style settings.

  Try: “Show the colors of the default theme.”

  Network · get_theme

• Shows what still uses an item

  Lists everything that uses an attribute, event, segment, theme or content. Run it before deleting.

  Try: “What uses the plan attribute?”

  Network · list_references

• Lists the versions of a content

  Lists a content's versions in order. It does not mark which one is live.

  Try: “Show the versions of the welcome flow.”

  Network · list_content_versions

• Shows who published what and when

  Returns the permanent publish and unpublish record for a content, with person, version and environment.

  Try: “Who published the checklist last?”

  Network · list_publish_history

• Reads one version of a content

  Returns a version by id, and can include its steps, data, questions and translations.

  Try: “Show the steps of version 3.”

  Network · get_content_version

• Checks a draft before publishing

  Runs the same checks as publishing without changing anything and lists errors and warnings.

  Try: “Is this draft ready to publish?”

  Network · validate_content_version

• Lists tracked companies

  Lists companies in an environment, filtered by segment or date.

  Try: “List companies created this month.”

  Network · list_companies

• Reads one company

  Returns a company by external id, with users and memberships on request.

  Try: “Show company Acme.”

  Network · get_company

• Lists audience segments

  Lists the project's user and company segments.

  Try: “What segments exist?”

  Network · list_segments

• Reads one segment

  Returns a segment with its conditions, and optionally how many members it has.

  Try: “How many users are in the Trial segment?”

  Network · get_segment

• Lists content sessions

  Lists sessions of content shown to users, filtered by content, user, completion or date.

  Try: “Show sessions of the welcome flow.”

  Network · list_sessions

• Reads one session

  Returns a session, and can include its content, user, company, version and answers.

  Try: “Show the answers in session abc.”

  Network · get_session

• Shows how content performs

  Returns starts, completions and per-step results for a content. The shape depends on the content type.

  Try: “How is the onboarding flow performing?”

  Network · get_content_analytics

• Shows survey results

  Returns the answers to each survey question, including NPS and ratings.

  Try: “What is the NPS from our survey?”

  Network · get_content_question_analytics

• Ranks which content is used most

  Shows all content in one table ranked by unique users.

  Try: “Which content is used most?”

  Network · get_usage_overview

• Lists languages

  Lists the project's languages and which one is the source.

  Try: “Which languages do we support?”

  Network · list_localizations

• Reads a translation of a version

  Returns the text units of one language of a content version, with source and current translation.

  Try: “Show the French translation of the flow.”

  Network · get_version_localization

• Reads one environment

  Returns one environment by id.

  Try: “Show the production environment.”

  Network · get_environment

• Creates new content

  Creates a flow, checklist, launcher, banner, tracker, resource center or announcement with a draft version.

  Try: “Create a flow for the Create Task feature.”

  Write · create_content

• Renames content

  Changes a content's name or build URL.

  Try: “Rename the flow to Welcome tour.”

  Write · update_content

• Deletes content (recoverable)

  Soft-deletes a content. It refuses while the content is published anywhere, so unpublish first. restore_content brings it back as an unpublished draft.

  Try: “Delete the old banner.”

  Delete · delete_content

• Brings back deleted content

  Restores soft-deleted content as an unpublished draft.

  Try: “Restore the banner I deleted.”

  Write · restore_content

• Writes steps and rules to a draft

  Replaces the full step list and start or hide rules of a draft version. Steps left out are deleted.

  Try: “Add three tooltip steps to the draft.”

  Delete · update_content_version

• Starts an editable draft

  Returns the current draft or forks a new one when the current version has been live.

  Try: “Start a new draft of the welcome flow.”

  Write · create_content_version

• Forks an old version into a draft

  Copies an earlier version forward as a new draft. It does not change what users see.

  Try: “Restore version 2 as a draft.”

  Write · restore_content_version

• Writes translations

  Saves translations for one language of a version and can switch its delivery on or off.

  Try: “Translate this flow into Spanish.”

  Write · update_version_localization

• Copies content

  Copies a content's current draft into a new unpublished content.

  Try: “Duplicate the welcome flow.”

  Write · duplicate_content

• Makes a version live

  Publishes a version in an environment so real users see it. You must name the environment when you have several.

  Try: “Publish version 3 to production.”

  Write · publish_content

• Takes content off live

  Clears an environment's live version. The version stays and can be republished.

  Try: “Unpublish the banner in production.”

  Write · unpublish_content

• Creates or updates a user

  Creates or updates an end user by external id and merges attributes.

  Try: “Set plan to pro for user 123.”

  Write · upsert_user

• Deletes a user

  Permanently deletes an end user by external id, with their sessions, events, answers, company memberships and segment membership. The source has no restore tool for it.

  Try: “Delete user 123.”

  Delete · delete_user

• Creates or updates a company

  Creates or updates a company by external id and merges attributes.

  Try: “Set the size of Acme to 50.”

  Write · upsert_company

• Deletes a company

  Permanently deletes a company by external id, with its user memberships and segment membership. The source has no restore tool for it.

  Try: “Delete company Acme.”

  Delete · delete_company

• Adds a user to a company

  Adds a user as a member of a company with a role.

  Try: “Add user 123 to Acme as admin.”

  Write · add_company_member

• Removes a user from a company

  Removes a user from a company. The membership and its attributes, such as a role, are deleted for good.

  Try: “Remove user 123 from Acme.”

  Delete · remove_company_member

• Creates a segment

  Creates a manual segment with a member list or a condition segment with rules.

  Try: “Create a segment of trial users.”

  Write · create_segment

• Edits a segment

  Changes a segment's name or rules.

  Try: “Rename the Trial segment.”

  Write · update_segment

• Deletes a segment

  Deletes a segment. It is refused while something still uses it.

  Try: “Delete the old segment.”

  Delete · delete_segment

• Brings back a segment

  Restores a deleted segment.

  Try: “Restore the Trial segment.”

  Write · restore_segment

• Adds a member to a segment

  Adds users or companies to a manual segment.

  Try: “Add user 123 to the beta segment.”

  Write · add_segment_member

• Removes a member from a segment

  Removes users or companies from a manual segment.

  Try: “Remove user 123 from the beta segment.”

  Write · remove_segment_member

• Creates a theme

  Creates a theme from a neutral default with the colors, fonts and sizes you set.

  Try: “Create a dark theme.”

  Write · create_theme

• Edits a theme

  Changes a theme's settings. Content using it changes appearance.

  Try: “Change the primary color to blue.”

  Write · update_theme

• Copies a theme

  Copies a theme with all settings and variations into a new theme.

  Try: “Duplicate the default theme.”

  Write · duplicate_theme

• Deletes a theme

  Deletes a theme. It is refused while content uses it.

  Try: “Delete the unused theme.”

  Delete · delete_theme

• Brings back a theme

  Restores a deleted theme.

  Try: “Restore the dark theme.”

  Write · restore_theme

• Adds a language

  Adds a language that content can be translated into.

  Try: “Add French.”

  Write · create_localization

• Edits a language

  Renames a language or changes its tag or code. Changing the code takes effect on live content at once: users whose locale does not match the new code see the source language.

  Try: “Rename the French entry.”

  Write · update_localization

• Removes a language

  Soft-deletes a language: it stops being delivered at once and users of that language see the source language. The translations are kept and restore_localization brings them back. The default language cannot be deleted.

  Try: “Remove Spanish.”

  Delete · delete_localization

• Brings back a language

  Restores a deleted language.

  Try: “Restore Spanish.”

  Write · restore_localization

• Defines a custom attribute

  Defines a new attribute on users, companies, memberships or events.

  Try: “Add an attribute called plan.”

  Write · create_attribute_definition

• Edits an attribute definition

  Changes an attribute definition. Name and scope cannot change.

  Try: “Change plan to a list type.”

  Write · update_attribute_definition

• Deletes an attribute definition

  Deletes an attribute. It is refused while something uses it.

  Try: “Delete the old attribute.”

  Delete · delete_attribute_definition

• Brings back an attribute

  Restores a deleted attribute definition.

  Try: “Restore the plan attribute.”

  Write · restore_attribute_definition

• Defines a custom event

  Defines a new tracked event.

  Try: “Add an event called project_created.”

  Write · create_event_definition

• Edits an event definition

  Changes an event's display name or description, and can attach attributes to it. The code name is fixed.

  Try: “Attach plan to project_created.”

  Write · update_event_definition

• Deletes an event definition

  Deletes an event. It is refused while something uses it.

  Try: “Delete the old event.”

  Delete · delete_event_definition

• Brings back an event

  Restores a deleted event definition.

  Try: “Restore project_created.”

  Write · restore_event_definition

• Ends a running session

  Ends an in-progress session. Ending an ended one changes nothing.

  Try: “End session abc.”

  Write · end_session

• Deletes a session

  Permanently deletes a session, so a single-session item such as a banner can be tested again. Its answers disappear from survey analytics and there is no restore.

  Try: “Delete my banner session so I can retest.”

  Delete · delete_session

• Creates an environment

  Creates an environment in the project. The first one becomes primary.

  Try: “Create a staging environment.”

  Write · create_environment

• Edits an environment

  Renames an environment.

  Try: “Rename staging.”

  Write · update_environment

• Deletes an environment

  Deletes an environment. The primary or last environment cannot be deleted.

  Try: “Delete the test environment.”

  Delete · delete_environment

• Lists webhooks

  Lists outbound webhooks for an environment. Signing secrets are not shown.

  Try: “Which webhooks are set up?”

  Network · list_webhooks

• Creates a webhook

  Creates an outbound webhook that posts matching events to your URL. The signing secret is shown once. Cloud needs a paid plan.

  Try: “Send completed events to https://example.com/hook.”

  Write · create_webhook

• Edits a webhook

  Changes a webhook's URL, topics, on/off state or description.

  Try: “Disable the webhook.”

  Write · update_webhook

• Deletes a webhook

  Deletes a webhook and its delivery log.

  Try: “Delete the old webhook.”

  Delete · delete_webhook

• Used by the assistant behind the scenes

  Reads Usertour's rules for building content

  Returns the authoring guide: the create, update, validate and publish steps and what each content type needs. The assistant reads it before building.

  Try: “How do I author a flow in Usertour?”

  Network · get_authoring_guide

• Shows the shape of content you can write

  Returns the JSON Schema for the steps or data of a content type, so the assistant writes valid content.

  Try: “What fields does a checklist accept?”

  Network · get_content_schema

• Shows which theme settings you can change

  Returns the writable theme settings with their ranges, so edits are valid.

  Try: “What can I set on a theme?”

  Network · get_theme_schema

• Lists your environments

  Lists the environments and whether your credential can act on each.

  Try: “Which environments can I publish to?”

  Network · list_environments

Watch out for

• It can publish content to real users

  publish_content makes a version live in an environment. Ask the assistant to validate first, and name the environment yourself. github.com

• It can delete users, companies and content

  delete_user and delete_company are permanent: the source deletes the rows, and a user's sessions, events and answers go with them. Content, segments, themes, attributes, events and languages are soft-deleted and have restore tools. Sessions, webhooks (with their delivery log) and company memberships are deleted for good, and the source describes no restore for environments. github.com

• Editing steps replaces the whole step list

  update_content_version treats the steps as complete, so any step left out is deleted. Review the draft before publishing. github.com

Security advisories