MCP server for Docmost self-hosted instance, providing tools to manage pages, spaces, workspaces, search, and comments via HTTP API
Server has 15 tools with consistent naming (verb_noun pattern) and descriptions present for all. However, input schemas are largely absent or minimal, most tools show only parameter names and types without formal JSON Schema definitions visible in the source. Descriptions are adequate (100-200 chars typical) but lack actionable detail on when to use each tool vs. alternatives. Error handling and recovery guidance are not evident. Output schemas are undocumented. The server implements elicitation for credentials but lacks tool annotations (readOnlyHint, destructiveHint) despite having clear risk classifications.
Cria um comentário de página no Docmost (não suporta comentário inline associado a um trecho de texto — o destaque/âncora depende da sessão colaborativa em tempo real do editor, fora do alcance da API HTTP). Exige confirmação explícita antes de executar.
Cria uma página no Docmost a partir de Markdown (convertido para ProseMirror). Exige confirmação explícita antes de executar.
Cria um novo space no Docmost. Exige confirmação explícita antes de executar.
Deleta uma página do Docmost (move para lixeira, não é permanente). Exige confirmação explícita antes de executar.
Duplica uma página do Docmost (título + conteúdo). Exige confirmação explícita antes de executar.
Conteúdo de uma página do Docmost, convertido de ProseMirror para Markdown.
Input schemas not visible in source code. Tools show parameter names and types but no formal JSON Schema definitions with constraints, enums, or validation rules. Cannot verify schema completeness.
Output schemas completely undocumented. No visible documentation of what fields are returned by any tool, making it impossible for LLMs to plan downstream calls or extract required data.
Tool annotations missing. Tools with WRITE and DESTRUCTIVE risk classifications (create_space, create_page, update_page, delete_page, etc.) lack readOnlyHint/destructiveHint annotations required by current MCP spec for proper agent safety.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 60 | 2026-07-28+ | v2 |
Lista as páginas recentes do usuário autenticado no Docmost.
Informações do workspace do usuário autenticado no Docmost (nome, ID, etc.).
Lista os comentários (não deletados) de uma página do Docmost.
Árvore de páginas de um space do Docmost (id, título, página-pai, caminho de breadcrumb) — só metadados de navegação, sem conteúdo. Use get_page para o conteúdo de uma página específica.
Lista todos os spaces visíveis ao usuário autenticado no Docmost.
Move/reposiciona uma página na hierarquia do Docmost, inclusive entre spaces diferentes. Omitir parentPageId mantém o pai atual e só reordena a posição. Exige confirmação explícita antes de executar.
Tool de teste do scaffold — confirma que o MCP server docmost está no ar.
Busca full-text no Docmost, respeitando os spaces visíveis ao usuário autenticado.
Edita o conteúdo de uma página do Docmost a partir de Markdown, no modo replace/append/prepend. Em append/prepend, o parâmetro markdown deve conter APENAS o trecho a adicionar (o conteúdo já existente é buscado e preservado automaticamente) — nunca reenvie o conteúdo atual da página junto, ou ele fica duplicado. Só use replace com o Markdown completo da página. Exige confirmação explícita antes de executar.
Error handling and recovery guidance absent. No evidence of actionable error messages, error classification (retryable vs. fatal), or recovery suggestions in tool implementations.
Descriptions lack dependency hints and selection guidance. Descriptions state WHAT tools do but not WHEN to use them vs. similar tools (e.g., when to call list_pages vs. search, or get_page vs. get_recent_pages).