Flatwrite Md WebMCP tools

Add or update

render_markdown

Render markdown into FlatWrite-styled HTML <head> and <body> fragments, with optional typography and page-layout controls. Provide either the raw markdown inline (`markdown`) or an allowlisted URL (`markdownUrl`) pointing to raw markdown content. Use this when you need the rendered HTML artifacts.

How to install

Open the flatwrite.md website and ask your browser agent to use render_markdown

Install browse first, then run the command in a terminal. WebMCP tools run directly on the website and do not need a package install.

Run with an agent

Use the render_markdown tool on flatwrite.md with markdown: <string>, markdownUrl: <string>, font: <string>, appFramework: <string>, size: <string>, weight: <string>, line: <string>, uiZoom: <number>, pageSize: <string>, orientation: <string>, marginsLR: <string>, marginsTB: <string>, footer: <boolean>, width: <number>, docEngine: <string>, surfaceMode: <string>, theme: <string>. Return the structured result and cite the source page.

Input contract

• markdown string Raw markdown content to render.
• markdownUrl string URL pointing to raw markdown content. Must be on an allowlisted host (raw.githubusercontent.com, raw.gitlab.com, bitbucket.org), http(s) only, and <=1 MB. Host validation is enforced server-side.
• font string Font family — must be a bundled family.
• appFramework string UI framework applied when surfaceMode="app".
• size string Font size as a scale token (e.g. "-1", "0", "1").
• weight string Font weight as a scale token (e.g. "-1", "0").
• line string Line height as a scale token (e.g. "-1", "0", "1").
• uiZoom number UI zoom level (1.0 = default; >1 zooms in, <1 zooms out).
• pageSize string Page size for paged output. Only effective when docEngine is pagedjs or vivliostyle.
• orientation string Page orientation.
• marginsLR string Left/right page margin preset. Only effective when docEngine is pagedjs or vivliostyle.
• marginsTB string Top/bottom page margin preset. Only effective when docEngine is pagedjs or vivliostyle.
• footer boolean Include a page-number footer in paged output.
• width number Content width in pixels (400..1400). Only effective when docEngine="none".
• docEngine string Document engine — "none" emits plain CSS; "pagedjs"/"vivliostyle" wrap the output in @page rules.
• surfaceMode string Surface mode hint. "app" unlocks the appFramework picker; otherwise this is metadata only.
• theme string Theme identifier rendered as body[data-theme="..."] so consumer CSS can theme via attribute selectors. Free-form (alphanumeric, dash, underscore) — common values are "light" and "dark".

Open the source definition

Get data

list_render_options

Return the supported fonts, UI frameworks, document engines, page sizes, orientations, margins, and surface modes for the render_markdown tool. Call this before rendering if you need to know which enum values are valid; call render_markdown when you have the options and are ready to render.

How to install

Open the flatwrite.md website and ask your browser agent to use list_render_options

Install browse first, then run the command in a terminal. WebMCP tools run directly on the website and do not need a package install.

Run with an agent

Use the list_render_options tool on flatwrite.md. Return the structured result and cite the source page.

Input contract

Open the source definition

Get data

get_document_state

Return the current state of the active document in the FlatWrite editor: title, word count, render mode, unsaved changes flag, and available export formats. Use this before export or share tools to check readiness; use update_document_content to change the content.

How to install

Open the flatwrite.md website and ask your browser agent to use get_document_state

Install browse first, then run the command in a terminal. WebMCP tools run directly on the website and do not need a package install.

Run with an agent

Use the get_document_state tool on flatwrite.md. Return the structured result and cite the source page.

Input contract

Open the source definition

Get data

create_document

Create a new blank document in the FlatWrite editor, optionally with initial markdown content. Use this to start a new document; use open_document to load an existing one from a URL or share link.

How to install

Open the flatwrite.md website and ask your browser agent to use create_document

Install browse first, then run the command in a terminal. WebMCP tools run directly on the website and do not need a package install.

Run with an agent

Use the create_document tool on flatwrite.md with markdown: <string>, title: <string>. Return the structured result and cite the source page.

Input contract

• markdown string Optional initial markdown content for the new document.
• title string Optional title for the new document.

Open the source definition

Get data

open_document

Open an existing document from a URL or share link in the FlatWrite editor. Use this to load a remote markdown file or a previously shared document; use create_document to start blank.

How to install

Open the flatwrite.md website and ask your browser agent to use open_document

Install browse first, then run the command in a terminal. WebMCP tools run directly on the website and do not need a package install.

Run with an agent

Use the open_document tool on flatwrite.md with url: <string>. Return the structured result and cite the source page.

Input contract

• url string URL of the markdown file or FlatWrite share link to open.

Open the source definition

Get data

update_document_content

Update the markdown content of the active document in the FlatWrite editor. Use this to edit the document programmatically; use get_document_state to inspect the result.

How to install

Open the flatwrite.md website and ask your browser agent to use update_document_content

Install browse first, then run the command in a terminal. WebMCP tools run directly on the website and do not need a package install.

Run with an agent

Use the update_document_content tool on flatwrite.md with markdown: <string>. Return the structured result and cite the source page.

Input contract

• markdown string New markdown content for the document.

Open the source definition

Search & find

list_recent_documents

Return a list of recently opened documents from the editor session. Use this to discover what the user has been working on; use open_document to load one.

How to install

Open the flatwrite.md website and ask your browser agent to use list_recent_documents

Install browse first, then run the command in a terminal. WebMCP tools run directly on the website and do not need a package install.

Run with an agent

Use the list_recent_documents tool on flatwrite.md. Return the structured result and cite the source page.

Input contract

Open the source definition

Get data

render_markdown_preview

Triggers the editor's built-in preview pane. No HTML is returned — this tool produces a visual side-effect only. Agents that need HTML output must use render_markdown instead.

How to install

Open the flatwrite.md website and ask your browser agent to use render_markdown_preview

Install browse first, then run the command in a terminal. WebMCP tools run directly on the website and do not need a package install.

Run with an agent

Use the render_markdown_preview tool on flatwrite.md with markdown: <string>. Return the structured result and cite the source page.

Input contract

• markdown string Optional markdown to preview. If omitted, previews the current editor content.

Open the source definition

Search & find

export_document_html

Export the active document as a self-contained HTML file. The export opens in a new browser tab for human users. Completes synchronously. Use export_document_pdf for print-ready output.

How to install

Open the flatwrite.md website and ask your browser agent to use export_document_html

Install browse first, then run the command in a terminal. WebMCP tools run directly on the website and do not need a package install.

Run with an agent

Use the export_document_html tool on flatwrite.md. Return the structured result and cite the source page.

Input contract

Open the source definition

Search & find

export_document_pdf

Export the active document as a PDF by triggering the browser print dialog with the rendered preview. Completes synchronously. The print dialog opens for human users. Use export_document_html for a downloadable HTML file.

How to install

Open the flatwrite.md website and ask your browser agent to use export_document_pdf

Install browse first, then run the command in a terminal. WebMCP tools run directly on the website and do not need a package install.

Run with an agent

Use the export_document_pdf tool on flatwrite.md. Return the structured result and cite the source page.

Input contract

Open the source definition

Get data

create_share_link

Create a shareable URL for the active document and copy it to the clipboard. Use this to share the document; the link expires after 30 days. Use get_document_state to check canShare before calling.

How to install

Open the flatwrite.md website and ask your browser agent to use create_share_link

Install browse first, then run the command in a terminal. WebMCP tools run directly on the website and do not need a package install.

Run with an agent

Use the create_share_link tool on flatwrite.md. Return the structured result and cite the source page.

Input contract

Open the source definition

Add or update

assist_document

Rewrite, shorten, fix grammar, or apply a custom instruction to markdown via FlatWrite Assist (Morph: Reflex + Router + Compact + Fast Models). Returns full markdown plus the edited piece. Does not modify the editor — apply with update_document_content if desired. When selectionStart and selectionEnd are provided, only that span is rewritten.

How to install

Open the flatwrite.md website and ask your browser agent to use assist_document

Install browse first, then run the command in a terminal. WebMCP tools run directly on the website and do not need a package install.

Run with an agent

Use the assist_document tool on flatwrite.md with markdown: <string>, mode: <string>, instruction: <string>, selectionStart: <number>, selectionEnd: <number>, selectionText: <string>. Return the structured result and cite the source page.

Input contract

• markdown string Full markdown document. Optional in the browser WebMCP path (defaults to the active editor). Required for server MCP.
• mode string Assist mode.
• instruction string Freeform instruction. Required when mode is "custom".
• selectionStart number Optional selection start index (inclusive) within markdown.
• selectionEnd number Optional selection end index (exclusive) within markdown.
• selectionText string Optional selection text (defaults to markdown.slice(start, end)).

Open the source definition