MCP tool reference
Documents
MCP tools for documents.
Generated from the live tool catalog in packages/mcp/src/server.ts. Run pnpm mcp-docs in apps/docs to regenerate after changing a tool.
list_documents
List markdown documents in the workspace, optionally filtered by search query or linked issue.
| Parameter | Type | Required | Description |
|---|---|---|---|
q | string | no | Search title and content |
issue | string | no | Only documents linked to this issue identifier |
workspace | string | no | Workspace slug, name, or id. Only needed with an account-scoped token that reaches more than one workspace; defaults to the connection's active workspace. |
get_document
Get a document's full markdown content and linked issues.
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | yes | Document id |
workspace | string | no | Workspace slug, name, or id. Only needed with an account-scoped token that reaches more than one workspace; defaults to the connection's active workspace. |
create_document
Create a markdown document in a team, optionally linked to one or more issues.
| Parameter | Type | Required | Description |
|---|---|---|---|
title | string | yes | |
team | string | yes | Team key the document belongs to, e.g. PRO |
content | string | no | Markdown body |
issues | string[] | no | Issue identifiers to link (e.g. PRO-12) |
workspace | string | no | Workspace slug, name, or id. Only needed with an account-scoped token that reaches more than one workspace; defaults to the connection's active workspace. |
update_document
Update a document's title/content, or link/unlink issues. Only provided fields change.
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | yes | Document id |
title | string | no | |
content | string | no | Full replacement markdown body |
addIssues | string[] | no | Issue identifiers to link |
removeIssues | string[] | no | Issue identifiers to unlink |
workspace | string | no | Workspace slug, name, or id. Only needed with an account-scoped token that reaches more than one workspace; defaults to the connection's active workspace. |
delete_document
Delete a document.
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | yes | Document id |
workspace | string | no | Workspace slug, name, or id. Only needed with an account-scoped token that reaches more than one workspace; defaults to the connection's active workspace. |