batuhan · Oct 27, 2026 · Oct 31, 2026 · Oct 31, 2026 · Oct 31, 2026 · indent
diff --git a/content/agents/claude-code.mdx b/content/agents/claude-code.mdx
@@ -76,7 +76,7 @@ The live URL is appended only when it starts with `https://`. If the file is mis
 
 ## Verify it works
 
-Ask the agent to find a documentation page through `execute`. It should search for the documentation operation, describe it, and call it before attempting a publish.
+Ask the agent to search the docs. It should call the `searchDocs` tool directly, which proves the operation tools are wired up before you publish.
 
 <Prompt description="Use the Spacefast MCP server to search the docs for custom domains." actions={["copy"]}>
 Use the Spacefast MCP server to search the docs for custom domains.
@@ -116,4 +116,4 @@ How much traffic did this Space get in the last 30 days?
 Roll this Space back to the previous version.
 </Prompt>
 
-The first five map to typed tools. The rollback goes through `execute`, which may pause and ask you to approve the write in the browser before it runs. See [approvals](/agents/mcp-server).
+Each one maps to a tool. The rollback calls the `promoteSpaceVersion` operation, which may pause and ask you to approve the write before it runs. See [approvals](/agents/mcp-server#approvals).
diff --git a/content/agents/codex.mdx b/content/agents/codex.mdx
@@ -81,7 +81,7 @@ args = ["mcp", "proxy"]
 Use the Spacefast MCP server to search the docs for anonymous publishing.
 </Prompt>
 
-Ask the agent to find a documentation page through `execute`. It should search for the documentation operation, describe it, and call it before attempting a publish.
+Ask the agent to search the docs. It should call the `searchDocs` tool directly, which proves the operation tools are wired up before you publish.
 
 <Prompt description="Publish this folder to Spacefast and give me the live URL." actions={["copy"]}>
 Publish this folder to Spacefast and give me the live URL.
@@ -105,4 +105,4 @@ Show DNS and TLS status for every domain on this Space.
 Make this Space public and confirm the access setting afterwards.
 </Prompt>
 
-The last one goes through `execute`, which can pause for your approval before the write lands.
+The last one changes access, so it can pause for your approval before the write lands. See [approvals](/agents/mcp-server#approvals).
diff --git a/content/agents/cursor.mdx b/content/agents/cursor.mdx
@@ -3,7 +3,7 @@ title: Cursor
 description: Install the Spacefast plugin in Cursor, or add the MCP server to mcp.json by hand
 ---
 
-The Spacefast plugin lets Cursor publish your project and call API operations through `execute`, within the permissions you approved. Some actions remain reserved for a signed-in person.
+The Spacefast plugin lets Cursor publish your project and call every API operation as its own tool, within the permissions you approved. Some actions remain reserved for a signed-in person.
 
 ## Install
 
@@ -74,7 +74,7 @@ Writing this file by hand or through the CLI keeps every other top-level key int
 Use the Spacefast MCP server to search the docs for version rollback.
 </Prompt>
 
-Ask the agent to find a documentation page through `execute`. It should search for the documentation operation, describe it, and call it before attempting a publish.
+Ask the agent to search the docs. It should call the `searchDocs` tool directly, which proves the operation tools are wired up before you publish.
 
 <Prompt description="Publish this project to Spacefast and give me the live URL." actions={["copy"]}>
 Publish this project to Spacefast and give me the live URL.

diff --git a/content/agents/index.mdx b/content/agents/index.mdx
@@ -7,15 +7,16 @@ Connect your coding agent to Spacefast once, then ask it to publish. This page c
 
 ## What an agent can do
 
-Anything you can do in the dashboard, an agent can do over MCP. The Spacefast MCP server exposes five tools.
+The MCP catalog exposes eligible API operations as individual tools. Each tool uses its operation ID: `getAccount`, `listSpaces`, `searchDocs`, `createDomain`, and a few hundred more. Clients that support tool search load them on demand.
+
+A handful of tools sit on top of that catalog.
 
 - `publish` uploads a folder, a file, an archive, or inline files and returns the live URL and the immutable version URL.
 - `operation_status` checks a publish that is still running.
-- `show_space` opens a read-only view of deployments, domains, analytics, source files, changes, history, comparisons, or build logs.
-- `execute` runs one JavaScript program against the Spacefast API catalog. Use it for documentation, account information, API reads without a visual view, and mutations.
-- `resume_execution` continues the same program after it pauses for your approval.
+- The `show_space_*` tools open a visual view of a Space: its preview, deployments, domains, analytics, comments, source, build logs, or database.
+- `resume_execution` continues a call that paused for your approval.
 
-Inside `execute`, search for an operation with `tools.search`, read its contract with `tools.describe`, then call it. Check each write with a read before reporting success.
+Check each write with a read before reporting success.
 
 If your team has a saved [Design System](/design-system), your agent can read its standards and files while working on a project. Ask it to apply the system to a new build or bring an existing project into line with the current rules.
 
@@ -31,7 +32,7 @@ Show me the deployments for this Space and whether the last build passed.
 Point docs.example.com at this Space and tell me which DNS records to add.
 </Prompt>
 
-Read [the MCP server page](/agents/mcp-server) for the tool schemas, the sandbox contract, and the approval model.
+Read [the MCP server page](/agents/mcp-server) for the full tool list, the scopes, and the approval model.
 
 ## Three ways to connect