MCP tools reference

3 read tools are always present. 7 write tools appear only when “Can edit pages” is on. 3 agent-management tools appear only for the workspace Writer. All tools return text content; JSON results are pretty-printed JSON strings.

Read tools#

browse

List every page in the agent page set with its use-when instructions. Call this first — it is the catalog the agent picks from. No arguments.

{
  "pages": [
    {
      "pageId": "pg_7f3a",
      "title": "Refund policy",
      "alwaysInclude": false,
      "useWhen": ["Use whenever a customer asks about refunds, returns, or chargebacks."]
    }
  ]
}

search_pages

Keyword filter over the page set. Titles weigh more than body text. Returns up to 8 hits with a short excerpt. Prefer browse unless the set is large.

get_page

Return the packed page: title, instructions, content, attached file text, and any pages or files its instructions say to use. Fails if the page is not in the set.

Write tools#

get_page_source

Editable registry markdown for a page, including drafts, plus title, tags, status, parent, path, and whether a version is in review. Read this before update_page.

create_page

Create a page. With parentId it becomes a subpage under that parent (use this to split a topic or add a child in the tree). Without parentId it is top-level and is added to the agent page set automatically.

update_page

Replace the whole body, title, or tags. Send the complete rewritten page — this is not a patch.

append_to_page

Add blocks to the end of a page without touching existing content. Good for logging a decision or adding an example.

prepare_file_upload

Returns a short-lived S3 PUT URL. PUT the file bytes to uploadUrl with the given Content-Type header. Do not send file contents to the MCP server.

attach_file

Create the file record after the PUT. Pass the s3Key from prepare_file_upload. Optional extractedText is packed into the page for other agents.

delete_file

Remove an attached file from a page in this set.

{
  "pageId": "pg_7f3a",
  "title": "Refund policy",
  "versionNumber": 4,
  "status": "in_review",
  "message": "Submitted as v4 and waiting for a human to approve it."
}

Agent tools#

These appear only when the connected agent is the workspace Writer (canManageAgents). Child agents created here never receive that flag, and they cannot take the reserved writer slug.

list_agents

List agents in the workspace: name, slug, permissions, and page count. No API keys.

create_agent

Create a narrower agent and return one API key (shown once). Cannot create another Writer or grant agent-management rights.

update_agent

Change name, product, description, status, page set, or permissions. Cannot change slug or canManageAgents. Pause instead of deleting. Writer edit/publish rights cannot be removed over MCP.