1. Docs
2. /
3. Tool reference
4. /
5. Loops
6. /
7. createLoop

Loops

createLoop

Create Loop

Create a Loop: a recurring AI recipe (prompt + style preset) that fires on a cadence (interval/cron/idle) against an optional target (a repo, Space, Studio app, or task), with a model, write policy,…

write

Ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "set up a loop that", and it calls createLoop.

Example call

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

{
  "arguments": {
    "title": "<title>",
    "promptBody": "<promptBody>",
    "archetype": "<archetype>",
    "trigger": {},
    "target": {},
    "writePolicy": "<writePolicy>"
  },
  "name": "createLoop"
}

Arguments

• titlestringrequiredThe loop's display name.
• promptBodystringrequiredThe recurring prompt this loop's recipe runs.
• archetypestringrequiredThe style preset: audit (idle + suggestOnly review), automation (cron/interval + write), digest (periodic summary), or outreach.
• triggerobjectrequiredThe cadence: interval, cron, or idle.
• targetobjectrequiredWhat the loop is bound to.
• writePolicystringrequired'suggestOnly' sandboxes every run read-only (no write/commit/push: a report is the deliverable); 'write' lets a run act. This is the write CEILING; raising it later invalidates consent until the human owner reconsents.
• iconographystringoptionalAn emoji or short glyph for the loop. Defaults to a generic icon.
• descriptionstringoptionalA short description of what this loop does.
• modelstringoptionalModel id to run with. Omit to use the native default.
• budgetsobjectoptionalPer-loop guardrails enforced by the same gate every scheduled fire goes through.
• concurrencyCapnumberoptionalMax in-flight runs for this loop at once. Defaults to 1.

Returns

The registry does not declare a return shape.

Ask for it

The Cloud routes these requests to this verb.

• set up a loop that
• make this run every day
• automate this recipe
• create a recurring check on X

Pair it with

The verbs that finish the job.

• listLoops
• updateLoop
• runLoopNow

Questions

• What does createLoop do?

  Create a Loop: a recurring AI recipe (prompt + style preset) that fires on a cadence (interval/cron/idle) against an optional target (a repo, Space, Studio app, or task), with a model, write policy,… It is one of the tools The Cloud MCP server gives every connected AI.

• How do I use createLoop 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 "set up a loop that", and it calls createLoop.

• Is createLoop safe to let an AI call?

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