1. Docs
2. /
3. Tool reference
4. /
5. Terrain
6. /
7. placeOnTerrain

Terrain

placeOnTerrain

Place on Terrain

Place a LANDMARK on the owner's Terrain - a marker on the map that points at something real in their Cloud: a page, a task, or a thing (page, task, thing).

write

Ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "pin the build doc to the cloud plot", and it calls placeOnTerrain.

Example call

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

{
  "arguments": {
    "landmarkId": "<landmarkId>",
    "targetId": "<targetId>",
    "targetKind": "<targetKind>"
  },
  "name": "placeOnTerrain"
}

Arguments

• labelstringoptionalWhat the landmark reads as, up to 64 characters. Defaults to the target's title.
• landmarkIdstringrequiredYour own stable id for this landmark. Placing on the same id moves it.
• projectKeystringoptionalA plot key from readTerrain to sit the landmark on.
• spacestringoptionalRefused when given: a landmark only goes on your own terrain, never a Space's shared layout.
• targetIdstringrequiredThe id of the page, task or thing.
• targetKindstringrequiredWhat kind of thing the landmark points at.

Returns

The registry does not declare a return shape.

Declared limits

• label: maximum length 64
• landmarkId: maximum length 128
• projectKey: maximum length 128
• targetId: maximum length 128

Ask for it

The Cloud routes these requests to this verb.

• pin the build doc to the cloud plot
• put the ticket on the map
• mark that page on my terrain
• move that landmark to the other plot

Pair it with

The verbs that finish the job.

• readTerrain
• searchPages
• listTasks
• searchThings

Questions

• What does placeOnTerrain do?

  Place a LANDMARK on the owner's Terrain - a marker on the map that points at something real in their Cloud: a page, a task, or a thing (page, task, thing). It is one of the tools The Cloud MCP server gives every connected AI.

• How do I use placeOnTerrain 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 "pin the build doc to the cloud plot", and it calls placeOnTerrain.

• Is placeOnTerrain safe to let an AI call?

  placeOnTerrain 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.