Skip to content

MCP server

Tool reference

Thirty tools, all scoped to Flow sites. Read tools are safe to call freely; write tools take the revision of whatever they are changing.

Conventions

  • Every tool takes flow_site_id except list_flow_sites, create_flow_site and get_flow_webflow_rules; for verify_flow_section it is optional.
  • Writes return a receipt — the id and the new updated_at — not the source that was sent. When a write moves other sections, their new revisions come back in moved.
  • Section and stylesheet writes are also held to the site's design system and refused with HTFLOW_DESIGN_SYSTEM_VIOLATED if they type out a colour, font, font size, spacing, radius or shadow instead of using a token, use a token that does not exist, or restyle a shared class. The refusal lists the site's token names so it can be fixed in one pass. An edit is refused only for what it introduces, so older sections stay editable.
  • Every update and delete takes the updated_at revision of its target. A stale revision is refused.
  • Section writes are checked against the Webflow rulebook and rejected with HTFLOW_WEBFLOW_RULES_VIOLATED if they fail.

Sites

ToolTitleWhat it does
list_flow_sitesList Flow sitesList every Flow/Webflow site this user can access.
create_flow_siteCreate Flow siteCreate a raw HTML/CSS/JS Flow site with a blank Home page.
get_flow_siteRead Flow siteRead the site's outline: tokens, globals, publish state, pages and their ordered section ids, titles and revisions. No section source unless include_source is set.
delete_flow_siteDelete Flow sitePermanently delete a Flow site using its latest revision. Only its workspace owner/admin may do this.
publish_flow_sitePublish Flow sitePublish the site at a subdomain of htflow.dev, or move it to a new one. Uses the app's own publishing route.
unpublish_flow_siteUnpublish Flow siteTake the site offline. Its subdomain stays reserved, so publishing again restores the same address.

Rules and audit

ToolTitleWhat it does
get_flow_webflow_rulesRead Flow rulebookRead the mandatory Webflow-compatible HTML/CSS/JavaScript authoring rules enforced by Flow writes.
audit_flow_siteAudit Flow siteAudit sections against enforced Webflow rules and report token consistency signals. Pass page_id to audit one page.
verify_flow_sectionVerify Flow sectionCheck a section against the rulebook and, given flow_site_id, the design system — without writing it. Returns exactly what a write would be refused for.

Pages

ToolTitleWhat it does
list_flow_pagesList Flow pagesList ordered pages and revisions without section source.
get_flow_pageRead Flow pageRead one page and its ordered sections, optionally including source.
build_flow_pageBuild Flow pageCreate a page's sections in one call, and the page itself with new_page. All sections are checked first; nothing is written unless every one passes.
create_flow_pageCreate Flow pageCreate one page in a Flow site.
update_flow_pageUpdate Flow pageRename or re-slug a Flow page with optimistic concurrency.
delete_flow_pageDelete Flow pageDelete a page and its sections. A Flow site must keep at least one page.

Sections

ToolTitleWhat it does
list_flow_sectionsList Flow sectionsList a page's ordered section summaries and revisions.
get_flow_sectionRead Flow sectionRead exact HTML, CSS, JavaScript and revision. Always call before editing.
inspect_flow_sectionInspect Flow elementsList stable selectors and element structure before element-level edits.
create_flow_sectionCreate Flow sectionCreate one Webflow-compatible raw HTML/CSS/JS section. Non-compliant writes are rejected. Pass global_slot to make it the site's header or footer in the same call.
update_flow_sectionUpdate Flow sectionAtomically update section source/title using its latest revision.
delete_flow_sectionDelete Flow sectionPermanently delete one section using its latest revision.
reorder_flow_sectionReorder Flow sectionMove one section to a new zero-based position. The page is renumbered so the order is exact, and every moved section's new revision is returned.

Elements

ToolTitleWhat it does
add_flow_elementAdd Flow elementInsert an element relative to one selector and optionally replace complete section CSS/JS.
update_flow_elementUpdate Flow elementEdit one exactly-matched element and optionally replace complete section CSS/JS.
remove_flow_elementRemove Flow elementRemove one exactly-matched element and optionally replace obsolete CSS/JS.

Design tokens

ToolTitleWhat it does
get_flow_design_tokensRead Flow design tokensRead the site's design tokens plus its revision. A new site has none.
set_flow_design_tokensUpdate Flow design tokensCreate, change and delete tokens: upsert by name, remove by name, or replace the set. A token still in use cannot be removed.
get_flow_style_guideRead the design systemEvery token with its value, the shared classes and the site stylesheet in one small read — instead of reading other sections to match their style.
set_flow_site_cssSet the site stylesheetReplace the shared component classes every page uses — buttons, containers, headings, cards — written with tokens. Sections may not restyle them.
set_flow_global_sectionSet the global header or footerMake a section the site's header or footer so every page renders it. Pass null to clear a slot.