MCP tool reference

Aggregate viewer analytics for this workspace: unique sessions, average completion, per-bite performance, completion funnel and retention curve. Pass a bite_id for that single bite's funnel + feedback instead. Aggregate only (no per-viewer PII).

bite_id

List this workspace's analytics destinations (customer webhooks): name, URL, subscribed events, status, failure streak and recent deliveries. Secrets are never returned. Grow plan feature.

List this workspace's Update Center subscribers (paginated): hashed + plain email, status, consent date and source. Filter by status, a consent-date floor, or a search string. Grow plan feature.

statusfromqcursor

Manage this workspace's analytics destinations (customer webhooks). action: create (name + url [+ events]) → returns a reveal-once secret; update (id, name/events); set_status (id, active|disabled); delete (id); rotate_secret (id) → new secret; test (id) → live delivery probe; replay_failed (id) → re-queue failed deliveries. Grow plan feature.

actionidnameurleventsstatus

Change a subscriber's state on this workspace's Update Center: pause (30/60/90 days), resume, or unsubscribe. Identify the subscriber by emailHash (from list_subscribers). Grow plan feature.

actionemail_hashdays

PUBLIC ACTION — configure a PUBLISHED bite's shared page: its slug (the pretty URL; changing it 301-redirects the old one), its resource links, and whether the share button shows. Only published bites have a page. Two-phase: preview + confirm_token.

bite_idslugresourcesshow_share_buttonconfirm_token

Start linking a DemoBites account to this server. Returns a URL + code the user approves in their browser, and a device_code for check_connection polling.

PUBLIC ACTION — permanently delete a bite and all its exports and source video. Blocked (with the surfaces named) if the bite is on a PUBLISHED release or category, the published Explore Center hero, or an active Pulse feed. Remove it there first. Two-phase: the first call returns a preview + confirm_token.

bite_idconfirm_token

Dissolve a bite folder: every bite filed under it is unfiled (the bites themselves are NOT deleted). Workspace-private organization, not a public surface.

folder_name

Duplicate a bite into a new DRAFT copy in this workspace (a full copy of its media and timeline, named "… (Copy)"). Counts against the plan's bite limit. The copy is a draft — nothing goes public.

bite_id

Edit a bite's copy: its one-line summary, its longer description, and/or its resource links. Only the fields you pass change (the others are preserved). If the bite is published this touches its live page → two-phase (preview + confirm_token); drafts save directly.

bite_idsummarydescriptionlinksconfirm_token

List this workspace's bites (demo videos). `published: true` bites have an export; LIVE bites can go on releases, categories and the Explore Center hero.

Set a bite's internal organization (workspace-private, never on a public page): file it in a folder (or null to unfile), star/unstar it, and set/clear its risk signal flag. Provide at least one field.

bite_idfolderstarredrisk_signalrisk_signal_kind

Rename a bite. If the bite is published its title shows on live pages, so it is two-phase: the first call returns a preview + confirm_token; drafts rename directly.

bite_idvideo_nameconfirm_token

Rename a bite folder across the workspace — every bite filed under old_name moves to new_name. Folders are workspace-private organization, not a public surface.

old_namenew_name

Set or clear a bite's call-to-action button (a label + an http(s) URL, both required together). Pass clear:true to remove it. On a published bite the CTA shows on the live page → two-phase (preview + confirm_token); drafts save directly.

bite_idlabelurlclearconfirm_token

Replace ALL of a bite's tags with the given set (pass [] to clear). Tag ids come from list_workspace_tags and must belong to this workspace. Tag chips show on live filter/cards, so a published bite is two-phase (preview + confirm_token); drafts save directly.

bite_idtag_idsconfirm_token

PUBLIC ACTION — take a published bite's page offline (its exports are kept; it can be re-published by promoting a version). Two-phase: preview + confirm_token; the preview lists any releases and Pulse feeds it will drop from.

bite_idconfirm_token

Make a bite LIVE: it counts against the plan's live bites, can be embedded or given a Moment, and can be placed on releases, categories, the Explore Center hero or Latest. Needs an exported version. Two-phase (preview + confirm_token). Fails with gate 'live_bites' when the plan's live slots are all in use.

Take a live bite offline: frees its live slot and REMOVES it from every release and category, the Update Center, the Explore Center hero and Latest (those pages republish). Exports and Download stay. Two-phase (preview + confirm_token); the preview lists where it is placed.

Poll a pending connect_demobites link. On approval returns the API key to reconnect this MCP server with (Authorization: Bearer <key>).

device_code

List a spotlight's completed renders with temporary download URLs (each expires in about an hour), by format and language. Use this to hand your user the finished MP4s.

spotlight_id

How to record a new demo (bite) — which lane fits this agent.

What DemoBites is, what this server can do, and how to connect an account.

This workspace at a glance: plan, key scopes, bite usage, Update Center, Explore Center, languages.

PUBLIC ACTION — permanently delete the Update Center portal and its feed cards (the public page and its published data are removed; the individual releases and bites are NOT deleted). Two-phase: preview + confirm_token.

confirm_token

Add, remove, or reorder bites on a category. Bite ids come from list_bites; only this workspace's LIVE bites are accepted (a live bite may sit in any number of categories).

Create a DRAFT category on the Explore Center. A category belongs to ONE topic: area, job to be done, or role (category_kind; the customer's own names for the topics are in get_explore_center topic_labels). Nothing goes public. publish_category does that, with user confirmation.

PUBLIC ACTION. Permanently delete a category (its page, dock spot and bite assignments; the bites themselves are untouched). Two-phase: preview + confirm_token.

One category in full, including its assigned bites in order.

Read this workspace's Explore Center: title/description, hero copy, publish state, the hero (one item: a live bite, a rendered Spotlight, an image, or nothing) with its alignment, the customer's topic names (area, job, role), the docked categories in order with their thumbnails and posters, the published categories you can still dock, every category (drafts included), the live bites and the rendered Spotlights the hero picker offers. Start here before editing anything.

List this workspace's Explore Center categories (drafts and published) with their topic (area | job | role; the customer may have renamed the three topics, see get_explore_center topic_labels), publish state, bite count, dock position and custom thumbnail URL.

Dock, undock, or reorder categories on the Explore Center home. Category slugs come from list_categories; only PUBLISHED categories can be docked. `order_slugs` is the COMPLETE desired dock order. Two-phase once the center has ever been published (the dock is its live home).

PUBLIC ACTION. Publish a category page. First call returns a preview + confirm_token; show the preview to your user, then call again with confirm_token. Dock it afterwards with manage_explore_categories so it lists on the Explore Center home.

PUBLIC ACTION. Publish the Explore Center as a live public page. Two-phase: preview + confirm_token.

Set the Explore Center's hero, which holds at most ONE item: kind 'bite' with a LIVE bite id (Go live first), kind 'spotlight' with a Spotlight id that has a finished render (get_explore_center lists them under available_spotlights), or kind 'none' to clear it. Image heroes are set in the app only. Setting replaces whatever the hero held. Two-phase once the center has ever been published.

Turn on or off whether the Explore Center's hero picker OFFERS this workspace's example bites. This governs offering only. It never adds, removes, or changes any live spot, so it is a draft-space setting. Default is on.

PUBLIC ACTION. Deactivate a published category (its page comes off the Explore Center; content is kept). Two-phase: preview + confirm_token.

PUBLIC ACTION. Unpublish the Explore Center. Its public home goes offline (categories stay as they are). Two-phase: preview + confirm_token.

Update a category's title, description, or topic (category_kind: area | job | role). Draft-space: no confirmation needed. Changes to a published category rebake its live page.

Update the Explore Center's title, description and hero copy (eyebrow, hero title, hero description, hero CTA), the hero alignment (left | right | center; center only when the hero holds nothing), the customer's names for the three topics (area, job, role; empty string restores the default), and the categories layout (grid | list). Pass only what you are changing. If the center has ever been published this edits a LIVE page, so it is two-phase: the first call returns a preview + confirm_token.

Add a language to the Update Center or Explore Center (starts backfilling, then review → live). Requires the plan's localization feature.

localesurface

Change the narrator VOICE for a whole timeline and re-synthesize all of its narration in the new voice. Pass a speaker_id from list_voices (platform 'azure'). ElevenLabs voices additionally need el_voice_id. Blocked on example bites; may be quota/plan gated — read `detail` on error.

bite_idtl_idspeaker_idspeaker_platformel_voice_idel_voice_nameoptimize

Fix a bite's translated copy for one language: override specific text fields and/or specific caption cues. Only the fields you pass change; each edited field is marked as a human decision so future auto-translation will not overwrite it. If the bite is published this touches a live page, so it is two-phase: the first call returns a preview + confirm_token.

bite_idlocalefieldscaption_cuesconfirm_token

Edit ONE narration segment's caption text and/or its start time. NOTE: changing `text` here updates the on-screen caption only — it does NOT re-synthesize the spoken audio. To change the WORDS the voice speaks, use manage_tts_audio with action 'regenerate'. Moving `start_sec` keeps the segment's duration.

bite_idsub_idtextstart_sec

Create the translated content record for a bite in a language (LLM translation of every field), so it can then be reviewed and edited. Use this when get_bite_content_record reports has_record:false for the locale.

bite_idlocale

Read a bite's localized content for one language: the translated title, summary, steps and other copy, plus the translated caption cues. Use this to REVIEW a translation (e.g. the Spanish version) before editing it. Bite ids come from list_bites; locale codes from list_languages.

bite_idlocale

Check whether a bite's spoken language was detected as different from the workspace's primary language. If mismatch_language is set, the narration may be in the wrong language — retranscribe_bite can re-process it as the detected language.

bite_id

Languages on the Update Center and Explore Center (status: backfilling → review → live; archived = removed).

List this workspace's pronunciation-dictionary entries (word → IPA phonemes), optionally by language. These override how the TTS voice pronounces specific words across all bites in the workspace.

language

List one timeline's TTS narration segments in order: each segment's id, spoken text, start/end seconds, and state (completed = audio synthesized; anything else = no audio yet). Use segment ids with edit_tts_segment and manage_tts_audio.

bite_idtl_id

List the catalog of TTS voices (Azure neural voices), optionally filtered by language code. Returns each voice's speaker_id, display name, gender and locale — use the speaker_id with change_timeline_voice.

language

Add or remove a workspace pronunciation-dictionary entry — an IPA phoneme override that changes how the TTS voice says a specific word across all bites. 'add' takes the word + its IPA phonemes; 'delete' takes an entry id from list_pronunciations.

actionoriginal_textipa_phonemeslanguage_codeentry_id

Create, regenerate, delete or repair a narration segment's SPOKEN AUDIO on the bite's current timeline. 'create' adds a new segment at a start time; 'regenerate' re-synthesizes an existing segment from new words; 'delete' removes a segment; 'repair' restores a segment stuck after a failed synthesis. May be plan/quota gated by the voice provider — read `detail` on error.

bite_idactionsegment_idtextstart_secspeed

PUBLIC ACTION — archive a language from the Update Center or Explore Center (localized pages go offline; re-adding later re-localizes). Two-phase: preview + confirm_token.

localesurfaceconfirm_token

Resolve the one-time narration choice for a bite whose primary timeline was scripted but not yet voiced (the language-mismatch lane). 'translate' translates every segment into the workspace's primary language and synthesizes it; 'keep' synthesizes the segments as-is in the detected language; 'blank' deletes the auto-written segments so your user writes their own. Blocked on example bites.

bite_idintent

Resolve a detected language mismatch (see get_language_mismatch). Without `dismiss`, re-transcribes the bite's audio AS the detected language and regenerates the primary timeline's narration + captions in that language (heavy operation). With dismiss:true, just clears the mismatch note and leaves everything as-is. Blocked on example bites.

bite_iddismiss

Delete one render (export) of a spotlight and its MP4 file. This removes a rendered file only — the spotlight and its config stay. To delete the whole spotlight, use delete_spotlight.

spotlight_idexport_id

Delete a whole spotlight and its renders. If the spotlight fronts a PUBLISHED release as its hero this is blocked — remove it there first. Because a spotlight can be a live hero, this is two-phase: the first call returns a preview + confirm_token; call again with the token to delete.

spotlight_idconfirm_token

Auto-build a new spotlight from 2-8 bites: the server picks the money moment in each bite, writes the intro/outro and per-scene narration, assembles the trailer and (by default) renders it. This creates a NEW draft spotlight — it never edits an existing one. Bite ids come from list_bites. Rendering is a paid feature (Launch and up); on a Free plan the spotlight is generated and saved but not rendered.

namebite_idsdescriptiontemplatebackgroundauto_render

Check a spotlight render: its status (pending / processing / completed / failed), progress %, and — when completed — a temporary download URL. Provide the export_id returned by generate_spotlight or render_spotlight.

spotlight_idexport_id

Read one spotlight in full: name, description, status, its saved config (landscape / square / short variants) and localization info. Ids come from list_spotlights.

spotlight_id

List the workspace's spotlights (auto-trailers): id, name, status, template, scene/bite counts, duration, render count and the latest render's URL. Use this to find a spotlight id for the other spotlight tools.

Render an existing spotlight to an MP4 using its SAVED config. Rendering is a paid feature (Launch and up) — a Free plan is blocked here. Returns an export id; poll it with get_render_status. Pick a format: landscape (16:9), square (1:1) or short (9:16) — the matching config variant must already be saved.

spotlight_idformat

Suggest a short, catchy title for a spotlight built from these bites. Returns a name only — nothing is saved; pass it to generate_spotlight if you like it. Bite ids come from list_bites.

bite_ids

Write a narration line with AI (nothing is saved). Two modes: a SCENE line spoken over one bite's clip window (give bite_id + play_from/play_to seconds, plus the scene's title/tagline for context); or an intro/outro line for the whole trailer (set slot to 'intro' or 'outro' and pass the spotlight outline).

slotbite_idplay_fromplay_totitletaglinespotlight_nameintro_titleintro_taglineoutro_titleoutro_taglinescenes

Delete a NON-LIVE export version of a bite (the currently promoted version and the last remaining version cannot be deleted — promote a different one first). This removes an old export, not the bite. Version ids come from list_bite_versions.

bite_idexport_id

List the system background-music tracks (optionally by category). Use a track's id with set_background_music.

category

List a bite's narration timelines (the primary language plus any localized ones): id, language, name, speaker, background music, and which one is currently active. Use the timeline ids here for the audio, voice and background-music tools.

bite_id

List a bite's completed export versions (v1 = oldest), showing which one is currently live (isActive). Version ids feed promote_bite_version and delete_bite_version.

bite_id

Create, update or delete a timeline cut on a bite — a removed span between start_time and end_time (seconds) with an 'abrupt' or 'fade' transition. Cuts must sit in speech gaps; the route rejects a placement that overlaps narration or another cut (read the error).

bite_idactioncut_idstart_timeend_timetransition

Edit the caption cues for a bite shown in Original-audio mode (the customer's own voice, not TTS). 'set' replaces the WHOLE cue list (each cue: text + start_sec + end_sec; sorted, non-overlapping, min 0.2s). 'revert' restores the machine-transcribed cues. Blocked on example bites.

bite_idactioncues

Manage a bite's narration timelines. 'create' adds a localized timeline (needs a language + display name; requires the localization plan feature). 'switch' makes a timeline the active one. 'rename' changes a timeline's display name. 'delete' removes a non-primary timeline. 'reset_language' clears an empty timeline back to the language-setup wizard (only when it has no narration yet).

bite_idactiontimeline_idlanguagedisplay_name

Create, update or delete a zoom keyframe on a bite. A zoom magnifies the video between start_time and end_time by `factor` (1–3), centered on x_pin_center / y_pin_center (each 0–100 percent of the frame). Times are in seconds.

bite_idactionzoom_idstart_timeend_timefactorx_pin_centery_pin_center

PUBLIC ACTION — make one of a bite's export versions the LIVE published version (this is how a bite gets published / re-published). Version ids come from list_bite_versions. Two-phase: preview + confirm_token.

bite_idexport_idconfirm_token

Set (or clear) a timeline's background music and its volume. Pass a track id from list_background_music, or null to remove music. Volume is 0–1.

bite_idtimeline_idbg_music_idbg_music_volume

Set a bite's start and/or end trim (seconds from the raw recording's start). trim_start hides everything before it; trim_end hides everything after. Provide at least one; each is applied through the studio trim route (which also refreshes the intro/outro poster frames).

bite_idtrim_starttrim_end

Turn a bite's intro or outro card on/off and set its duration in seconds. This only changes the NUMERIC settings — it does not edit the card's artwork/layout (that needs the visual studio editor).

bite_idtype_ofenabledduration

Add, remove, or reorder bites on a release. Bite ids come from list_bites; only this workspace's bites are accepted.

release_slugadd_bite_idsremove_bite_idsorder_bite_ids

Create a DRAFT release on the Update Center. Nothing goes public — publish_release does that, with user confirmation.

titledescription

PUBLIC ACTION — deactivate the Update Center (its public page stops being served; all content is kept and can be re-published). Two-phase: preview + confirm_token.

confirm_token

PUBLIC ACTION — permanently delete a release (its public page, if any, comes off the Update Center and its data is removed). Two-phase: preview + confirm_token. Fails if the release is the workspace homepage — release the homepage first.

release_slugconfirm_token

Read which surface answers at the workspace's root domain: the stored choice (update | explore), what ACTUALLY serves after the published-guard, and the public root/explore URLs.

Read the Update Center's manually-curated 'Latest' rail: the bites on it (in order, each with its rail item_id) plus the published bites available to add. Publishing a bite never auto-enters the rail — it is curated here.

One release in full, including its assigned bites in order.

release_slug

Read the Update Center: its header settings, the release/bite cards on the feed (in display order), the workspace hubs still available to add, and the workspace homepage + domain-root state. Use this before arranging cards or flipping the root.

List the Update Center's releases (drafts and published). Explore Center categories are listed by list_categories.

Curate the 'Latest' rail. add: place a published bite (bite_id). remove: take one off (item_id from get_latest_rail). reorder: give the COMPLETE new order of item_ids. set: replace the whole rail with a list of bite_ids (rows not listed are removed). Instant-save; only this workspace's published bites are accepted.

actionbite_iditem_idordered_item_idsbite_ids

Add, remove, or reorder RELEASE cards on the Update Center feed (the dock order IS the public section order). Release slugs come from list_releases / get_update_center; only this workspace's releases are accepted.

add_release_slugsremove_release_slugsorder_release_slugs

PUBLIC ACTION — publish a release to the live Update Center. First call returns a preview + confirm_token; show the preview to your user, then call again with confirm_token.

release_slugconfirm_token

PUBLIC ACTION — publish the Update Center so its live page (and every release card on it) is served. Two-phase: preview + confirm_token. If the workspace root currently points at a single showcase, pass release_homepage:true to hand the root to the Update Center.

release_homepageconfirm_token

Change a release's URL slug. For a draft this is instant. For a PUBLISHED release the old link 301-redirects to the new one — a public change, so it is two-phase: the first call returns a preview + confirm_token.

release_slugnew_slugconfirm_token

Reset the seeded EXAMPLE release back to its original demo content (rebuilds it from the built-in recipe). Only works on the example release. If it is published this republishes the live page, so it is two-phase: preview + confirm_token.

release_slugconfirm_token

PUBLIC ACTION — choose which surface answers at the workspace's root domain: 'update' (the Update Center) or 'explore' (the Explore Center). Pointing at 'explore' requires the Explore Center to be published. Two-phase: preview + confirm_token.

root_surfaceconfirm_token

PUBLIC ACTION — deactivate a published release (its public page is removed; content is kept). Two-phase: preview + confirm_token.

release_slugconfirm_token

Update Center header settings: title, description, latest-rail label. Same instant-save behavior as the product's settings panel.

titledescriptionlatest_rail_label

Update a release's title / description / version label / public date. Draft-space: no confirmation needed. released_at backdates (or forwards) the shown ship date, which drives ordering on the live feed.

release_slugtitledescriptionversion_labelreleased_at

PUBLIC ACTION — copy selected fields from the ACCOUNT brand kit onto this workspace (brand_name, color, logo, favicon, typography) and re-stamp branding on every published page. Gated fields (logo/favicon on lower plans) are skipped and reported. Two-phase: preview + confirm_token.

fieldschoicesconfirm_token

Check whether a public workspace slug (address) is available before renaming to it. Returns the normalized slug and availability.

slug

The account behind this workspace: its name, subscription status, plan (limits, features) and the list of workspaces on it.

Billing snapshot for this account: plan name, subscription status, billing type, payment health, any scheduled plan change, subscription end date and credit balance. Read-only — this server never changes billing.

All three brand-kit layers for this workspace: the ACCOUNT source kit, this WORKSPACE's own kit, and the APPLIED branding actually live on the workspace (colors, brand name, logo, favicon, fonts). Use before apply_brand_kit or set_workspace_branding to see what would change.

Custom-domain state for both surfaces (Update Center and Explore Center): the connected domain (if any), any in-flight DNS verification, and whether the Explore Center is published (its domain slot only exists once it is).

This workspace's full entitlements: plan type, bite/workspace limits and usage, feature flags (custom domain, analytics, localization, SSO, RBAC), and the onboarding checklist. Does not trigger a billing reconcile.

The allowlist of domains permitted to embed this workspace's Pulse/SDK widgets.

This workspace in full: name, public slug, custom domains, branding (colors, brand name, logo/favicon paths, typography), plan, your role, member count and bite counts.

List this workspace's members and pending invitations: email, name, role (admin / collaborator), status, and per-feature permission levels. Requires you to be a workspace admin.

List this workspace's tag pool (role / jtbd / category / plain), with how many bites carry each. Tag ids feed set_bite_tags.

Manage a custom domain for a surface (update = Update Center, explore = Explore Center). action: initiate (start connecting `domain`, returns a CNAME target), verify (check DNS + activate), cancel (drop a pending verification), remove (take a LIVE domain offline). Only `remove` is two-phase (preview + confirm_token) because it changes what the public site serves. Requires the plan's custom-domain feature.

actionsurfacedomainconfirm_token

Manage this workspace's team. action=invite (email + role + optional permissions), action=update (member_id + role and/or permissions), action=remove (member_id). Member ids come from list_members. A custom (partial) permission mix is a paid feature.

actionemailmember_idrolepermissions

PUBLIC ACTION — rename this workspace. The name shows on your live Update Center hero and discovery pages, so it re-bakes public surfaces. Two-phase: the first call returns a preview + confirm_token.

nameconfirm_token

PUBLIC ACTION — change this workspace's public address (slug). Every published URL at the old address 301-redirects to the new one, and discovery docs re-bake. Two-phase: preview + confirm_token. Check availability first with check_workspace_slug.

slugconfirm_token

Upload or remove this workspace's logo or favicon. Provide base64 image `data` + `content_type` to upload, or set `remove: true` to clear it. Logo: png/jpeg/svg. Favicon: png/ico. Requires the plan's branding feature.

asset_typedatacontent_typeremove

Turn your connected ElevenLabs voice key ON or OFF for THIS workspace (activate = bites here may use ElevenLabs voices; deactivate = they may not). The key itself must already be saved in the app — this server never handles the raw secret.

active

Replace the allowlist of domains permitted to embed this workspace's Pulse/SDK widgets. Pass the COMPLETE desired list (it overwrites).

domains

Update this workspace's branding: theme + secondary color, brand name, title/content fonts and weights, the viewer error-redirect URL, and the default outro animation. Only the fields you pass change. Re-stamps published pages automatically.

theme_colorsecondary_colorbrand_nametitle_font_familytitle_font_weightcontent_font_familycontent_font_weighterror_redirect_urldefault_outro_animation

Update your own user profile (the key owner): first/last name, title, department, company. Only the fields you pass change.

first_namelast_nametitledepartmentcompany