MCP tools reference

The server exposes ten tools. Every tool only sees the account that connected. IDs come from the list tools.

#list_sites

Lists the account’s sites: id, name, domain, type (web, ios, android, react-native) and site_key. No parameters.

#get_embed_snippet

Returns the <script> tag for a web site plus install instructions. Errors for app sites, which use an SDK instead.

#list_walkthroughs

Lists a site’s tours with id, name, page_pattern, active and step_count.

#get_walkthrough

Returns one tour’s full configuration: every step and every setting.

#create_walkthrough

Creates a tour. It’s created inactive unless active: true is passed. Fails if the account is at its plan’s walkthrough limit.

#update_walkthrough

Changes only the fields you pass. Passing steps replaces the whole step list. active publishes or unpublishes. null clears nullable fields.

#display_conditions object

{
  "elementConditions": [
    { "selector": "[data-tour=\"plan\"]", "rule": "visible" }   // exists | not_exists | visible | not_visible
  ],
  "elementLogic": "and",                                         // and | or
  "priorTourConditions": [
    { "tourId": "<walkthrough id>", "rule": "completed" }        // seen | completed
  ],
  "priorTourLogic": "and",
  "deviceTarget": "desktop",                                     // all | mobile | desktop
  "dateRange": { "from": "2026-12-01", "to": "2026-12-31" }      // either bound optional
}

#splash_carousel object

{
  "slides": [
    { "title": "Welcome", "description": "…", "imageUrl": "https://…", "logoUrl": "https://…" }
  ],
  "maxShows": 1    // per visitor; null = no limit
}

#delete_walkthrough

Permanently deletes a tour. Refuses if the tour is live — deactivate it first with update_walkthrough. This can’t be undone.

#get_styles

Returns the site’s styles JSON.

#update_styles

Deep-merges changes into the styles, section by section — sections you don’t pass are untouched.

#get_analytics

Event totals for one tour — guide_shown, guide_started, guide_completed, guide_abandoned — and step_viewed counts per step.