Tiptap Collaboration MCP Server

A Model Context Protocol (MCP) server that provides tools for interacting with Tiptap Collaboration services.

Tools Available

Statistics

get-server-statistics

Get server-wide usage statistics.

• Parameters: None
• Returns: Total documents, connections, concurrent users, and the collaboration server’s version — useful for confirming which server you are talking to

get-document-statistics

Get real-time statistics for a specific document.

• Parameters:
  • id (string): Document ID
• Returns: Document size, version count, current connections, connected IPs
• Note: The server’s statistics endpoint returns zeroes for nonexistent documents, so the tool first checks existence with a HEAD request (available since server 3.91.0). On older servers the check is skipped and a missing document reports zeroes.

Document Management

create-document

Create a new collaborative document.

• Parameters:
  • name (string): Name of the document
  • content (object, optional): Initial content in Tiptap JSON format; defaults to {"type": "doc", "content": [{"type": "paragraph"}]}
• Returns: Creation confirmation (the server answers 204 with no body)

get-document

Retrieve a collaborative document.

• Parameters:
  • id (string): ID of the document to retrieve
• Returns: The document’s Tiptap JSON content

list-documents

List all available collaborative documents.

• Parameters: None
• Returns: Array of documents (name, size, timestamps)

update-document

Update a collaborative document with new content.

• Parameters:
  • id (string): Document ID
  • content (object): Document content in Tiptap JSON format
  • mode (string, optional): Update mode - “replace” or “append” (default: “replace”)
• Returns: Update confirmation (the server answers 204; the document is not echoed back)

delete-document

Delete a collaborative document.

• Parameters:
  • id (string): ID of the document to delete
• Returns: Deletion confirmation

Advanced Document Operations

duplicate-document

Duplicate an existing collaborative document (fetches the source as JSON and creates the target from it; versions are not copied).

• Parameters:
  • sourceId (string): ID of the source document to duplicate
  • targetId (string): ID for the new duplicated document
• Returns: Duplication confirmation

search-documents

Search documents using semantic search.

• Parameters:
  • query (string): Search query
  • limit (number, optional): Maximum results, 1-100 (default: 10)
• Returns: Matching documents with relevance scores
• Note: Semantic search is a Tiptap Cloud restricted-beta feature. Self-hosted collaboration servers do not implement it; there the tool returns an explicit “not enabled on this server” error.

Markdown Conversion