WolfSuite Workspace · Documentation
MCP tools reference
A Wolf Workspace room gives an agent eight MCP tools for reading, searching, creating and editing its Word, Excel, PowerPoint and PDF files. An edit is a proposal for a person to approve unless the agent saves directly. 1 2 3
The tools
The tool list is workspace_list, doc_read, doc_search, doc_create, doc_edit, doc_inspect_visual, pack_link_refresh and comment_reply, in that order. The whole list serializes to under 14,000 bytes, about 3,500 tokens. 1 4
| Tool | Arguments | What it does | Evidence |
|---|---|---|---|
workspace_list | format, limit | Lists the room's documents with their current revision and the proposals and threads open on each, filtered by format and cut at the limit. | 5 6 |
doc_read | doc (required), view, target, max_nodes | Reads a document as structure with addresses, as text or markdown, whole or at an address, or a workbook as cells. | 7 8 9 |
doc_search | query (required), doc, regex, limit | Finds text ignoring case and returns addresses doc_read accepts. The query is a literal unless regex is true. | 10 11 |
doc_create | name and format (required), template, ops | Creates a blank document or a copy of a template, and saves any first operations as its first change. | 12 13 14 |
doc_edit | doc, base_revision, mode, ops (all required), message | With mode: "propose" holds the operations for a person; with mode: "commit" saves them at once and reports the new revision. | 2 3 |
doc_inspect_visual | doc (required), pages, dpi, preflight, proposal_id | Renders pages for a visual check. A server started without a renderer refuses with BAD_REQUEST and the reason no-renderer. | 15 |
pack_link_refresh | pack (required), bindings, mode | Refreshes linked figures from a pack. A server started without packs refuses with BAD_REQUEST and the reason no-pack-refresher. | 15 |
comment_reply | thread_id and body (required), resolve | Replies in a comment thread as the agent, and resolves the thread when resolve is true. | 16 17 |
The edit loop
- Read the document with
doc_readand note its revision. 18 - Call
doc_editwith that revision asbase_revisionandmode: "propose". Nothing changes yet. 2 - A person approves in the web app, which saves the change as the next revision. 19
- Read the result, then reply in the thread with
comment_replyand resolve it. 18
Proposing the same change twice returns the proposal already open instead of opening another. 20
Errors
| Code | Meaning | Evidence |
|---|---|---|
REVISION_MISMATCH | base_revision is older than the document. The error carries the current revision to read and start again from. | 21 |
UNKNOWN_DOCUMENT | No document in the room has that name. | 22 |
UNKNOWN_THREAD | No comment thread has that id. | 23 |
LICENSE_LIMIT | The workspace is read-only. The message gives the reason and the way to upgrade. | 24 |
An argument a tool does not define is refused, and the error lists the arguments that tool does define. 25
When the workspace has no seat for the agent, doc_read and workspace_list are refused and the agent takes no seat. 26
Transports
Over HTTP, initialize opens a session and returns its id, and every later request must carry a session id that server holds. 27 28
Over stdio, a call before initialize is refused, and invalid arguments are JSON-RPC error -32602. 29
Evidence
Each numbered reference above points to the test that exercises the statement or to a recorded observation of the hosted service at workspace.wolfsdk.com. Test paths are relative to the WolfSuite repository.
- Test
sdk/web/packages/protocol/test/workspace.test.ts: “eight tools, in order” - Test
sdk/web/packages/mcp/test/tools.test.ts: “propose holds the ops for a person and changes nothing” - Test
sdk/web/packages/mcp/test/tools.test.ts: “commit applies the ops at once and reports the new head and the log entry” - Test
sdk/web/packages/protocol/test/workspace.test.ts: “the serialized tool list is under 14000 UTF-8 bytes and 3500 tokens” - Test
sdk/web/packages/mcp/test/tools.test.ts: “lists the documents with their heads and what is open on them” - Test
sdk/web/packages/mcp/test/tools.test.ts: “filters by format and cuts at the limit” - Test
sdk/web/packages/mcp/test/tools.test.ts: “reads the structure with addresses, kinds and text previews” - Test
sdk/web/packages/mcp/test/tools.test.ts: “reads text and markdown, whole or at an address” - Test
sdk/web/packages/mcp/test/tools.test.ts: “reads the cells of a workbook, and refuses the cells of a document” - Test
sdk/web/packages/mcp/test/tools.test.ts: “finds a literal ignoring case, with an address that doc_read accepts” - Test
sdk/web/packages/mcp/test/tools.test.ts: “a literal is not a pattern” - Test
sdk/web/packages/mcp/test/tools.test.ts: “creates a blank document that can be read at once” - Test
sdk/web/packages/mcp/test/tools.test.ts: “copies a template” - Test
sdk/web/packages/mcp/test/tools.test.ts: “applies the first ops as a commit and reports its entry” - Test
sdk/web/packages/mcp/test/tools.test.ts: “doc_inspect_visual and pack_link_refresh say so instead of pretending” - Test
sdk/web/packages/mcp/test/tools.test.ts: “replies in the thread as the agent” - Test
sdk/web/packages/mcp/test/tools.test.ts: “resolves the thread with the reply” - Test
sdk/web/packages/mcp/test/workflow.test.ts: “the agent proposes, the person approves, the agent reads the result and settles the thread” - Test
sdk/web/packages/mcp/test/tools.test.ts: “a person approving the proposal commits it, and the agent then reads the result” - Test
sdk/web/packages/mcp/test/tools.test.ts: “a repeated propose answers with the proposal already open, says existed, and opens nothing” - Test
sdk/web/packages/mcp/test/tools.test.ts: “a stale base_revision is REVISION_MISMATCH carrying the head to rebase on” - Test
sdk/web/packages/mcp/test/tools.test.ts: “an unknown document is UNKNOWN_DOCUMENT” - Test
sdk/web/packages/mcp/test/tools.test.ts: “an unknown thread is UNKNOWN_THREAD” - Test
sdk/web/packages/server/test/read-only.test.ts: “is LICENSE_LIMIT with a stable reason, and a message with the reason and the upgrade path verbatim” - Test
sdk/web/packages/mcp/test/tools.test.ts: “an undefined argument is refused with the defined arguments for every tool” - Test
sdk/web/packages/mcp/test/tools.test.ts: “an agent without a seat is refused doc_read and workspace_list, and takes none” - Test
sdk/web/packages/mcp/test/http.test.ts: “initialize opens a session and returns its id” - Test
sdk/web/packages/mcp/test/http.test.ts: “the session is required, and must be one this server holds” - Test
sdk/web/packages/mcp/test/stdio.test.ts: “a call before initialize is refused, and invalid arguments are -32602”