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 a document's FULL Markdown/HTML body as a new agent-authored version with 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 block IDs, order, hashes and nullable previous_block_id/next_block_id for reviso_document_apply_patch. Effect: ephemeral_write; capabilities: view.
• reviso_document_apply_patch — Preferred targeted Markdown editing: call reviso_document_read_structure, then send ops with its base_version_id and block_hash preconditions. 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 the OPEN failed CRDT intents (pei_...) for a review -- edits that fail-closed with a 409 same-block conflict (delete-vs-edit or edit-vs-edit) instead of silently overwriting a concurrent edit. Effect: read; capabilities: edit_file.
• reviso_document_failed_intent — Read one open failed CRDT intent (pei_...) back as a recovery replay frame: the attempted_content (your blocked edit, whole-document Markdown), the conflicted_block_ids it touched, and the base_version_id it was authored against. Effect: read; capabilities: edit_file.
• reviso_document_resolve_failed_intent — Close a failed CRDT intent (pei_...) after handling it. 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 — Describe this MCP connection: server URL, token type, visible workspaces, capabilities if known, and available tools.. 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.

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.