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

Terrain

animateTerrain

Animate Terrain

Play a bounded animation on the owner's Terrain.

write

Ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "flash that agent on the map", and it calls animateTerrain.

Example call

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

{
  "arguments": {
    "animation": "<animation>"
  },
  "name": "animateTerrain"
}

Arguments

• animationstringrequiredWhich animation to play.
• durationMsintegeroptionalHow long it plays, 200 to 60000 ms. Defaults to 2000.
• fromstringoptionalFor animation: route. A unit id from readTerrain.
• spacestringoptionalA Space id. Works on that Space's shared terrain layout instead of your own: its members read it, its editors shape it. Omit for your own terrain.
• tostringoptionalFor animation: route. A unit id from readTerrain.
• unitIdstringoptionalFor animation: beacon or pulse. A character or district id from readTerrain.

Returns

The registry does not declare a return shape.

Declared limits

• durationMs: minimum 200
• durationMs: maximum 60000
• from: maximum length 128
• space: maximum length 128
• to: maximum length 128
• unitId: maximum length 128

Ask for it

The Cloud routes these requests to this verb.

• flash that agent on the map
• pulse the Mac mini
• draw a line from the lead to the builder
• highlight what just failed

Pair it with

The verbs that finish the job.

• readTerrain
• focusTerrain
• listAgentSessions

Questions

• What does animateTerrain do?

  Play a bounded animation on the owner's Terrain. It is one of the tools The Cloud MCP server gives every connected AI.

• How do I use animateTerrain 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 "flash that agent on the map", and it calls animateTerrain.

• Is animateTerrain safe to let an AI call?

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