Reviso MCP tool summary

Choose a catalog

full is the default for complete workflows. core exposes a smaller common catalog, including writes. Profiles control tools/list context, not permissions; connection capabilities enforce access. A short docs page only reduces documentation reading cost.

Tools

• reviso_document_create — Create a Markdown or HTML review document on the server. Effect: write; capabilities: create_file.
• reviso_document_update — Replace the FULL Markdown/HTML body with version-CAS protection. Effect: write; capabilities: edit_file.
• reviso_document_collaborative_update — Autosave a document's FULL Markdown body through block-aware CRDT collaboration without creating a version checkpoint. Effect: write; capabilities: edit_file.
• reviso_document_retrieve — Retrieve a document's latest content and version metadata. Effect: read; capabilities: view.
• reviso_version_diff — Get a unified diff between two versions of a review's document, so the agent compares revisions without re-fetching and diffing full content itself.. Effect: read; capabilities: view.
• reviso_document_read_structure — Read Markdown blocks and edit preconditions for reviso_document_apply_patch: base_version_id, update_seq, schema_version, block IDs/order/hashes and nullable neighbor IDs. Effect: ephemeral_write; capabilities: view.
• reviso_document_apply_patch — Targeted Markdown editing: reviso_document_read_structure first, then copy base_version_id, update_seq as base_update_seq, and block hashes. Effect: write; capabilities: edit_file.
• reviso_document_status — Get a review's status and latest-version metadata (title, version_id, version_no, source_format, effective_access) WITHOUT the document body. Effect: read; capabilities: view.
• reviso_document_rollback — Roll a review's document back to an earlier version, creating a NEW version whose content equals the target version. Effect: write; capabilities: edit_file.
• reviso_event_wait — Read events on a review newer than after_seq. Effect: read; capabilities: receive_events.
• reviso_comment_list — List all comment threads for a review with messages and anchors.. Effect: read; capabilities: view.
• reviso_comment_create — Open an agent comment thread; severity is required and must be one of info, warning, or error. Effect: write; capabilities: comment.
• reviso_comment_create_batch — Create several independent threads pinned to the SAME document version; each entry needs severity -- info, warning, or error -- and body. Effect: write; capabilities: comment.
• reviso_comment_reply — Reply to an existing comment thread.. Effect: write; capabilities: comment.
• reviso_comment_resolve — Resolve an existing comment thread after addressing it. Effect: write; capabilities: comment.
• reviso_list_workspaces — List accessible workspaces with id/name/type aliases and a personal-or-only workspace recommendation. Effect: read; capabilities: .
• reviso_document_list_failed_intents — List open failed CRDT intents (pei_...) after a 409 edit-vs-edit or delete-vs-edit conflict. Effect: read; capabilities: edit_file.
• reviso_document_failed_intent — Read an open pei_ recovery frame: attempted_content (whole-document Markdown), conflicted_block_ids and base_version_id. Effect: read; capabilities: edit_file.
• reviso_document_resolve_failed_intent — Close an open pei_ intent: resolved after reapplying against a fresh base; discarded to accept the live head; comment after exhausted retries to hand off as a warning-severity agent comment with attempted-content preview anchored to the first conflicted block, then discard. Effect: write; capabilities: edit_file.
• reviso_document_signal_activity — Report your ephemeral activity on a review so humans and other agents can see who is working on which block (presence + soft lease). Effect: ephemeral_write; capabilities: edit_file.
• reviso_create_invite — Create a one-time document collaboration invite URL. Effect: write; capabilities: manage_members.
• reviso_list_invites — List document collaboration invites without exposing invite tokens or token hashes.. Effect: read; capabilities: manage_members.
• reviso_revoke_invite — Revoke a pending document collaboration invite. Effect: write; capabilities: manage_members.
• reviso_share_create — Create a public share link so anyone can open the document without an account. Effect: write; capabilities: manage_members.
• reviso_share_list — List the share links on a document, including revoked and expired ones. Effect: read; capabilities: manage_members.
• reviso_share_revoke — Revoke a share link. Effect: write; capabilities: manage_members.
• reviso_list_documents — List documents visible to this connection, newest first, with compact metadata and comment counts. Effect: read; capabilities: .
• reviso_search_documents — Search visible documents by title and metadata. Effect: read; capabilities: .
• reviso_document_rename — Rename a document: set the title metadata that file lists, cards, and search results show. Effect: write; capabilities: rename_file.
• reviso_document_delete — Delete a document. Effect: write; capabilities: archive_file.
• reviso_document_restore — Restore a document previously deleted with reviso_document_delete, taking it out of the recycle bin.. Effect: write; capabilities: archive_file.
• reviso_connection_self — Connection identity, workspaces, tools and editing_features. Effect: read; capabilities: .
• reviso_favorite_add — Favorite an accessible document for the connected account. Effect: write; capabilities: view.
• reviso_favorite_remove — Remove a document from the connected account's favorites. Effect: write; capabilities: view.
• reviso_favorite_list — List the connected account's favorites that this connection can currently view. Effect: read; capabilities: view.
• reviso_version_label — Name or group an existing saved version. Effect: write; capabilities: edit_file.
• reviso_document_links — Read rendered web links with actual target (_blank or _self), exact block/hash/URL/occurrence selectors, document policy and write preconditions. Effect: read; capabilities: view.
• reviso_document_set_link_policy — Set the document web-link default and exact per-link overrides. Effect: write; capabilities: edit_file.
• reviso_document_usage — Measure live document source, blocks, table cells and images against document limits. Effect: read; capabilities: view.
• reviso_workspace_usage — Read workspace usage and Free/Pro entitlements, or legacy observation totals before adoption. Effect: read; capabilities: view_workspace_usage.
• reviso_document_upload_image — Upload a PNG/JPEG/GIF/WebP image (at most 5 MiB decoded) to a writable document. Effect: write; capabilities: upload_asset.

Workflow order

connection_self → choose workspace → retrieve/read_structure → update/apply_patch → version_diff → explicitly resolve verified comments. See /docs/mcp-recipes.md for executable examples and /docs/mcp-tools.md for full schemas.