MCP · Reference
Tool catalog
Dock's MCP server exposes 39 tools across workspaces, surfaces, rows, doc bodies, comments, members, agents, billing, support, webhooks, and event history. Every tool has a REST equivalent — pick the protocol that fits.
Also fetchable as JSON at /.well-known/mcp/server-card.json for tool-discovery pipelines that don't want to scan the live MCP endpoint.
Workspaces
| Tool | Description |
|---|
list_workspaces | List every workspace the caller can access. |
get_workspace | Workspace detail by slug — columns, members, mode, visibility. |
create_workspace | Create a workspace. `initial_markdown` seeds a doc body in the same call. |
update_workspace | Rename, change mode, change visibility. |
archive_workspace | Soft-delete. Reversible via unarchive. |
unarchive_workspace | Restore a soft-archived workspace. |
pin_workspace | Personal pin (sidebar order). |
unpin_workspace | Remove personal pin. |
Surfaces
| Tool | Description |
|---|
list_surfaces | Enumerate surfaces (tabs) in a workspace. |
create_surface | Add a new tab. Pass kind: 'table' or 'doc'. |
delete_surface | Drop a tab. Workspace must keep at least one. |
Rows (table mode)
| Tool | Description |
|---|
list_rows | List rows in a workspace's table surface, with filter + paginate. |
get_row | Single row detail by id. |
create_row | Add a row. Field values cast to column types. |
update_row | Patch field values on an existing row. |
delete_row | Remove a row. |
Doc body (doc mode)
| Tool | Description |
|---|
get_doc | Read the doc body as ProseMirror JSON or markdown. |
update_doc | Replace the doc body. `markdown` arg accepted. |
append_doc_section | Append a markdown chunk to the end of the doc. |
validate_doc_markdown | Pre-flight check — counts + errors + warnings without writing. |
| Tool | Description |
|---|
list_comments | Comments on a workspace, row, or doc range. |
create_comment | Anchor a comment to a range, cell, or row. |
resolve_comment | Mark a thread resolved. |
react_to_comment | Emoji react to a comment. |
Members & agents
| Tool | Description |
|---|
list_members | Members of a workspace (humans + agents) with roles. |
invite_human | Email-scoped or open-link invite to a workspace. |
invite_agent | Send an agent-bootstrap link to an agent service. |
update_member_role | Promote/demote between viewer/commenter/editor/owner. |
remove_member | Remove a member. Cascades any agents owned by that user. |
Billing
| Tool | Description |
|---|
get_billing | Current plan + caps + usage. |
open_billing_portal | Returns a single-use URL to the Stripe-hosted portal. |
upgrade_plan | Move to a higher plan. Two-call dangerous-ops handshake. |
downgrade_plan | Move to a lower plan. Two-call dangerous-ops handshake. |
request_limit_increase | File a request for a custom limit above Scale. |
Support
| Tool | Description |
|---|
create_support_ticket | File a support ticket. Same payload as POST /api/support. |
Webhooks
| Tool | Description |
|---|
list_webhooks | Webhook endpoints registered for the org. |
create_webhook | Register a new endpoint with event filters. |
delete_webhook | Remove an endpoint. |
Recent events
| Tool | Description |
|---|
recent_events | Recent events across the org or filtered to a workspace. Useful for catching up after a disconnect. |
Per-tool input schema
Every tool's full input schema (parameter names, types, required vs optional, descriptions) is on the live MCP endpoint via the standard tools/list JSON-RPC call. Or fetch the static catalog at /.well-known/mcp/server-card.json.