MCP Tools
Plans & Playbooks

update_playbook_cycle

Rename a running playbook cycle and change or clear its topic.

Parameters

NameTypeRequiredDefaultDescription
team_idintegerYes—Team id to act in (from initialize instructions or get_current_user_info). Required on external MCP; optional in bound sessions.
run_idintegerYes—Cycle id: run_id from list_playbook_cycles / instantiate_playbook.
namestringNo—New name. Omit to keep it; cannot be blank.
topicstring | nullNo—New topic. Omit to keep it; null or blank clears.

Input Schema

{
  "type": "object",
  "required": [
    "team_id",
    "run_id"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "New name. Omit to keep it; cannot be blank."
    },
    "topic": {
      "type": [
        "string",
        "null"
      ],
      "maxLength": 4000,
      "description": "New topic. Omit to keep it; null or blank clears."
    },
    "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": {
    "name": {
      "type": "string"
    },
    "team": {
      "type": "object",
      "required": [
        "id",
        "name"
      ],
      "properties": {
        "id": {
          "type": "integer"
        },
        "name": {
          "type": "string"
        }
      },
      "description": "Team this action applied to."
    },
    "topic": {
      "type": [
        "string",
        "null"
      ]
    },
    "run_id": {
      "type": "integer"
    },
    "link_url": {
      "type": "string",
      "description": "Opens the cycle in the Marcora web app."
    },
    "project_id": {
      "type": [
        "string",
        "null"
      ]
    },
    "updated_at": {
      "type": "integer",
      "description": "Unix ms timestamp."
    },
    "anchor_date": {
      "type": [
        "string",
        "null"
      ]
    },
    "playbook_id": {
      "type": "integer"
    },
    "project_name": {
      "type": [
        "string",
        "null"
      ]
    },
    "playbook_name": {
      "type": "string",
      "description": "Source playbook template name, or \"Deleted template\" when the template has been deleted."
    }
  }
}

Instructions

Rename a running playbook cycle and/or change or clear its topic (what the cycle is about) by run_id, returning the cycle (including project_id / project_name). Pass only what changes: name replaces the cycle name (it cannot be blank); topic replaces the topic (up to 4,000 characters; null or blank clears it). The topic is folded into the prompt of every content step generated afterwards, so steps already generated are not changed by it.

Targeting dimensions and context collections belong on individual content steps via update_plan and are refused here. To edit a step's title, prompt, due date, assignee, targeting, or to dismiss it, use update_plan with the step's plan_uuid (from get_playbook_cycle); to complete or reopen a step, use update_playbook_step_status.

When to use: when the user wants to retitle a running cycle or correct/extend what it is about. Find run_id with list_playbook_cycles.

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.