1. Docs
2. /
3. Tool reference
4. /
5. Pages & Spaces
6. /
7. replaceBlock

Pages & Spaces

replaceBlock

Replace Page Block

Replace one top-level page block by the blockId returned by readPage.

write

Ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "replace this block", and it calls replaceBlock.

Example call

The MCP tools/call params, with the required arguments only.

{
  "arguments": {
    "blockId": "<blockId>",
    "content": "<content>",
    "pageId": "<pageId>"
  },
  "name": "replaceBlock"
}

Arguments

• blockIdstringrequiredBlock ID from readPage
• contentstringrequiredReplacement markdown. Write {{now}} for the current time; the server fills it from the owner's clock.
• pageIdstringrequiredPage ID to edit

Returns

getWritingGuide returns chipNow, that Stamp token already filled, so paste it instead of typing a time.

Declared limits

• blockId: minimum length 1

Ask for it

The Cloud routes these requests to this verb.

• replace this block
• rewrite this paragraph
• change only this block

Pair it with

The verbs that finish the job.

• readPage
• insertAfterBlock
• deleteBlocks
• editSection

Questions

• What does replaceBlock do?

  Replace one top-level page block by the blockId returned by readPage. It is one of the tools The Cloud MCP server gives every connected AI.

• How do I use replaceBlock from Claude or ChatGPT?

  Connect your AI to The Cloud at https://mcp.thecloud.so/mcp and sign in once. Then ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "replace this block", and it calls replaceBlock.

• Is replaceBlock safe to let an AI call?

  replaceBlock changes your workspace. What an AI creates is Private until you share it.

Connect

One endpoint gives your AI this tool and every other one: connect Claude, ChatGPT, Cursor or Gemini, read what The Cloud is, or see pricing.