Skip to content

MCP server

The platform exposes an MCP server so agents can read and write workspace and wiki data on a member’s behalf.

Endpoint: {tools.endpoint} (Streamable HTTP)

This is the most consequential behaviour to understand before integrating, and it is not apparent from a tools/list call.

Tools are registered conditionally on the scopes in the grant. A tool not covered by the token is not returned as forbidden; it is not registered, and therefore does not appear in the tool list. An agent holding only workspaces:read is presented with three tools and no indication that others exist.

tools/list therefore returns the subset available to the caller, not the catalogue. The full catalogue follows.

ToolRequired scopeDescription
archive_workspace_deliverableworkspaces:writeArchive a deliverable — hides it from the default task list without deleting it.
create_wiki_commentspaces:writePost a comment on a wiki page, or reply to an existing thread by passing its root
create_wiki_pagespaces:writeCreate a wiki page. `content` is a ProseMirror/TipTap document object; omit it to
create_wiki_rowspaces:writeCreate a row in a wiki database. `data` is keyed by COLUMN ID (not column name) —
create_wiki_rowsspaces:writeCreate MANY rows in a wiki database in a single call — use this instead of repeated
create_workspace_deliverableworkspaces:writeCreate a deliverable (a task) in a workspace. Assignees must be members of that
delete_wiki_pagespaces:writeMove a wiki page to the trash. This also trashes all of its descendant pages.
delete_wiki_rowspaces:writeDelete a row from a wiki database. Soft delete — the row is removed from all reads
delete_wiki_rowsspaces:writeDelete MANY rows from a wiki database in a single call — the counterpart to
get_deliverable_progressworkspaces:readGet a progress breakdown of all deliverables in a workspace, grouped by status
get_or_create_wiki_row_pagespaces:writeGet the wiki page attached to a database row, creating it on first call. A row holds
get_wiki_databasespaces:readGet a wiki database schema (columns + views) plus a PAGE of its rows. Rows are capped
get_wiki_page_backlinksspaces:readFind what references a wiki page: other pages linking to it, database rows whose
get_wiki_page_commentsspaces:readRead the comment threads on a wiki page: each root with its replies, who wrote them,
get_wiki_page_historyspaces:readList a page's saved versions, newest first — id, title, optional label and when.
get_workspace_summaryworkspaces:readGet a combined summary of a workspace: details, health metrics, and role breakdown
resolve_wiki_commentspaces:writeMark a comment thread resolved, or reopen it. Only a ROOT comment can be resolved —
restore_wiki_page_versionspaces:writeRestore a page to one of its saved versions, listed by get_wiki_page_history. This is
search_wikispaces:readSearch wiki page titles/content and database rows across your accessible spaces
search_workspacesworkspaces:readSearch accessible workspaces by title or filter by status/mode
set_wiki_row_relationspaces:writeSet which rows of another database a row links to, through a DB↔DB relation column.
update_wiki_pagespaces:writeUpdate a wiki page. Only the fields you pass are changed. Content edits are
update_wiki_rowspaces:writeUpdate cells of a wiki database row. This is a PARTIAL patch — only the column ids
update_workspace_deliverableworkspaces:writeUpdate a deliverable. Pass `status` to move it through the workflow (this is the
Scope Grants
workspaces:read Workspace resources and search
workspaces:write Creating and updating deliverables
spaces:read Wiki spaces, pages and databases
spaces:write Creating and updating wiki pages, rows and comments

Read scopes are additive and independent; a write scope does not imply its read scope, so request both.

Row data is keyed by column ID, not column name. Read the schema with get_wiki_database first. When adding more than a couple of rows use create_wiki_rows to send up to 50 at once — the endpoint is rate limited per minute, and batching is the difference between an import that completes and one that is throttled part-way.

Database and column structure cannot be changed through MCP: no create, alter or drop of databases, columns or views.

Something wrong on this page? Report it