generate_cycle_content
Start "Generate all" on a playbook cycle: generate the document for every step that has none yet, in step order. Runs in the background and uses Studio Credits.
Parameters
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
team_id | integer | Yes | — | Team id to act in (from initialize instructions or get_current_user_info). Required on external MCP; optional in bound sessions. |
run_id | integer | Yes | — | Cycle id — the run_id from list_playbook_cycles / instantiate_playbook. |
Input Schema
{
"type": "object",
"required": [
"team_id",
"run_id"
],
"properties": {
"run_id": {
"type": "integer",
"description": "Cycle id — the integer run_id from list_playbook_cycles / instantiate_playbook, not a UUID."
},
"team_id": {
"type": "integer",
"minimum": 1,
"description": "Team id to act in (from initialize instructions or get_current_user_info). Required on external MCP; optional in bound sessions."
}
}
}Output Schema
{
"type": "object",
"properties": {
"team": {
"type": "object",
"required": [
"id",
"name"
],
"properties": {
"id": {
"type": "integer"
},
"name": {
"type": "string"
}
},
"description": "Team this action applied to."
},
"batch": {
"type": [
"object",
"null"
],
"properties": {
"id": {
"type": "string"
},
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"title": {
"type": "string"
},
"reason": {
"type": [
"string",
"null"
],
"description": "Machine reason for skipped / blocked / failed / not_started pieces."
},
"status": {
"enum": [
"queued",
"generating",
"done",
"failed",
"blocked",
"skipped",
"not_started"
],
"type": "string"
},
"message": {
"type": [
"string",
"null"
]
},
"position": {
"type": "integer",
"description": "1-based step position in the cycle."
},
"plan_uuid": {
"type": "string"
},
"depends_on": {
"type": "array",
"items": {
"type": "string"
},
"description": "plan_uuids of earlier steps this piece builds on."
},
"generation_id": {
"type": [
"string",
"null"
],
"description": "Pass to get_generation_status for that piece."
}
}
}
},
"run_id": {
"type": "integer"
},
"status": {
"enum": [
"running",
"completed",
"stopped",
"interrupted"
],
"type": "string"
},
"message": {
"type": [
"string",
"null"
]
},
"created_at": {
"type": "integer"
},
"updated_at": {
"type": "integer"
},
"stop_reason": {
"type": [
"string",
"null"
]
}
}
},
"pieces": {
"type": "array",
"items": {
"type": "object",
"properties": {
"title": {
"type": "string"
},
"reason": {
"type": [
"string",
"null"
],
"description": "Machine reason for skipped / blocked / failed / not_started pieces."
},
"status": {
"enum": [
"queued",
"generating",
"done",
"failed",
"blocked",
"skipped",
"not_started"
],
"type": "string"
},
"message": {
"type": [
"string",
"null"
]
},
"position": {
"type": "integer",
"description": "1-based step position in the cycle."
},
"plan_uuid": {
"type": "string"
},
"depends_on": {
"type": "array",
"items": {
"type": "string"
},
"description": "plan_uuids of earlier steps this piece builds on."
},
"generation_id": {
"type": [
"string",
"null"
],
"description": "Pass to get_generation_status for that piece."
}
}
},
"description": "Present only when nothing_to_generate: why each step was skipped."
},
"started": {
"type": "boolean",
"description": "false when a batch is already running or there is nothing to generate."
},
"cycle_link_url": {
"type": "string"
},
"nothing_to_generate": {
"type": "boolean"
}
}
}Instructions
Start Generate all on a playbook cycle: generate the document for every step that has none yet, in step order, on the server. It keeps going after this call returns. Each step is generated with the cycle's topic and the steps it builds on.
Only content steps assigned to you (or created by you) are generated. Checklist and action steps, dismissed steps, steps that already have a document, and teammates' steps are skipped, each with a reason.
This uses the team's Studio Credits, one generation per step. Confirm with the user before calling it. If credits run out, the batch stops cleanly and the remaining steps are reported as not_started. Only one batch runs per cycle at a time: calling it again while one is running returns started: false with the running batch.
Async: this returns immediately. Follow progress with get_cycle_generation, and use a step's generation_id with get_generation_status for a single step.
When to use: when the user asks to generate or write all the content in a cycle at once. For one step, use produce_plan.
Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
team_id |
integer | Yes* | Team ID to act in (required on external MCP; optional in bound sessions) |
run_id |
integer | Yes | Cycle id: the run_id from list_playbook_cycles or instantiate_playbook |
Output:
| Field | Type | Description |
|---|---|---|
started |
boolean | false when a batch is already running or there is nothing to generate |
nothing_to_generate |
boolean | true when every step was skipped |
batch |
object | null | The batch: id, run_id, status (running, completed, stopped or interrupted), stop_reason, message, items, created_at, updated_at |
pieces |
array | Only when nothing is generated: why each step was skipped |
cycle_link_url |
string | Opens the cycle in the Marcora web app |
Each entry in items (and pieces) has position, plan_uuid, title, status (queued, generating, done, failed, blocked, skipped or not_started), reason, message, generation_id and depends_on (the earlier steps it builds on).
Example prompts:
- "Generate all the content in my launch cycle"
- "Write every step of this cycle"
Links: present link_url to the user exactly as returned — copy it character for character. Never retype, shorten, or rebuild a link or the IDs inside it.