Workspace MCP
Built-in tools that let any agent in ADE read other chats, tasks, diffs, and terminal output, and leave review comments.
On this page
What it is#
Every chat in ADE gets a built-in MCP server called videodraft_workspace. It lets the agent see the app around its chat: where it is, what other chats and tasks exist, what changed in the diff, and what the Run tab printed. It can also leave review comments on the diff for you.
- Every agent gets it: Claude Code, Codex, Grok Build, OpenCode, and VD Code.
- It works in VideoDraft mode and Code mode, with nothing to install or turn on.
- It reads. The only thing it writes is review comments on the diff.
- Enterprise data privacy leaves it on, because it runs on your Mac.
Not the MCP connector
The MCP connector lets agents outside ADE, such as Claude or ChatGPT, reach your VideoDraft account. Workspace MCP runs inside ADE and only sees ADE.
The tools#
| Tool | What it does |
|---|---|
| ade_whoami | Tells the agent which chat, task, and project it is in. |
| ade_list_projects | Lists your ADE projects. |
| ade_list_workspaces | Lists tasks, up to 100 per call. |
| get_workspace_status | Reports a task’s state and its open chats. |
| list_chats | Lists chats, up to 100 per call, with paging. |
| read_chat | Reads another chat in pages of turns: your prompts and the agent’s replies, never tool output. 8,000 characters by default, 30,000 at most. |
| search_transcripts | Finds past chats by text. Every word must match. Returns up to 20 chats with snippets. |
| get_workspace_diff | Reads what changed in the task. It starts with a file summary, then reads the files that matter. |
| diff_comment | Posts review comments inline on the diff, on a line or a range, on the old or new side. |
| get_terminal_output | Reads recent output from the Run tab or a terminal, 1,000 lines by default. |
| computer_use_status | Reports whether Computer Use is set up, and what is missing. |
Ask for it in plain words#
You do not name the tools. Describe what you want and the agent picks them.
Read what the design chat decided about the title card, then use it here.
Search my past chats for the grade we used on the Northwind promo.
Review this task’s diff and leave inline comments on anything risky.
The dev server in the Run tab crashed. Read its output and fix the cause.Agents read in pages
A long chat comes back a page at a time, and searches return snippets. Agents skim first and read only what they need, which keeps their context free for the work.