WebMCP

DeveloperWebMCP verified

flatwrite.md WebMCP tools

A minimalist markdown editor with live preview, paged document layout, and one-click export to HTML, PDF, or shareable URL.

12 tools1 methodsspec API surface

What can an agent do with flatwrite.md WebMCP tools?

A minimalist markdown editor with live preview, paged document layout, and one-click export to HTML, PDF, or shareable URL. This page documents every listed tool, the action or answer it provides, its installation command, and the input fields an agent should send.

WebMCP tools on flatwrite.md

Tool 1 of 12WebMCPAction

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

Tool 2 of 12WebMCPAnswer

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

    Tool 3 of 12WebMCPAnswer

    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

      Tool 4 of 12WebMCPAction

      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

      Tool 5 of 12WebMCPAction

      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

      Tool 6 of 12WebMCPAction

      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

      Tool 7 of 12WebMCPAnswer

      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

        Tool 8 of 12WebMCPAction

        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

        Tool 9 of 12WebMCPAction

        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

          Tool 10 of 12WebMCPAction

          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

            Tool 11 of 12WebMCPAction

            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

              Tool 12 of 12WebMCPAction

              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