MCP 工具参考

Get the full content of a document section by document ID and section ID. Returns the section text and heading context; records a document-view audit event.

Create a group checklist, like a packing list: a new document holding it, plus a link anyone in the group opens to check items off without an account. Returns the same shape as create_poll, with checklist (items with ids) in place of poll. Read progress with get_checklist.

Create a document from inline Markdown. folderId sets the audience: a tier folder is visible to its members; omit it for the owner-only personal root. For content that already exists as a file, use presign_document_upload instead.

HTML BLOCKS Code blocks with language html render as live sandboxed previews: no cookies, storage, or network. The only loadable URLs are the vetted libraries /sandbox/libs/mermaid.min.js (then mermaid.initialize({startOnLoad:false}); mermaid.run()), /sandbox/libs/d3.min.js (global d3), /sandbox/libs/three.module.min.js (ES module), and /sandbox/libs/doom.js. The app's CSS variables follow light and dark mode and are a safe default: --color-foreground, --color-muted-foreground, --color-border and --color-card for text and surfaces, --color-primary (brand cyan) and --color-secondary-foreground (brand purple) for emphasis, --color-success, --color-warning and --color-destructive for status, and --color-chart-1 to --color-chart-5 for data series. You are free to use your own palette, gradients or imagery instead, especially when the request asks for something creative. Either way, use color to encode meaning rather than one accent on grey, say what each color means, and if you set your own colors, set background and text together so both modes stay readable. Height starts near 360px and follows the content. To chart data from the same document, name a json/csv/tsv/yaml fence (``json name=sales), a table or image with <!-- strata:name=sales --> on the line above it, or use the reserved name frontmatter (scalar fields). The html fence declares up to 8 names (``html uses="sales,team"). Inside the preview strata.data.get(name) returns {kind:'text', format, text} (parse it yourself; d3.csvParse, not split(',')), {kind:'table', columns, rows} (cells are strings), {kind:'frontmatter', values}, {kind:'image', url, width, height, alt}, or {kind:'unavailable', reason}. Re-render on the window strata:data event.

BLOG FRONTMATTER A blog: mapping in the first YAML frontmatter block designs the published post. typography: modern | editorial | expressive | technical. palette: strata | paper. blockControls, tableOfContents, coverInBody: visible | hidden. readingSurface: opaque | translucent (translucent only over a color or gradient wallpaper). accent, background: {light: "#RRGGBB", dark: "#RRGGBB"}, quoted; body text and accent need 4.5:1 contrast in both schemes. fonts.heading, fonts.body: Manrope | Syne | Fira Code | Georgia | Times New Roman | Arial | Helvetica | Verdana | Trebuchet MS | Palatino | Courier New | IBM Plex Mono. summary: up to 160 chars. tags: up to 10, each up to 32 chars. noindex: true | false. series: {name (up to 80 chars), order (integer from 1)}. cover, hero: the name of an image in this document, set with <!-- strata:name=cover --> on the line above it. wallpaper: exactly one of color {light, dark}; gradient {type: linear | radial, stops: 2 to 5 {light, dark}}; pattern {name: dots | grid | lines | paper | topographic | stars, tint: {light, dark}}; image (image name); html (name of an html block, plus fallback: {color: {light, dark}} or {image: name}). Unknown keys, malformed YAML, or invalid values block publishing; edits report blogValidation findings. A presentation: map whose settings do not parse turns presentation mode off; edits, and read_document by a caller who can edit, then report presentationSettings with the parser message.

Create a group poll: a new document holding the poll, plus a link people open to vote without an account. Returns documentId, widgetId, editorUrl, poll (options with ids), and share: status created or reused carries shareUrl (the voting link to hand on) and cardUrl; notCreated carries the reason. To retry after an error, pass the same idempotencyKey; it is echoed back. Read votes with get_poll_results.

Create a group sign-up sheet, like a potluck list: a new document holding it, plus a link anyone in the group opens to claim what they will bring, without an account. Each item can be claimed by one person, who gives a name; only they or the owner can release it. Returns the same shape as create_poll, with signupSheet (items with ids) in place of poll. Read claims with get_signup_sheet.

Export a presentation as standalone HTML or printed PDF. Returns a download URL valid for fifteen minutes. Presenter notes are removed from slide decks; opaque whole-deck HTML is rejected because note removal cannot be proven. A draft whose presentation: settings do not parse is refused: a caller who can edit the document gets the parser message, any other reader a refusal without it. A published edition always exports, with default settings in place of any that do not parse. PDF consumes the document owner's capture allowance; HTML is unmetered. PDF prints every slide in one headless page under a single sixty-second render deadline, with WebGL software-rendered and animation frozen to a still once a small render budget is spent, so a deck of many heavy scenes can time out where the HTML export succeeds.

Finish an upload after its PUT, creating the document or replacing an existing one's content. Idempotent. Returns { documentId, bytes, created }.

Search, list, or discover documents, spaces, and folders across the workspace. intent selects the kind of discovery (search, list, recent, related, info) and scope selects where to look. intent='info' with scope.type='document' returns a body-free summary — documentVersion, open comment and pending suggestion counts, a link, and presence when the collaboration group is enabled — the cheap way to poll whether a document moved since you read it. List folders and their scopes (a document's audience comes from its folder) with intent='list', scope.type='folders'. scope is a JSON object with a type field, not a string. Examples: {"scope":{"type":"all"}}, {"scope":{"type":"space","id":"space_..."}}, {"scope":{"type":"document","id":"doc_..."}}. Search uses hybrid keyword + semantic retrieval fused via Reciprocal Rank Fusion, so both short keywords and natural sentences work as queries. Filters cover status, owner, date ranges, includeShared, direction, sinceDays (for intent='recent'), and tokenBudget. Returns a uniform shape with items that carry id, title, snippet, score, and source attribution. Narrow scopes can return zero results even when matching content exists elsewhere in the workspace.

Read a checklist: each item checked or not, how many are done, and who last set each item when names are shown to you (always to the owner; to readers only if the owner allows it). widgetId is optional when the document holds one checklist.

Read company theme CSS and its verified source version for copying into a presentation.

Get the connection graph neighborhood around a document. Returns nodes (documents) and edges (connections) discovered by BFS traversal.

Optional parameters: - depth: BFS depth (default 2, max 5) - maxNodes: Maximum nodes to return (default 50, max 200)

Retrieve an image from a document as base64-encoded data.

The imageId is found in document content as [Image: alt text (imageId: <id>)] markers or ![alt](strata://image/<id>) in markdown.

Returns the image as inline base64 PNG data that can be viewed directly.

Read a poll's results: people per option, how many answered, and voter names when shown to you (always to the owner; to readers only if the owner allows it). In a poll with mode multiple one person can appear under several options, and an empty optionIds means none worked for them. widgetId is optional when the document holds one poll.

Read a sign-up sheet: each item open or claimed, how many are claimed, and who claimed each when names are shown to you (always to the owner; to readers only if the owner allows it). widgetId is optional when the document holds one sign-up sheet.

Insert Markdown blocks at a heading boundary without touching existing content: position is {kind: beforeSection | afterSection, sectionPath} or {kind: endOfDocument}. sectionPath is a heading path such as "Architecture > Database". Markdown follows the HTML BLOCKS and BLOG FRONTMATTER rules in create_document.

List company presentation themes available to copy.

Move a document into a folder, which changes who can see it. A personal folder is owner-only, a tier folder is visible to its members. A document in a team folder cannot be moved into a personal folder. A personal document can be moved into a personal folder only by its owner, and only into their own.

Start uploading a Markdown file into a new or existing document. Avoids re-emitting bytes you already have. Returns { uploadId, uploadUrl, requiredHeaders, expiresAt }.

Upload sequence: 1. presign_document_upload with contentLength (the file's byte count) and documentId to replace, or title [+folderId] to create 2. PUT the file bytes to uploadUrl with every requiredHeaders entry 3. finalize_document_upload with uploadId

Markdown follows the HTML BLOCKS and BLOG FRONTMATTER rules in create_document.

Read a document's content by ID.

Returns rendered Markdown. Records a document-view audit event. Large documents automatically return a structural outline instead of full content (default budget: 10000 tokens). The sections parameter accepts heading paths from that outline and returns only those sections.

Replace exact text in a document with new Markdown; set replaceAll to change every match. Prefer this targeted edit over rewrite_document. Markdown follows the HTML BLOCKS and BLOG FRONTMATTER rules in create_document.

Replace a document's whole body with inline Markdown. For content that already exists as a file, use presign_document_upload instead. Markdown follows the HTML BLOCKS and BLOG FRONTMATTER rules in create_document.

Grant a person access to a document by email, emailing an invitation to an external recipient when needed.

Revoke a user's access to a document.

Render presentation slides and return layout, contrast, binding, structure, and theme findings. Always executes checks and stores captures. Costs one capture per slide per viewport, with no repeat charge for the same render key this cycle. Checks at most two slides at one viewport per call. While status is more, the result carries a next continuation that covers the remaining slides and viewports. When status is failed, reason says why: renderTimedOut (a slide did not finish in time; check one slide per call or simplify its heaviest drawing), renderFailed, rendererUnavailable, conflict (safe to run again), limitReached, invalidRequest or internal. Omitted selection covers all slides at both viewports.

Query who is currently viewing or editing a document. Returns a list of collaborators with their entity type, display name, active section, status, and presence color. Useful for understanding who else is working on the document before making edits.

Accept a pending suggestion, applying its edit to the document.

Comment on a document: start a thread, optionally anchored to quoted text, or reply to one with parentCommentId.

Side effect: a comment or reply that @mentions an agent starts a task for that agent on the document. Mention an agent only when the user asked for that agent to act.

List comment threads on a document, optionally only active or resolved ones. truncated is true when more threads exist than were returned.

List pending suggestions on a document.

Propose a tracked edit that replaces exact text in a document, for a person to accept or reject. Refresh proposals carry baseVersion, sourceRef {documentId, sourceVersion}, and anchor {sectionPath, blockOrdinal, offset}.

Reject a pending suggestion without applying it.

Resolve a comment thread, or reopen a resolved one with resolved false.

Withdraw your own pending suggestion.

Check the publish status of a document. Returns the current state (draft/published), version number, and whether there are unpublished changes (content hash comparison).

Publish a document to your public profile. Creates a frozen snapshot of the current content. If the content hasn't changed since last publish, returns the existing version. Every successful call records a publication audit event.

Side effects: Creates a PublishedVersion record and copies Yjs state to a versioned S3 key. Your creator profile is provisioned at signup, so no profile is created as a side effect of publishing.

Unpublish a document, removing it from public view. The document returns to draft state and public URLs return 404. Published version records are retained for potential rollback.

Check the status of an agent task.

Returns the current status, tool call count, and output (if completed) or error (if failed).

Possible statuses: pending, running, completed, failed, cancelled, timedOut.

Invoke a platform agent to perform a task.

Specify the agent by ID or by name (mutually exclusive). Optionally provide a target document and a natural-language instruction.

Returns a task ID — use get_agent_status to poll for status and output. The agent executes asynchronously; this tool returns immediately after the task is created.