{"id":"ai.trydock/dock","slug":"ai-trydock-dock","title":"Dock","description":"AI workspace for you, your team, and every agent. Tables, docs (images, 4K video), formulas.","version":"1.1.0","publisher":{"kind":"domain","id":"trydock.ai","label":"trydock.ai","url":"https://trydock.ai"},"website":"https://trydock.ai","repository":"https://github.com/try-dock-ai/mcp","remotes":[{"type":"streamable-http","url":"https://trydock.ai/api/mcp"}],"packages":[],"published":"2026-05-15","updated":"2026-05-15","status":"online","auth":"","latency_ms":971,"checked":"2026-11-19","uptime":100,"checks":3,"tools":[{"name":"list_workspaces","title":"","description":"List all workspaces the authenticated principal has access to. Returns workspace name (slug), mode (the default-view preference for the first surface), and creation date. A workspace is a container of one or more surfaces of any kind (see `create_surface`), in any combination, one or many of each. Use `list_surfaces` to see what a given workspace actually contains.","read_only":false},{"name":"get_workspace","title":"","description":"Get details about a specific workspace by its slug, including columns of its primary table surface, member count, and row count. A workspace contains one or more surfaces of any kind, in any combination. Use `list_surfaces` to enumerate every surface, then that surface's own tools (`list_rows`, `get_doc`, `get_html`, ...) to read or write it.","read_only":false},{"name":"list_rows","title":"","description":"List rows in a workspace's table surface. Returns rows with their data (a JSON object of column-name to value), creation time, the principal who created/updated each row, AND the row's `surface_slug` (the sheet it lives on). Empty array if no rows have been added yet. Multi-surface workspaces: pass `surface_slug` to scope to one sheet; omit to return rows from every surface in the workspace (back-","read_only":false},{"name":"create_row","title":"","description":"Append a new row to a workspace's table surface. The data field is a JSON object with column-name keys. Status column accepts: drafted, queued, sealed, active, blocked. Works on any workspace; columns auto-seed on the first row if the table surface is empty. Multi-surface workspaces accept `surface_slug` to target a specific sheet (use `list_surfaces` to enumerate); omit it to fall through to the ","read_only":false},{"name":"get_row","title":"","description":"Fetch a single row by id without listing the full table. Useful when a cue payload carries a row id and the agent only needs that one record. Returns the same row shape as list_rows.","read_only":false},{"name":"update_row","title":"","description":"Update specific fields of an existing row. Only the fields provided in `data` are updated; others are preserved. Setting `surface_slug` to a different sheet than the row currently lives on MOVES the row to that sheet (position recomputes to the new sheet's tail unless `position` is also set). Same surface as current → no-op move.\n\n**Unmapped data fields:** Keys in `data` that don't match any exist","read_only":false},{"name":"delete_row","title":"","description":"Permanently delete a row from a workspace. This action cannot be undone.","read_only":false},{"name":"move_rows","title":"","description":"Atomically move N rows from their current sheet(s) to a target sheet inside the same workspace. Use for programmatic data migration: dropping a batch of agent-produced drafts onto the right sheet, reorganizing content across LinkedIn / Twitter / Substack sheets, etc. All-or-nothing: if any rowId doesn't belong to this workspace, the entire batch fails before any write fires. Idempotent: rows alrea","read_only":false},{"name":"get_doc","title":"","description":"Read a workspace's doc (TipTap rich-text) body. Format is negotiable via `format`: `markdown` (default — CommonMark + GFM, ready to feed to an LLM or render in a non-ProseMirror surface), `content` (TipTap JSON, round-trippable into update_doc for structural edits), `text` (plain text, best for search, summarisation, word-count heuristics), or `all` for the legacy three-in-one shape. Default is `m","read_only":false},{"name":"get_workspace_schema","title":"","description":"Return a table surface's column definitions so an agent knows what keys create_row/update_row will accept. Each column has `key` (the field name in row.data), `label` (human-readable), `type` (text | longtext | number | status | person | date | url | checkbox | select), `position`, and, for status/select columns, the allowed `options`. Empty array on doc-only workspaces; callers should still be ab","read_only":false},{"name":"add_column","title":"","description":"Append a single column to a workspace's table schema. Position is auto-computed as next-after-max so the contiguity invariant holds. Key collision (409) if a column with the same key already exists. Editor role required. Use this for per-column additions; use get_workspace_schema + update_surface with `columns` for full schema replacement or reordering. Multi-surface workspaces accept `surface_slu","read_only":false},{"name":"list_workspace_members","title":"","description":"List principals with explicit access to a workspace. Returns users (id, name, email; email visible only when the caller is in the same org) and agents (id, name, brandKey) along with their role (owner | editor | commenter | viewer). Used by agents to verify a workspace is actually shared before writing output the team is expected to see. It cannot tell you whether a workspace is private to your ow","read_only":false},{"name":"check_workspace_private","title":"","description":"Check, on the server, whether a workspace is private to your owner right now: private, every member is your owner or one of your owner's agents, no open invite, no active file share link. Call it BEFORE writing anything owner-private (Voice profile, Second Brain, personal notes) and before every such write session. Returns { ok, reasons, private, member_count, non_owner_members, pending_invites, a","read_only":false},{"name":"delete_workspace","title":"","description":"Archive a workspace. Soft-delete: rows, doc body, and activity history are preserved, and the workspace can be restored from the Archived filter on the Workspaces page. Every member loses access immediately. Idempotent: calling on an already-archived workspace returns its current archivedAt without changing anything. Requires the owner role on the workspace. Pass `mode: \"web\"` to surface a click-t","read_only":false},{"name":"update_workspace","title":"","description":"Rename a workspace, change its slug, switch its default-view mode, or change its visibility (private | org). Pass any subset of `name`, `new_slug`, `mode`, `visibility`; fields you omit are left unchanged. Slug renames preserve old URLs via WorkspaceSlugAlias so previously-shared links keep resolving. Visibility flips disconnect every live SSE subscriber so reconnects re-authenticate against the n","read_only":false},{"name":"share_workspace","title":"","description":"Add someone to a workspace at a specified role: a human by `email`, or an agent by `agent_id`. For an email that already belongs to a Dock user, they're added immediately and a notification email is sent; otherwise a 7-day invite token is minted that auto-accepts on magic-link sign-in. An `agent_id` (the agent's Dock id, or its agt_ id) adds that agent directly as a member, never as an invite; the","read_only":false},{"name":"update_workspace_member","title":"","description":"Change an existing workspace member's role. Editor role required to caller. Owner-tier transitions (promoting to or demoting from owner) require an owner caller. Demoting the sole owner is blocked; promote someone else to owner first. No-op when the role is unchanged. Emits `member.role_changed` with from/to roles.","read_only":false},{"name":"remove_workspace_member","title":"","description":"Remove a workspace member, or revoke a pending invite by passing its invite id as `member_id`. Editor role required; owner-tier removals require an owner caller. Sole-owner removal is blocked; promote someone else first. Note: if the workspace visibility is `org`, removing an explicit member of the same org leaves them with virtual editor access via the org-membership branch. Consent-gated for age","read_only":false},{"name":"update_doc","title":"","description":"Replace a workspace's doc body. Takes EITHER TipTap JSON (`content`) OR Markdown (`markdown`): pass markdown when you're producing prose from scratch (CommonMark + GFM is the format every LLM emits natively), pass TipTap JSON when you need structural edits to an existing doc (round-trip from get_doc, mutate, write back). Beyond CommonMark + GFM, the markdown layer recognizes:\n\n- **![alt text](http","read_only":false},{"name":"validate_doc_markdown","title":"","description":"Pre-flight check on markdown BEFORE writing it via update_doc / append_doc_section. Returns { ok, errors, warnings, parsed } with parsed counts per format type (imageCount, videoCount, mermaidCount, mathCount, svgCount, calloutCount, crossRefCount, mentionCount, embedCount, detailsCount, headingCount, byteSize, nodeCount, depth) plus structured DocGuardError-equivalent errors (cap breaches) and no","read_only":false},{"name":"update_doc_section","title":"","description":"Replace a single section of a workspace's doc body, identified by its heading text. The targeted edit complement to `update_doc` (full replacement) and `append_doc_section` (append-only at the end). Use this when the agent maintains a recurring section (e.g., a 'Status' block in a launch-prep doc, an 'Outcomes' block in a meeting note) and only needs to refresh that one piece. Without it, agents a","read_only":false},{"name":"append_doc_section","title":"","description":"Append a chunk of Markdown to the END of a workspace's doc body. Designed for crons + ingest agents that produce content in timestamped chunks (changelog updates, daily standups, batch summaries). Same markdown surface as update_doc: supports CommonMark, GFM, **`![alt](url)` inline images** (an HTTPS URL; for a local file, `upload_file` it into a `files` surface of this workspace and embed the `ur","read_only":false},{"name":"get_html","title":"","description":"Read an HTML surface's body. HTML surfaces (Surface.kind=\"html\") store mockup or full-page content as three text fields (html, css, js) rendered together inside a sandboxed iframe. Use `list_surfaces` to enumerate html surfaces in a workspace. Omit `surface_slug` to read the primary html surface; pass it to target a specific html surface. Empty (never-written) html surfaces return { html:\"\", css:\"","read_only":false},{"name":"update_html","title":"","description":"Write an HTML surface's body. Pass any of `html` / `css` / `js`; omitted fields stay unchanged. Pass empty string to clear. The surface renders in a sandboxed iframe with no access to Dock cookies, storage, or parent DOM, and scripts do not run there today: inline `<script>` and the `js` field are stored but never execute. Build pages that work without JavaScript; for interaction use CSS (`:hover`","read_only":false},{"name":"validate_html","title":"","description":"Pre-flight check on html / css / js BEFORE writing via update_html. Returns { ok, errors, warnings, parsed } where parsed has byte counts per field and `htmlDropped` (true if the sanitizer would strip anything from `html`) plus `htmlRemoved`, the list of tags (`{ tag, count }`) and attributes (`{ tag, attribute, count }`) it would remove (capped at 25; `htmlRemovedTruncated` flags the cut). The sa","read_only":false},{"name":"create_workspace","title":"","description":"Create a new workspace in the caller's org. Works for both user and agent callers; agent-created workspaces attribute to the agent and enroll the agent's owning user as a co-owner so the human sees it in their dashboard. The new workspace is seeded with one primary surface matching `mode`: `doc` → a Notes surface (for prose), `table` → a Sheet surface (for records), `html` → a Mockup surface (sand","read_only":false},{"name":"get_recent_events","title":"","description":"Get recent activity events for a workspace. Who did what, when. Useful for understanding what's happened since you last looked.","read_only":false},{"name":"search","title":"","description":"Search across everything the caller can already touch: workspace names, row cell values, and doc sections/paragraphs. Returns ranked hits (score 0-1) with a navigable URL per hit so the agent can open the exact row or doc section. Access-gated; never returns hits from workspaces the caller can't open. Use when the user references something by keyword (\"find my launch-plan workspace\", \"which row me","read_only":false},{"name":"offer_billing_action","title":"","description":"Prepare Dock's real seat picker for your owner to review who gets Standard or Scale, or prefill a custom-capacity request in Dock's existing support form. Only owner/admin agents may prepare seat actions. action=buy selects seats; action=change proposes moves between Standard and Scale; custom_capacity states the capacity wanted. Return the link to your human. Nothing is charged, changed or submit","read_only":false},{"name":"get_billing","title":"","description":"Read your human's plan, subscription connections, Dock usage percentages and resets, and this agent's latest attributable recorded funding decision and timestamp in one call. billingContext.subscriptions reports Claude/OpenAI connected yes/no only. latestTurnFundingAsRecordedByDock is as recorded by Dock's funding decision, not proof of what actually executed; never infer funding from connectivity","read_only":false},{"name":"upgrade_plan","title":"","description":"Legacy organization resource-cap management only; this tool does not purchase Dock's per-person plans. Read get_billing for current billing. If the org has no card on file, returns a Stripe Checkout URL for the human. A live change with a card is consent-gated: chat mode returns a confirm_token to present and repeat within 60 seconds; web mode returns an approval_url and polling_url. Agent callers","read_only":false},{"name":"downgrade_plan","title":"","description":"⛔ RETIRED PLAN SYSTEM — not Dock's pricing, and it does not change your human's per-person plan or credits. Schedules the caller's ORG to drop from a legacy paid resource-cap tier to the free resource-cap tier at the end of the current billing period; the org keeps those caps until then. No-op when already on Free. Consent-gated. Two consent surfaces, you pick via `mode`: (1) `chat` (default): FIR","read_only":false},{"name":"request_limit_increase","title":"","description":"Ask Dock to raise an org limit (agents, workspaces, rows, or other). We record the signal on the admin side; there's no reply loop. Use this whenever you hit one of those caps. Never offer a legacy organization resource tier as an allowance upgrade.","read_only":false},{"name":"list_surfaces","title":"","description":"List the surfaces inside a workspace. A workspace can hold surfaces of any kind (see `create_surface`), in any combination, one or many of each; this tool tells you exactly what it has. Each surface has its own slug used in surface-scoped tool calls. Order matches the on-screen surface order. Archived surfaces are hidden by default; pass `archived: true` to include them.","read_only":false},{"name":"create_surface","title":"","description":"Create a new surface inside a workspace. `kind` picks `table`, `doc`, `html`, `files`, or `video`. Optional `slug` (lowercase kebab-case, 3-64 chars); when omitted the server slugifies `name` and appends a numeric suffix on collision. Optional `columns` sets a `table`'s starting columns; without it the table starts EMPTY and your first row write creates the columns its data needs. Ignored for othe","read_only":false},{"name":"update_surface","title":"","description":"Rename, reslug, reorder, restore, OR replace the column schema of a surface. Pass any subset of `name`, `new_surface_slug`, `position`, `columns`, `archived`. **Restore**: pass `archived: false` with the archived surface's `surface_slug` (find it with `list_surfaces archived: true`) to unarchive it; its rows and doc body come back, it is placed last among the workspace's surfaces, and it emits `su","read_only":false},{"name":"delete_surface","title":"","description":"Archive a surface (soft-delete). Rows + doc body are preserved: restore it with `update_surface` and `archived: false` (archived surfaces are listed by `list_surfaces archived: true`). Idempotent: calling on an already-archived surface returns its current archivedAt unchanged. Cannot archive the only live surface in a workspace; create another first. Editor role required. Emits `surface.archived`.","read_only":false},{"name":"list_api_keys","title":"","description":"List API keys. Agent callers see only the key they're authenticated with (a one-row response: id, prefix, lastUsedAt, the workspace it's bound to). User callers (cookie session) see every key for every agent they own. Plaintext is never returned; the key body is shown only once at create/rotate time.","read_only":false},{"name":"rotate_api_key","title":"","description":"Atomically mint a new API key with the same agent / workspace / scopes / name and revoke the old one. Returns the new plaintext (`key`) once; store it before discarding the response. Subsequent requests with the OLD key return 401, so swap creds before retrying. Agents may rotate ONLY their own key (omit `id` to default to it); users may rotate any key they own. Use this for routine credential hyg","read_only":false},{"name":"revoke_api_key","title":"","description":"Revoke an API key (soft-delete via `revokedAt`). Subsequent requests with the key return 401. Agents may revoke ONLY their own key; calling this is effectively a self-destruct, the response itself completes but the very next request will fail. Users may revoke any key they own. To swap creds without going dark in the gap, use `rotate_api_key` instead.","read_only":false},{"name":"request_revoke_agent_key","title":"","description":"Ask the human owner to revoke ANOTHER agent's active API key (sibling agent). The MCP `revoke_api_key` tool is self-only by design; this is the cross-agent escalation path. Returns { status: 'approval_required', approval_url, polling_url, expires_in }: print approval_url in chat for the target agent's owner to click; poll polling_url for the result. Approval gate: the approving user must be the ta","read_only":false},{"name":"request_rotate_agent_key","title":"","description":"Ask the human owner to rotate ANOTHER agent's active API key (mint a new one + revoke the old). Same shape as request_revoke_agent_key: returns an approval_url, requires the target agent's owner to click. On approval the old key stops working at once. The new key's plaintext is INTENTIONALLY not returned to you: it is shown once to the approving owner on the approval page, and they hand it to the ","read_only":false},{"name":"list_webhooks","title":"","description":"List webhook endpoints registered on an org. Returns each webhook's id, url, subscribed events, active flag, and an 8-char `secretPreview` of the signing secret (full secret is only returned at create / rotate-secret time). Any org member (user or agent) can list. Use to audit what's subscribed before adding or removing endpoints.","read_only":false},{"name":"create_webhook","title":"","description":"Register a new webhook endpoint on an org. The URL must be public (loopback / private ranges / cloud metadata are blocked at create-time AND re-validated by DNS at delivery-time). Events array filters which event kinds the endpoint receives: pick from row.* / comment.* / member.* / workspace.* / doc.*; an empty array means \"none\" so always pass at least one. Returns the signing `secret` exactly on","read_only":false},{"name":"update_webhook","title":"","description":"Toggle a webhook's `active` flag on or off. Inactive webhooks are skipped at delivery time (no retry queue, no log row) but the endpoint config is preserved so flipping back is one call. Use to silence a noisy receiver during maintenance without losing its URL + secret + event subscription.","read_only":false},{"name":"rotate_webhook_secret","title":"","description":"Mint a fresh signing secret for a webhook. The new `secret` is returned exactly once; copy it to the receiver before the next event lands. After this call, deliveries are signed with the new secret only; receivers still validating against the old one will reject (401) until updated. Use after a suspected leak or as part of routine rotation hygiene.","read_only":false},{"name":"delete_webhook","title":"","description":"Permanently delete a webhook endpoint. The URL stops receiving events immediately and the secret is destroyed; recreate from scratch if you need to re-add it. To pause without losing config, use update_webhook with active:false instead.","read_only":false},{"name":"send_message","title":"","description":"Send a direct message to a person in the messaging substrate. Wires through cue.dock.svc, the same path the /live UI uses, so the recipient sees this message in their drawer (and, once they have a Dock-connected agent worker running, their agent harness's inbox). Address a person as `self@<handle>.<org>`: `self`, then their handle in the org, then the org slug. Look up the exact address with `addr","read_only":false},{"name":"create_support_ticket","title":"","description":"File a support ticket. For agents on the Dock team only: any other caller is refused. If you are not on the Dock team, email agent-support@trydock.ai with the problem yourself if you have your own email address (send_email on cloud, email_owner on desktop); otherwise ask your human to (they can also file from Settings → Support). Prefer request_limit_increase when the user is simply hitting a plan","read_only":false},{"name":"list_my_support_tickets","title":"","description":"List the support tickets YOU filed (READ-ONLY) — the same tickets `create_support_ticket` creates, so you can check on one after filing it. Scoped exactly like the dashboard at /settings/support: you see tickets you filed yourself, and — if you are a human caller — tickets filed by agents you own. You never see another person's tickets, and never another org's. Results are for your CURRENT org: a ","read_only":false},{"name":"list_sheet_functions","title":"","description":"List the Dock Sheets formula functions an agent can use in a cell carrier. Returns the canonical name, signature, one-sentence description, category (Math/Logic/Text/Date/Lookup/Predicates), rollout slice (v1/v2/v3/v4), and at least one worked example per function. Use this before writing a formula via update_row / create_row so you only reference functions that actually exist (no #NAME? errors). ","read_only":false},{"name":"validate_formula","title":"","description":"Parse-check a formula expression server-side without writing anything. Returns { ok, error?, rewrittenFormula?, referencedFunctions, unknownFunctions }. Use BEFORE update_row / create_row when the formula references functions or syntax you're not 100% sure of: a `=SUMIFS(...)` with the wrong arg order or a misspelled `=AVERAG(...)` will round-trip into the cell as a stored carrier with no value, a","read_only":false},{"name":"evaluate_formula","title":"","description":"Evaluate a formula expression against an actual Dock workspace's columns + rows, server-side, returning the same display value the UI's HyperFormula engine would render. Two modes: STANDALONE (omit `workspace_slug`) — evaluates against an empty grid; useful for `=SUM(1, 2, 3)` or any formula with no cell references. IN-WORKSPACE (pass `workspace_slug`, optionally `at`) — loads the workspace's grid","read_only":false},{"name":"add_comment","title":"","description":"Post a new comment on any target in a workspace: a row, a cell, a doc text range, an html element, an entire surface, or the workspace itself. Polymorphic target shape mirrors the REST POST /api/workspaces/:slug/comments. For threading, pass `parentId` to hang the new comment as a reply (the server flattens nested replies to single depth and auto-unresolves a resolved parent). Mentions are an arra","read_only":false},{"name":"list_comments","title":"","description":"List comments in a workspace. Filter by `target_type` (row, cell, doc_range, html_element, surface, workspace), `target_id`, `surface` (returns every comment anchored to any element of one surface, useful for 'open threads on this surface'), `status` (open | resolved | all, default open), `mentioning_me: true` for comments that @-mention the caller, or `author: <principalId>` for comments by a spe","read_only":false},{"name":"get_comment_thread","title":"","description":"Fetch a single comment with its replies + reactions in one round trip. Pass any comment id in the thread (root or reply). Returns `{ comment, replies }` where each entry includes aggregated reactions (`emoji`, `count`, `mine`). Use this when an agent receives a `comment.added` webhook with a `parentId` and needs full context before composing a reply.","read_only":false},{"name":"reply_to_comment","title":"","description":"Convenience wrapper around `add_comment` for the common reply case. Pass the parent comment id and the body; the handler reconstructs the target from the parent (no need for the agent to remember whether the parent was a row, cell, doc_range, html_element, surface, or workspace comment). Re-opens a resolved parent. Same threading rules as add_comment: nested replies flatten to single depth, so rep","read_only":false},{"name":"resolve_comment","title":"","description":"Mark a comment thread resolved. Idempotent: calling on an already-resolved thread returns the existing `resolvedAt` unchanged. Fires `comment.resolved`. Pair with `unresolve_comment` for the reverse. Used by agents to close a feedback thread once they've iterated on the change the reviewer asked for.","read_only":false},{"name":"unresolve_comment","title":"","description":"Re-open a previously-resolved comment thread. Idempotent on already-unresolved comments. Fires `comment.unresolved` with `reason: 'manual'`. (Auto-unresolve on reply fires the same event with `reason: 'reply'` and is handled by `add_comment` / `reply_to_comment`.)","read_only":false},{"name":"react_to_comment","title":"","description":"Add or remove an emoji reaction to a comment. Reactions are per-principal: each (commentId, principalId, emoji) combination is unique. `action: 'add'` is idempotent (re-adding the same emoji is a no-op); `action: 'remove'` deletes the row if present. Fires `comment.reaction_added` / `comment.reaction_removed`. Use this for lightweight agent acknowledgement (👍 on a request before reading, 👀 to mark","read_only":false},{"name":"list_files","title":"","description":"List the folder + file children of a Files surface (kind='files'). Folders sorted first by position then name; files sorted by name. Returns folders[], files[] with cuids agents can pass to `get_file` / `delete_file`. `parent_folder_id` defaults to null (= root of the surface); pass a folder id to descend into a sub-folder.","read_only":false},{"name":"get_file","title":"","description":"Fetch metadata + a download URL for a single file by id. The `download_url` field is a Dock URL (not a storage URL): GET it with your Dock API key and access is re-checked on every request. Useful for an agent reading file contents server-side (HTTP GET the URL) or surfacing a download link in a reply.","read_only":false},{"name":"delete_file","title":"","description":"Delete a file by id. It moves to a 30-day trash, and its old link stops working immediately. Restorable during those 30 days via the REST PATCH endpoint (`PATCH /api/workspaces/{slug}/files/{id} body: {restore:true}`); after that the cleanup deletes it for good and refunds the storage quota. If the delete can't complete, the file is left as it was and the call fails, so retry. Editor role required","read_only":false},{"name":"share_file","title":"","description":"Mint a public share token for a file. Returns a `url` of the form `https://trydock.ai/share/files/<token>` that anyone (no auth) can open to view + download the file. The token is 32 random bytes (~256 bits of entropy) so guessing is infeasible. Revoke later with `revoke_file_share`. Editor role required. For human users only: agents are refused, because a public link lets anyone outside the works","read_only":false},{"name":"revoke_file_share","title":"","description":"Soft-revoke a share token minted via `share_file`. The public `/share/files/<token>` URL stops resolving immediately. Idempotent: revoking an already-revoked token returns `alreadyRevoked: true` without error. Editor role required.","read_only":false},{"name":"list_recent_files","title":"","description":"List the 50 most recently updated files in a Files surface, sorted by `updatedAt` descending. Flat surface-wide list; ignores folder structure. Useful for an agent answering 'what changed lately' or 'show me yesterday's uploads' without paging through the folder tree. Folders are omitted from this view.","read_only":false},{"name":"address_book","title":"","description":"Lists the agents you can reach — your own agents AND agents shared to you from other owners. To MESSAGE any of them, use the `message_teammate` tool (it delivers AND wakes the recipient). Do NOT use send_message for an agent — that path does not wake them and the message can strand. Each entry has three identity fields, and it matters which you use:\n• `name` — the agent's DISPLAY NAME, for reading","read_only":false},{"name":"upload_file","title":"","description":"Upload a file into a Files surface (kind='files'). For a file over ~3 MB, or any file on your own machine, call `create_file_upload` first: run the curl it returns, then pass the `url` from its response here. You never need a public host to put your own file into Dock. The response includes `url`, the file's stable Dock address: embed THAT in a doc (`![alt](url)`) to show the image to workspace me","read_only":false},{"name":"create_file_upload","title":"","description":"Get a one-time upload link for a file that is on YOUR machine (a PDF, image, spreadsheet, audio, archive, anything over ~3 MB), so you can put it into Dock without a public host. Returns a ready `curl` command: run it with your file path in place of `<path to your file>`; its JSON response has a `url`. Then call `upload_file` with that `url` (plus `surface_slug` and `filename`). The link accepts O","read_only":false},{"name":"delete_file_upload","title":"","description":"Delete a staged upload right away: pass the `url` a `create_file_upload` link returned, with the same workspace `slug`. Use it to revoke a staged `url` that was shared by mistake, or one you no longer need. Only a `url` from a `create_file_upload` link for this workspace is accepted; anything else is refused and nothing is deleted. A `url` that is already gone counts as deleted. Files already in a","read_only":false},{"name":"list_videos","title":"","description":"List the videos in a video surface, in play order: id, position, label, name, url (the file), content type, size, duration and `link`, the Dock link that opens THAT video. When you point someone at a video, share its `link`, not the surface link: the surface opens on its first video. Omit `surface_slug` for the workspace's first video surface. Viewer role required.","read_only":false},{"name":"add_video","title":"","description":"Add a video to the end of a video surface, from an https URL to an mp4, webm, mov or m4v file. A surface holds several videos (variants, cuts, a short playlist) that people flip through; give each a short `label` like \"Variant B\" so they can tell them apart. Create the surface first with `create_surface` and `kind: \"video\"`. Pass `content_type` when the URL has no file extension. For a file on you","read_only":false},{"name":"create_video_upload","title":"","description":"Get a one-time upload link for a video file that is on YOUR machine (one you rendered, edited or downloaded), so you can put it on a video surface. `add_video` needs an https URL, and inline base64 is unreliable for video, so use this instead. Returns a ready `curl` command: run it with your file path in place of `<path to your file>`; its JSON response has a `url`. Pass that `url` to `add_video`.","read_only":false},{"name":"update_video","title":"","description":"Change one video in a video surface: swap its file (`url`), rename it, relabel it, or move it in the play order (`position`; pass only `position` to reorder). Get `video_id` from `list_videos`. Omitted fields stay as they are. Returns `url`, the Dock link that opens this video. Editor role required. Emits `video.updated`.","read_only":false},{"name":"remove_video","title":"","description":"Remove one video from a video surface. Get `video_id` from `list_videos`. Editor role required. Emits `video.updated`.","read_only":false},{"name":"watch_video","title":"","description":"Look at a video in a video surface: returns frames as images, each labelled with its time, plus what is said in that span (transcribed and cached on first use). With no position you get an overview spread across the whole video. When someone points at a moment (\"I don't like 1:34\"), pass `at: \"1:34\"` to see the seconds around it; `start`/`end` show a range; `times` shows exact moments. Inside a sp","read_only":false},{"name":"get_video_transcript","title":"","description":"What is said in a video in a video surface, as timestamped segments. Transcribed on first use, then cached on the video until its file changes. Pass `start`/`end` for a span. Viewer role required.","read_only":false},{"name":"edit_video","title":"","description":"Make a new version of a video in a video surface. Combine any of: `remove` to take ranges OUT and keep everything else (\"cut that bit\", \"lose the radio shot\": find the exact start and end with watch_video first); `keep` to keep ONLY one span and drop the rest (\"just give me 0:10 to 0:20\"); `format` mp4, mov or webm; `width`/`height` to resize (give one to keep the shape); `aspect` to center-crop t","read_only":false},{"name":"bulk_create_rows","title":"","description":"Append many rows to a workspace's table surface in ONE call — the bulk version of create_row. Use this instead of looping create_row when ingesting more than a few rows (lower latency + token cost). Pass `rows` as an array of `{ data: {...} }` objects, each `data` a column-name → value map (same shape create_row takes). Up to 500 rows per call. WRITE AS YOU GO on long jobs (scraping, enrichment, a","read_only":false},{"name":"bulk_update_rows","title":"","description":"Update many existing rows in ONE call — the bulk version of update_row. Use this instead of looping update_row when changing more than a few rows (much lower latency + token cost for sheet edits). Pass `updates` as an array of `{ id, data }`: `id` is the row id (from list_rows / get_row), `data` is a column-name → value map of just the cells to change. Each row's data is MERGED into the existing r","read_only":false}],"server_info":{"name":"dock","version":"1.0.0","title":"Dock: shared workspaces for agents"},"category":"image-video","tags":["productivity","agents","automation"],"kind":"remote","source":"registry","submitted":{},"first_party":true,"domain_rank":null,"score":100,"indexable":true,"first_seen":"2026-05-15","stars":0,"badges":[],"sponsor":null,"page":"https://agentsindex.org/agents/ai-trydock-dock/"}