> For the complete documentation index, see [llms.txt](https://docs.supademo.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.supademo.com/customize/mcp-server.md). # MCP Server Connect Claude, ChatGPT, Cursor, and other AI assistants to Supademo over MCP to edit, personalize, and analyze demos, showcases, hubs, videos, and Demo Agents from a prompt. Includes setup steps and *** ### What is an MCP? How does it work with Supademo? The Supademo Model Context Protocol (MCP) server gives compatible AI assistants and agents a secure, standard way to work with the demos, showcases, Demo Hubs, Route Hubs, videos, and Demo Agents in your Supademo workspace. Tools like Claude, ChatGPT, or Gemini can then do demo work from a prompt: list demos, update hotspot or voiceover text, replace outdated screenshots, generate trackable links in bulk, organize folders, translate a demo into Spanish with voiceovers, publish a new version, build a Route Hub, or curate a Demo Hub. [AI Command](/customize/ai-command.md), the assistant inside Supademo, uses the same tools. If you would rather work inside the app than in an outside assistant, start there. ### Overview Most editing and personalization you can do in the Supademo editor is available through MCP, using Claude, ChatGPT, Gemini, and other assistants. {% hint style="info" %} **Here's an example LLM prompt that would update a Supademo via MCP:**\ \ Update this Supademo (cmewzomb200ci0m0jgnfi4xgm) by ensuring each step has a zoom applied to it, in variations of 70-100%, centered around the hotspot. Next, update the all of the hotspots to be black (#000) and change the hotspots to have a dark backdrop, and set the labels to be "Previous" and "Next" with a yellow (#FFC000) background color. {% endhint %} It is most useful for teams managing many demos across personas, use cases, regions, or funnel stages. {% embed url="" %} ### Who can use it The MCP server works for workspace Admins and Creators. When you connect an assistant, you sign in with your Supademo account and approve its access through OAuth. Connected assistants are listed under **Settings → API → Connected apps**, where you can revoke them. Individual tools follow your plan and enabled features. A tool for something your workspace doesn't have returns an error and changes nothing. *** ### Getting started #### 1. Configure
Claude Web/Desktop {% @supademo/embed url="" demoId="cmnyu0out23va1q1es93hmj4y" %} Supademo is listed in Claude's connectors, so no custom setup is needed. 1. Open [Claude.ai](https://claude.ai) in your browser and log into your account. 2. Click your **Profile** icon in the bottom-left corner. 3. Select **Settings > Connectors**. 4. Find/Search **Supademo** in the connectors list and click **Connect**. 5. Authenticate using your Supademo account. 6. Prompt it from the chat by text or voice.
Claude Code 1. Open a terminal and run: 
claude mcp add --transport http supademo https://mcp.supademo.com/mcp
(Add `--scope user` if you want it available across all your Claude Code projects. Default scope is local, i.e. this project only.) 2. Start (or restart) Claude Code in your project, then run the `/mcp` slash command. 3. In the `/mcp` panel, select **Supademo**, then choose **Authenticate**. Your browser opens Supademo's login and redirects back after OAuth completes. 4. Back in `/mcp`, confirm the status shows **connected**. Type `/` and you should see Supademo tools appear in autocomplete. 5. Prompt it in the chat, for example "list my Supademo workspaces" or "upload this image to my demo."
ChatGPT {% @supademo/embed url="" demoId="cmsrz3nic02hkqm3bncufvz0m" %} > Supademo is listed in ChatGPT's plugins, so Developer mode and custom app setup aren't needed. 1. In ChatGPT, click your **profile** (bottom-left of the sidebar) to open account settings. 2. Select **Settings**. 3. Open the **Plugins** tab. 4. Click **Browse plugins**. 5. Type **Supademo** into the search bar. 6. Click the **+** button next to Supademo to install it. 7. Click **Authorize** (or log in with your Supademo credentials when prompted) to connect ChatGPT to your Supademo account. 8. Supademo is now installed and ready to use. 9. Start a **New chat**, or use it in any chat by mentioning Supademo in your prompt or by clicking the **+ / Tools** picker in the composer and selecting Supademo.
Cursor 1. Open Cursor and press `Cmd + Shift + J` (macOS) or `Ctrl + Shift + J` (Windows/Linux) to open Cursor Settings. 2. In the sidebar, select **Tools & Integrations** (older builds: **Features → MCP**). 3. Click **+ Add Custom MCP** (or **New MCP Server**). This opens `~/.cursor/mcp.json` for editing. 4. Add the Supademo entry inside `mcpServers`, save, and close: 
{
     "mcpServers": {
       "Supademo MCP": {
         "url": "https://mcp.supademo.com/mcp"
       }
     }
   }
5. Back on the **Tools & Integrations** page, click the **Needs Login / Authenticate** button that appears next to "Supademo MCP". 6. A browser window opens on Supademo. Sign in and approve access. Cursor will redirect back automatically. 7. Confirm the entry shows a green dot and the Supademo tools appear under **Available Tools**. 8. Open the chat panel (`Cmd + L`), switch the mode selector to **Agent**, and prompt normally. Cursor will invoke Supademo tools as needed (asking for approval on each tool the first time).
Copilot 1. Go to the **Tools** page for your agent in Copilot Studio. 2. Select **Add a tool**. 3. Select **New tool**. 4. Select **Model Context Protocol**. The MCP onboarding wizard appears. 5. Fill in the required fields:\ Server name - Supademo MCP\ Server description - Edit Supademos using MCP\ Server URL - 6. Select the authentication type as **OAuth 2.0**. 7. Create and connect it to the agent.
#### 2. Create or choose a Supademo If you haven't already done so, create a Supademo by using the [Chrome Extension](https://chromewebstore.google.com/detail/supademo-ai-interactive-d/jblbcpkejogbghfdglhfjlplchcnmohm) or [Desktop App.](https://supademo.com/download) #### 3. Prompt AI
Once you have configured your MCP, you can: 1. Authenticate your IDE or LLM with Supademo 2. Prompt the agent and specify which demo you'd like to change by pasting in your Supademo's ID or link. 3. Approve any of the requests the agent makes or provide additional context as requested {% hint style="info" %} **Prompt tips** 1. Be as specific as you can be for the best results 2. Start with a small prompt (for example, changing a hotspot text in a single page, changing the description of a demo, or generating voiceovers). After that, you can move on to **chained prompts** that contain multiple requests in one query. **Example prompt** "For the demo cmnq9hezs0059kwxa0b09myai, update all of the hotspots to have black (#000) background, and make all the hotspot label backgrounds `#FFEA00`. Next, generate short voiceovers for each of the steps using 'Richard Yu' as the voice, but using shorter, direct variations of the existing hotspot for the voice." {% endhint %} #### 4. Review and tweak changes Review the changes made through MCP by refreshing your Supademo editor. From there, make further edits by prompting your AI or by using the visual Supademo editor. {% hint style="warning" %} **Important Note** Once you've applied changes via the MCP, be sure to do a **hard refresh (Command + Shift + R)** on your Supademo page. {% endhint %} #### 5. Give us feedback! Got an idea that would make Supademo MCP more useful for you? Drop it in the form below: {% @supademo/embed url="" demoId="cmnqfdeon00ksz60j7dvrgm2w" %} *** ### Available features in Supademo MCP The tables below list every tool the server offers, grouped by what it works on. Three groups only appear when the feature is enabled for your workspace: Route Hubs, Demo Agents, and showcase translations. #### Workspaces & Demos | Tool | What it does | Key capabilities | | ------------------------ | ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `list_workspaces` | List workspaces you have access to | Returns id, name, role, plan | | `get_workspace_settings` | Read workspace Global Settings | The defaults applied to demos, in the same groups as `update_demo_settings`, plus workspace-only fields (custom domain, favicon, custom font, watermark logo). Read-only | | `list_demos` | List demos in a workspace | Search by title, filter by folder, paginate, scope: `me` or `workspace` | | `get_demo` | Fetch full demo tree | Steps, hotspots, chapters, buttons, form fields, links, and every demo-level settings group | | `update_demo_settings` | Change demo-level settings | See the field groups under Edit Demo Settings | | `duplicate_demo` | Copy a demo with all content | Includes steps, hotspots, chapters, video projects, HTML edits, and translations | | `merge_demos` | Combine 2–50 demos into a new one | Source order sets step order; the original demos are not changed | | `move_demos` | Move demos within the workspace | To `Personal`, `Shared`, or a `Folder`; up to 100 per call | | `get_demo_embed_code` | Get iframe embed code for a demo | Matches the share dialog snippet, on your custom domain when one is set | #### Edit Demo Settings | Field group | What you can change | Example fields | | ----------------------- | ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | | **Title & state** | Rename, archive, restore | `title`, `archived` | | **Appearance** | Brand, watermark, layout | `color`, `font`, `darkmode`, `border`, `fullWidth`, `topBar`, `brandLogo`, `watermarkText`, `watermarkLink`, `showWatermark`, `mobileHotspotView` | | **Background** | Demo-level background | `background: { type, value }` with type Color, CustomColor, Gradient, Pattern, or Url | | **CTA** | Global call-to-action button | `text`, `color`, `textColor`, `link` | | **Behavior / Autoplay** | Playback controls | `autoplay`, `autoplayDuration`, `autoPlayDelay`, `loop`, `showPlayPause`, `progressBar`, `showPlayBar`, `nextButton`, `showSteps`, `customizePerStep` | | **Sharing** | Visibility & access | `shared`, `allowDuplicate`, `allowExternalComments`, `indexable`, `displayAuthor`, `displayDescription`, `domainURL`, `showSupademoLink`, `sendNotification` | | **Hotspot defaults** | Defaults for new hotspots | `textVisible`, `animationVisible`, `opacity` | | **Metadata / SEO** | Embed & preview metadata | `metaDescription`, `customMetadataImage`, `detectBrowserLanguage`, `showCCButton` | | **Audio** | Background music | `recordOwnVoice`, `backgroundMusicUrl`, `backgroundMusicVolume` | #### Versioning & Publishing Publish immutable demo versions, label them, roll back, or branch a new demo from any published version. Requires [demo versioning](/workspace-settings/demo-versioning.md) to be enabled for the workspace. | Tool | What it does | Key capabilities | | ----------------------------- | -------------------------------------------- | ------------------------------------------------------------------------------------------------- | | `publish_demo` | Publish the draft as a new immutable version | Auto-increments the version number and makes it live; doesn't change public/private visibility | | `list_demo_versions` | List published versions | Newest first; number, name, creator, and which version is currently live | | `get_demo_version` | Summary of one published version | Version metadata + per-step outline (text, chapter flag, hotspot count) | | `rename_demo_version` | Name/label a version | e.g. "Black Friday launch"; empty name clears the label | | `revert_demo_to_version` | Restore the draft to a previous version | Rewrites the editable draft only; optional `publishAfterRevert`; overwrites unsaved draft changes | | `duplicate_demo_from_version` | New demo from a specific version | Fully independent copy; stays private until visibility is changed | #### Steps | Tool | What it does | Key capabilities | | --------------- | ---------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `create_steps` | Add image, video, or chapter steps | Three step types: `image`, `video`, and `chapter`. An image step gets a default hotspot; a chapter step carries its buttons and form fields | | `update_steps` | Edit step content & display | `text`, `customDescription`, `image`, `mediaFitMode` (Cover/Contain), `mediaAlignMode` (Center/Top/Bottom/Left/Right), `backdrop` (None/Light/Dark), `playbackRate`, `duration`, `transition`, **zoom** (`zoomPositionX/Y`, `zoomWidth`; height is calculated; set all to null to remove) | | `delete_steps` | Remove steps (1–100 at once) | All or nothing; remaining steps are renumbered | | `copy_steps` | Copy steps | Same demo: copies the `stepIds` you name to the end. Across demos: copies every step from the source | | `reorder_steps` | Rearrange step order | Provide all step IDs in desired order | #### Hotspots | Tool | What it does | Key capabilities | | ----------------- | --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `create_hotspots` | Add hotspots to steps | `style` (Circle/Tooltip/Area/Anchor/Pointer/Modal), `animation` (Ripple/Spinner/Pulse/Ping), `position` (x/y %), `size`, `colors` (bg/text), `borderRadius`, `textAlign`, `text`. Width is a preset `hotspotWidth` (Small/Medium/Large) or a custom `cardWidth` (160–4096 px) with an optional `cardMinHeight` (0–4096 px) | | `update_hotspots` | Edit hotspot styling & navigation | All of the above, plus `isVisible`, `textVisible`, `tooltipPosition`, `htmlValue`, `isDisplayOnly` (the editor's **No action**: the hotspot shows its text with no click action or navigation buttons), and **`nextButton`** & **`backButton`** (`enabled`, `text`, `action` Slide/ExternalUrl, `url`, `bgColor`, `textColor`) | | `delete_hotspots` | Remove hotspots by ID | Batch by `{stepId, hotspotId}` pairs | #### Chapters | Tool | What it does | Key capabilities | | ----------------- | ------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `update_chapters` | Edit chapter layout, buttons & forms | `type` (Password/Link/Embed/Form/InterestScreen), `heading`, `description`, `theme`, `layout`, `enabled`, `skip`, `password`, `emailValidationMode`, `emailDomainList`, `coverImageType/Source`, `logoEnabled/Source`. **Buttons** (inline CRUD): `content`, `btnColor`, `color`, `linkTxt`, `isLinkExternal`, `openInNewTab`, `animation`, `order`. **Form fields** (inline CRUD): `fieldType` (SingleLineText/Email/Phone/Textarea/Dropdown/Checkbox/MultiSelect/Date/Number), `label`, `placeholder`, `required`, `options`, `businessFieldType` | | `delete_chapters` | Remove chapter blocks from steps | Deletes chapter, buttons, and form fields | #### Media Library & Uploads Upload local images, videos, and PDFs through a browser upload portal, reuse existing workspace media, and build or update demos from it. | Tool | What it does | Key capabilities | | ------------------------------------- | ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ | | `create_upload_job` | Start a browser-based upload | Returns an `uploadUrl` the user opens to upload images, videos, or PDFs into the workspace; job expires after 60 minutes | | `get_upload_job` | Fetch upload results | Status (pending/in\_progress/ready) + uploaded identifiers: image URL with dimensions, `videoId` with duration, PDF URL | | `create_demo_from_uploaded_media` | Create a new demo from uploads | Each image/video becomes one step, in order (up to 200 items); optional folder placement | | `replace_step_media` | Replace one step's image or video | Preserves regular hotspots and step audio; handles video-project duplication and timeline hotspots | | `replace_steps_media` | Replace media on several steps of a demo | 1–50 steps per call; images and videos can be mixed; voiceovers and regular hotspots are kept; results reported per step | | `list_media_library_items` | List reusable workspace media | Existing image screenshots + completed video projects | | `create_step_from_media_library_item` | Add a demo step from a library item | Images become image steps with a default hotspot; videos are duplicated so the library item stays reusable | #### Voiceovers & Audio | Tool | What it does | Key capabilities | | ----------------------- | ---------------------------- | --------------------------------------------------------------------------------------------------------------------------------- | | `list_voices` | List voiceover voices | The built-in voices available to your workspace, each with a style description and accent; cloned voices on Growth and Enterprise | | `generate_voiceovers` | Set text + generate AI audio | Per-step text, voice ID, `speed` (0.7–1.2), `stability` (0.3–1.0); up to 75 steps/call | | `delete_voiceover` | Remove voiceover audio | Target specific `stepIds` or all steps | | `list_background_music` | List BG music tracks | Preset library + workspace-uploaded custom tracks | #### Translations AI-translate a demo's text and, optionally, generate translated voiceovers. The supported languages are listed on [AI Translations Hub](/customize/personalize/ai-translations-hub.md). | Tool | What it does | Key capabilities | | --------------------------- | ----------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `generate_demo_translation` | AI-translate an entire demo | Translates title/meta description, chapter text & buttons, hotspot text/buttons, and step audio text; pass a `voiceId` to also generate translated voiceover audio (takes 1–3 min); requires the AI enhancement feature | | `list_demo_translations` | List stored translations for a demo | Per-language summaries: language, voiceover flag, entry counts | | `set_demo_translation_text` | Set translated text entries by hand | 1–100 entries per call; empty text deletes the entry; optional voiceover regeneration for step audio | | `delete_demo_translation` | Remove a language's translation | Deletes that language's translated text and media | #### Showcase Translations Translate a showcase's own text: its name, description, and button text, section names and descriptions, item names, and chapter text. Demos inside the showcase keep their own translations. See [Translate a showcase](/share/share-multiple-demos/showcase-collection.md#translate-a-showcase). | Tool | What it does | Key capabilities | | ------------------------------- | ----------------------------------------- | ----------------------------------------------------------------------------------------------------------------- | | `list_showcase_translations` | List a showcase's translations | Per-language counts of translated, outdated, and missing fields, plus the languages its demos are translated into | | `generate_showcase_translation` | AI-translate a showcase into one language | Fills only fields that have no translation yet; existing translations are not changed | | `refresh_showcase_translation` | Re-translate outdated fields | Replaces fields whose source text changed, including manual edits, and fills missing ones | | `set_showcase_translation_text` | Set translated fields by hand | 1–100 entries per call, all or nothing | | `delete_showcase_translation` | Remove one language from a showcase | Deletes all of that language's translated fields | #### Trackable Links | Tool | What it does | Key capabilities | | ------------------- | ---------------------------------------------- | ----------------------------------------------------------------------------------------------- | | `create_demo_links` | Create trackable links for a demo in one batch | `variables` (name, email, company, role, and others) personalize the demo; optional `expiresAt` | | `update_demo_links` | Update existing links by `linkId` | Change expiry or avatar colors | | `delete_demo_links` | Delete links by `linkId` | Also removes their personalization values | #### Tags | Tool | What it does | Key capabilities | | ----------------------- | ------------------------------------ | --------------------------------------------------------- | | `list_tags` | List workspace tags | Returns id, name, color, demo/showcase counts | | `create_tags` | Create tags | Name (1–50 characters) and optional hex color | | `update_tags` | Rename tags or change their color | By `tagId` | | `delete_tags` | Delete tags | Detaches them from every demo and showcase that uses them | | `add_demo_tags` | Add tags to a demo | Keeps the demo's other tags | | `remove_demo_tags` | Remove tags from a demo | The workspace tags themselves are kept | | `replace_demo_tags` | Set a demo's full tag list | Replaces whatever was there | | `bulk_add_demo_tags` | Add the same tags to many demos | 1–100 demos and 1–50 tags per call; all or nothing | | `bulk_remove_demo_tags` | Remove the same tags from many demos | 1–100 demos and 1–50 tags per call; all or nothing | #### Folders | Tool | What it does | Key capabilities | | --------------- | ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | | `list_folders` | List folders with hierarchy | Demo, Showcase, and Video folders with item counts; `parentId` lists subfolders | | `create_folder` | Create a folder | `personal` (true/false), `parentId` for nesting, `type` (Demo/Showcase/Video) | | `rename_folder` | Rename a folder | 1–255 chars | | `delete_folder` | Delete a folder and its subfolders | Demos inside are archived, showcases move to the root, and videos in a Video folder are permanently deleted unless attached to a demo step | | `move_videos` | Move library videos | Up to 100 per call | #### Showcases Build and manage [showcases](/share/share-multiple-demos/showcase-collection.md): curated collections of demos, videos, and resources. | Tool | What it does | Key capabilities | | --------------------------------------------------------------------------------------------------------------- | ------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `list_showcases` | List showcases in a workspace | Scope `me` or `workspace`, text search, Showcase-folder filter, pagination | | `get_showcase` | Fetch full showcase | Settings, sections, content, tags, personalized links, personalization variables | | `create_showcase` | Create a showcase | App defaults: published, one starter section, workspace CTA/branding; optional folder placement | | `update_showcase_settings` | Edit showcase-level settings | name, description, appearance (`displayFormat`: section/checklist/gallery, brandLogo, section visibility), autoplay (enabled, duration, loop, bar color), CTA, sharing (published, public/private, personal vs. shared), metadata image | | `duplicate_showcase` | Copy a showcase | Copies sections, content references, tags, the showcase's chapter, and its translations | | `import_showcase` | Import one showcase into another | Appends copied sections & content to the target (non-destructive) | | `move_showcases` | Move showcases within the workspace | Personal, Shared, or Folder (1–100 at once) | | `delete_showcase` | Permanently delete a showcase | No archived state | | `create_showcase_sections`, `update_showcase_sections`, `delete_showcase_sections`, `reorder_showcase_sections` | Manage sections | Deleting a section removes its content links; the underlying demos and videos are kept | | `add_showcase_content`, `update_showcase_content`, `remove_showcase_content`, `reorder_showcase_content` | Manage the content in a section | Content types: demo, video, link, PDF, document, text, embed. Image files are not supported as section content | | `create_showcase_links`, `update_showcase_links`, `delete_showcase_links` | Personalized/trackable showcase links | Variables (name, email, company + custom) and `expiresAt`; needs trackable-link access on your plan | | `add_showcase_tags`, `remove_showcase_tags`, `replace_showcase_tags` | Manage a showcase's tags | Work the same way as the demo tag tools | | `get_showcase_share_info` | Get share & embed URLs | Public, iframe embed, inline embed, popup embed, and OpenGraph image URLs | #### Demo Hubs Create and manage [Demo Hubs](/share/share-multiple-demos/demo-hub.md): embeddable help widgets that surface demos and showcases on your website. Hubs are workspace-level (no personal/shared split). | Tool | What it does | Key capabilities | | ----------------------------------------------------------------------------------------------------------------------- | ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `list_demo_hubs` | List Demo Hubs in a workspace | Text search, pagination; returns category & content counts | | `get_demo_hub` | Fetch full hub configuration | All settings (appearance, header, launcher, footer, allowed domains) + ordered category tree with demo/showcase items | | `create_demo_hub` | Create an empty Demo Hub | Same defaults as the app: three starter categories, "Help" footer links, workspace or white-label branding | | `create_demo_hub_from_showcase` | Convert a showcase into a Demo Hub | Showcase sections become hub categories; demo-backed items are carried over | | `duplicate_demo_hub` | Copy a Demo Hub | Copies settings, categories, and content references | | `update_demo_hub_settings` | Edit hub settings | name, appearance (title, theme, search placeholder), header (logo/title, background, alignment), launcher (show, position, icon), footer (label + links), allowed embed domains; changes go live immediately | | `create_demo_hub_categories`, `update_demo_hub_categories`, `delete_demo_hub_categories`, `reorder_demo_hub_categories` | Manage categories | Max 5 categories per hub; deleting a category removes its content links only | | `add_demo_hub_content`, `update_demo_hub_content`, `remove_demo_hub_content`, `reorder_demo_hub_content` | Manage demos & showcases inside a category | Per-hub `displayName` and `displayThumbnail` overrides | | `delete_demo_hub` | Permanently delete a hub | Underlying demos/showcases are not touched; embedding sites stop showing it | | `get_demo_hub_embed_code` | Get website install snippets | SDK script tag, launcher init snippet, custom-trigger snippet; white-label workspaces get their custom script URL | #### Route Hubs Create, edit, publish, and report on [Route Hubs](/share/route-hub.md). Edits change the draft, and visitors see them after the next publish. These tools appear when Route Hubs are enabled for your workspace, and creating, publishing, or duplicating a hub requires the Growth plan or higher. | Tool | What it does | Key capabilities | | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------- | | `list_route_hubs`, `get_route_hub` | List Route Hubs and read one | Returns the editable draft by default, or the published version visitors see | | `create_route_hub` | Create a Route Hub from a template | Templates: collect leads, qualify intent, or both; starts as an unpublished draft | | `update_route_hub_settings`, `duplicate_route_hub`, `delete_route_hub` | Rename, copy, or permanently delete a hub | Settings cover the name, description, and thumbnail | | `publish_route_hub`, `unpublish_route_hub` | Put the draft live or take the hub offline | Unpublishing stops the share URL from working | | `add_route_hub_nodes`, `remove_route_hub_nodes` | Add or remove nodes | Node types: form, interest screen, condition, resource center (a Showcase in the editor), and integration; up to 10 per add call | | `connect_route_hub_nodes`, `disconnect_route_hub_nodes` | Add or remove connections between nodes | Up to 20 connections per call, all or nothing | | `replace_route_hub_condition_branches` | Set a condition's paths and rules | Rules use form answers and interest ratings; paths are checked in order and the first match wins | | `update_route_hub_form`, `create_route_hub_form_fields`, `update_route_hub_form_fields`, `delete_route_hub_form_fields`, `reorder_route_hub_form_fields` | Edit the form and its fields | Heading, cover, logo, button, accepted emails, integrations, and email recipients; up to 7 fields in the same field types as demo forms | | `update_route_hub_interest_screen`, `create_route_hub_interest_screen_sections`, `update_route_hub_interest_screen_sections`, `delete_route_hub_interest_screen_sections`, `reorder_route_hub_interest_screen_sections` | Edit the interest screen and its topics | Heading, description, and the three rating column labels; up to 10 topics | | `get_route_hub_analytics` | Analytics for one Route Hub | Views, unique viewers, engaged viewers, engagement rate, and leads, each compared with the previous period | | `list_route_hub_leads` | List a Route Hub's visitors | Email, name, and company when given, plus each session's path, answers, and items opened | | `get_route_hub_embed_code` | Get the embed code for a published hub | An iframe of the share URL, matching the editor's Share dialog | To fill a Showcase inside a Route Hub, use the showcase section and content tools on that Showcase. #### Demo Agents Set up, train, publish, and monitor [AI Demo Agents](/ai-demo-agent/getting-started.md). These tools appear when Demo Agents are enabled for your workspace. | Area | Tools | What they do | | -------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Lifecycle | `create_agent`, `list_agents`, `get_agent`, `update_agent`, `duplicate_agent`, `publish_agent`, `unpublish_agent`, `delete_agent` | Create a draft, change its settings (identity, conversation behavior, guardrails, CTA, voice), publish it, or remove it | | Voices | `list_agent_voices` | Lists the voices for agent conversations, a separate catalog from `list_voices` | | Intro screen | `update_agent_intro` | Heading, description, cover image, logo, button, and up to 7 form fields | | Quick links | `create_agent_quick_links`, `update_agent_quick_links`, `remove_agent_quick_links` | Up to 20 links per agent | | Knowledge | `search_agent_knowledge`, `add_agent_demo_knowledge`, `add_agent_document_knowledge`, `add_agent_video_knowledge`, `add_agent_text_knowledge`, `discover_agent_website_pages`, `add_agent_website_knowledge`, `attach_agent_knowledge`, `get_agent_knowledge_source`, `update_agent_knowledge_source`, `reindex_agent_knowledge`, `remove_agent_knowledge` | Add demos, PDF/DOCX/PPTX files, library videos or public YouTube/Loom URLs, pasted text, and website pages as knowledge; search, re-index, and detach sources | | Readiness | `get_agent_checklist`, `evaluate_agent_checklist`, `set_agent_evaluation_criteria` | Read or re-run the readiness checklist, and define the high, medium, and low intent criteria used to classify conversations | | Monitor | `get_agent_insights`, `list_agent_sessions`, `get_agent_session`, `update_agent_session`, `generate_agent_session_summary`, `share_agent_session_summary` | Dashboard metrics, session transcripts and summaries, and emailing a session summary | | Knowledge gaps | `list_agent_knowledge_gaps`, `set_agent_knowledge_gap_resolved` | List the questions the agent couldn't answer and mark them resolved | | Triggers | `list_agent_triggers`, `create_agent_trigger`, `update_agent_trigger`, `set_agent_trigger_enabled`, `delete_agent_trigger` | Automations that email workspace members or send to HubSpot, Salesforce, Slack, Zapier, Marketo, or a webhook when a conversation meets your conditions | #### Videos Edit standalone videos and the video steps inside demos. The editor side of these settings is covered in [Video Editor for Screen Recordings](/create/by-demo-type/screen-and-camera-recording/video-editor.md). | Tool | What it does | Key capabilities | | ------------------------------------------------------------------------------ | -------------------------------------------------- | ------------------------------------------------------------------------------------------------ | | `get_video_settings` | Read a video's current look | Background, cursor, zoom motion blur, and captions | | `update_video_background` | Change the canvas background | A preset, a solid color, or an uploaded image; padding, blur, and corner radius | | `update_video_cursor` | Replace or restyle the cursor | Cursor style, size, smoothing, and hiding when idle | | `update_video_captions` | Change captions | On or off, 12 styles, position (bottom/middle/top), size, and font | | `update_video_zoom_settings` | Turn motion blur on or off for every zoom | Applies to the whole video | | `list_video_zooms`, `add_video_zoom`, `update_video_zoom`, `delete_video_zoom` | Manage individual zooms | Timing, zoom level, where the zoom aims, and whether it follows the cursor | | `create_video_ai_zooms`, `get_video_ai_zooms` | Add AI zooms to a video and check the run | Works for a standalone video or a demo step's video | | `create_demo_video_ai_edit`, `get_demo_video_ai_edit` | Turn a demo step's video into a click-through demo | Adds a pause hotspot on every step, cuts dead time, and speeds up typing, scrolling, and loading | | `duplicate_video` | Copy a library video with all its edits | The copy lands in the same folder; exports and analytics are not copied | #### Analytics Query demo performance, viewer sessions, and engagement through your AI assistant. | Tool | What it does | Example prompt | | ------------------------------ | ------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `get_top_performing_demos` | Rank demos by views, unique views, or engagement | "Which demos got the most views in the last 30 days? Show me the top 5 with engagement and completion rates, and how they compare to the previous period." | | `get_demo_analytics` | Full analytics breakdown for a specific demo | "Give me a full analytics breakdown for \[demo name] over the last 30 days: total views, unique views, engagement, completion, and how each step performed." | | `get_demo_sessions` | Individual viewer sessions with details | "Who has been viewing \[demo name] in the last 30 days? Show me the individual viewer sessions with their email, location, how many times they viewed it, and whether they completed it." | | `get_device_analytics` | Device, browser, and location breakdown | "What devices, browsers, and countries are my demo viewers coming from over the last 30 days?" | | `get_demo_hotspot_performance` | Hotspot click performance and drop-offs | "Show me the hotspot click performance for \[demo name]. Which steps are people clicking through and where are they dropping off?" | #### Showcase Analytics | Tool | What it does | Example prompt | | --------------------------------- | ------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- | | `get_top_performing_showcases` | Rank showcases by views, unique viewers, or leads | "Which showcases got the most leads this month vs. last month?" | | `get_showcase_analytics` | Overall analytics for one showcase | "How is \[showcase] performing? Views, leads, completion, and average session duration for the last 30 days." | | `get_showcase_demo_performance` | Per-demo views inside a showcase | "Which demos inside \[showcase] are getting viewed?" | | `get_showcase_sessions` | Viewer sessions & leads for a showcase | "Show me leads from \[showcase]: email, company, and completion rate." | | `get_showcase_session_details` | Deep-dive on one showcase viewer | "Show me everything this viewer did across their sessions in \[showcase]." | | `list_showcase_analytics_sources` | List UTM/source values for a showcase | "What traffic sources does \[showcase] have?" (use before filtering by source) | #### Docs & Academy | Tool | What it does | | ---------------------------------------- | ---------------------------------------------------- | | `search_docs`, `get_doc_page` | Search these docs and read a page in full | | `list_academy_pages`, `get_academy_page` | List and read Supademo Academy lessons and playbooks |