clean_document
ChatGPTScrub a document before it is shared externally ("clean this document before I send it"): remove comments, resolve ALL pending tracked-change suggestions (accept or reject — everyone's, not just yours), remove hidden text (Word w:vanish), anonymize revision/comment author names to "Author", and clear document properties (title/author/company metadata from the original file). Destructive and not undoable — confirm with the user before running it. Options all default to off; enable only what the user asked to strip. Returns a summary of what was removed.
create_document
ChatGPTCreate a new Revise document, optionally seeded with markdown content. Returns the document id and URL. In clients that show app views, the new document also opens in the chat as a live, editable Revise view, so don't call open_document for it.
delete_document
ChatGPTMove a document to the trash (soft delete — the owner can restore it from the trash in Revise).
document_sharing
ChatGPTUsed by the document view's Share dialog. Not for the model: it requires the view's own session token.
edit_document
ChatGPTApply targeted edits to a document using Markdown or HTML content. Edits land as pending tracked changes ("suggest" mode) that the owner reviews and accepts or rejects in the editor — this is the default and the right choice unless your user explicitly asks for direct edits. Pass mode "apply" only on explicit instruction (e.g. "apply it directly", "don't leave suggestions"); it writes immediately with no review step, recorded in the revision history. One exception needs no instruction: on a short/new document (under 20 words) the default is already "apply", since there is nothing meaningful to review. Get block ids from read_document with with_block_ids: true.
export_document
ChatGPTExport a document by id to markdown, txt, html, docx, pdf. Markdown is returned inline. Every other format (txt, html, docx, pdf) normally returns a direct file download URL (expires in about 24 hours). Large or resource-limited exports instead return a browser download link; follow the response notes. For a browser link, tell the user to open it to load Revise and automatically download the file; do not fetch that browser link or pass it to import_document.
get_document_info
ChatGPTGet a document's metadata: title, sharing state, URLs, timestamps, and word count.
get_document_outline
ChatGPTGet a document's heading outline with block ids and per-section word counts. Cheap way to orient in a long document before reading specific sections.
get_document_widget_session
ChatGPTUsed by the document view itself to renew its connection. Not for the model.
get_recent_changes
ChatGPTSee what changed in a document since YOU last looked at it — e.g. edits the human (or another collaborator) made in between. Returns added, removed, and changed blocks (with block ids), all in the accepted/projected state. Great for catching up before continuing work ("how does it look now?"). The first call on a document just establishes a baseline. Each call advances your baseline to the current state.
get_selection
ChatGPTRead the host user's current semantic selection from a live Revise editor tab. Returns selected text, caret/range positions, portable target segments, active formatting, comment IDs, and pending suggestion IDs, with no viewport geometry. The document must currently be open in the user's browser.
import_document
ChatGPTCreate a Revise document from a file at a public http(s) URL (.md, .markdown, .txt, .html, .htm, .docx, .rtf, .odt; PDFs/images not yet supported). The server fetches the URL — file bytes are never passed inline. For a LOCAL file, use upload_document instead (it streams the file to the server). Returns the new document id and URL.
invite_collaborator
ChatGPTShare a document with a specific person by email, as a read, write, or suggest collaborator (suggest = can only propose tracked changes and comments). Existing Revise users are added directly; others receive an email invite. (Agents cannot make documents publicly accessible — that's a human-only action in the app.)
list_documents
ChatGPTList the user's Revise documents (most recently edited first). Returns id, title, sharing state, and timestamps.
list_open_documents
ChatGPTList the documents the user currently has open in a live Revise editor (a browser tab) right now — useful for joining them in what they're actively working on. Returns an empty list when nothing is open. Reflects the human's own browser sessions only, not documents you (the agent) are reading through these tools.
open_document
ChatGPTShow a document to the user as a live, editable view in the conversation. Use it when the user wants to see or work in an existing document. Don't call it after create_document: creating a document already shows this view. The view updates as you edit, so don't open the document again after each change.
read_document
ChatGPTRead a Revise document's content. Format "markdown" (default) is the simple dialect — best for plain prose; set with_block_ids to true to interleave <!-- block:xxxxxx --> anchors usable with edit_document. Format "html" is the full-fidelity dialect: compact HTML-like markup with a block id on every element plus everything markdown cannot express — rich marks, <latex> math, code block languages, merged table cells, page layout, and each comment thread inline as a <comment-thread transcript="..."> wrapper around its anchored text. Prefer html when a document uses rich features or has comments; edit_document accepts the same dialect in replacements. "text" is plain text. (For a styled, self-contained HTML file, use export_document instead.) view controls how pending tracked-change suggestions read: "final" (default, as if accepted) or "original" (as if rejected). Long documents are paginated: when a read exceeds the character budget it is cut at a block boundary and the response carries truncated: true, next_start_block, and a ready-to-run example call — repeat with start_block to continue. For a targeted read of a large document, prefer get_document_outline + search_within_document over paging through everything.
rename_document
ChatGPTChange a document's title.
replace_document_content
ChatGPTReplace the ENTIRE content of a document with new markdown. Destructive: existing content is removed (it remains recoverable via the document's revision history). Prefer edit_document for targeted changes.
resolve_suggestions
ChatGPTAccept or reject the tracked-change suggestions YOU made on a document — only your own, never the user's edits or another agent's suggestions. Use this when the user approves your suggested changes (e.g. they say "lgtm" / "looks good") to apply them on their behalf, or asks you to withdraw them. Covers the whole document by default; pass block_ids to limit to specific blocks. (Edits made with edit_document in "apply" mode are already applied — this is for edits left as suggestions in "suggest" mode.)
search_documents
ChatGPTFull-text search across the user's Revise documents. Returns matching document ids with short match excerpts — use search_within_document to find WHERE in a document the matches are. Search indexing is asynchronous, so a document created or renamed moments ago may take a few seconds to appear; use list_documents for immediate title lookup.
search_within_document
ChatGPTFind where a query matches inside one document. Returns the matching blocks as markdown with <!-- block:xxxxxx --> anchors (usable with edit_document), each with a few neighboring blocks for context. Case-insensitive.
set_page_layout
ChatGPTPatch a document's page or section layout: page size, orientation, margins, 1-3 columns, page numbers, line/paragraph spacing, pageless mode, or the APA-7 preset. ONLY the fields you pass change; everything else keeps its current or inherited value. Pass section_index to change one section; omit it to apply the passed fields to the document defaults and every section. Length values are strings with explicit units (e.g. "1in", "2.54cm", "72px").
style_blocks
ChatGPTStyle existing content with forgiving CSS-lite selectors and values. Use this for bulk formatting instead of rewriting text. Block selectors include , #blockId, p, h1-h6, li, lists, tables, and descendants. Inline selectors such as b/strong, i/em, u, s/strike/del, code, sup, sub, mark, and a target only matching formatted text ranges. Examples: set the entire document to Georgia with selectors="" and attrs=[{"name":"fontFamily","value":"Georgia"}]; bold headings with selectors=["h1","h2","h3"] and attrs=[{"name":"fontWeight","value":"bold"}]. Formatting lands as pending tracked changes by default on substantial documents.
upload_document
ChatGPTCreate a Revise document from a LOCAL file (.md, .markdown, .txt, .html, .htm, .docx, .rtf, .xml, .odt; PDFs/images not yet supported) without putting its bytes in model context. This tool requires the MCP host to read the local filesystem and run a shell command with network access (Codex, Claude Code, and ChatGPT Work mode have this; browser-only clients and sandboxes without network do not have shell access that can reach the server). A file the user attached to a chat in the Claude or ChatGPT app (a path like /root/.claude/uploads/... or /mnt/user-data/...) is in a sandbox that can't reach this server: don't call upload_document for it. Instead: If your client can show interactive app views (UI widgets) in the chat: call create_document with a short title (such as the file's name) and no content, which opens it in the Revise document view, and tell the user to click Upload on its empty page (or drag the file onto it). The file fills that document, which keeps its id, and you are told when it's in. If your client cannot show app views: tell the user to open https://revise.io/docs/upload, upload the file there (docx, md, txt, html), and paste the resulting revise.io/docs/... link back into this chat. If the curl cannot run, follow the if_curl_unavailable guidance in the response. It returns a one-time upload_url and ready-to-run curl command that streams the file and returns the new document's id and url. For a file already at a public http(s) URL, use import_document instead.
create_document
Claudedelete_document
Claudeedit_document
Claudeexport_document
Claudeget_document_info
Claudeget_document_outline
Claudeget_recent_changes
Claudeimport_document
Claudeinvite_collaborator
Claudelist_documents
Claudelist_open_documents
Clauderead_document
Clauderename_document
Claudereplace_document_content
Claudesearch_documents
Claudesearch_within_document
Claudeset_page_layout
Claudeupload_document
Claude
