MCP Tools
Plans & Playbooks

update_playbook_step_status

Complete a content or checklist playbook cycle step (with optional result_url and note) or reopen a completed checklist step back to Accepted.

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.
plan_uuidstring (uuid)Yes—Cycle step plan_uuid (from get_playbook_cycle or list_my_playbook_steps).
actionstringYes—complete = mark step Complete (action steps require result_url + note); reopen = checklist steps only, returns to Accepted and clears evidence.
result_urlstringNo—http/https link to what was done (e.g. a Slack post or confirmation page). Include whenever a URL is given (REQUIRED for action steps on complete; optional only when no URL exists). Rejected on reopen.
notestringNo—Optional for content/checklist; REQUIRED for action steps on complete (what was done). Rejected on reopen.

Input Schema

{
  "type": "object",
  "required": [
    "team_id",
    "plan_uuid",
    "action"
  ],
  "properties": {
    "note": {
      "type": "string",
      "description": "Optional for content/checklist; REQUIRED for action steps on complete (what was done). Rejected on reopen."
    },
    "action": {
      "enum": [
        "complete",
        "reopen"
      ],
      "type": "string",
      "description": "complete = mark step Complete (action steps require result_url + note); reopen = checklist steps only, returns to Accepted and clears evidence."
    },
    "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."
    },
    "plan_uuid": {
      "type": "string",
      "format": "uuid",
      "description": "Cycle step plan_uuid (from get_playbook_cycle or list_my_playbook_steps)."
    },
    "result_url": {
      "type": "string",
      "description": "http/https link to what was done (e.g. a Slack post or confirmation page). Include whenever a URL is given (REQUIRED for action steps on complete; optional only when no URL exists). Rejected on reopen."
    }
  }
}

Output Schema

{
  "type": "object",
  "required": [
    "plan_uuid",
    "stage",
    "title",
    "run_id",
    "link_url",
    "cycle_link_url"
  ],
  "properties": {
    "note": {
      "type": [
        "string",
        "null"
      ]
    },
    "team": {
      "type": "object",
      "required": [
        "id",
        "name"
      ],
      "properties": {
        "id": {
          "type": "integer"
        },
        "name": {
          "type": "string"
        }
      },
      "description": "Team this action applied to."
    },
    "stage": {
      "enum": [
        "Accepted",
        "Complete"
      ],
      "type": "string"
    },
    "title": {
      "type": "string"
    },
    "run_id": {
      "type": "integer"
    },
    "link_url": {
      "type": "string"
    },
    "plan_uuid": {
      "type": "string",
      "format": "uuid"
    },
    "result_url": {
      "type": [
        "string",
        "null"
      ]
    },
    "completed_at": {
      "type": [
        "integer",
        "null"
      ]
    },
    "completed_by": {
      "type": [
        "integer",
        "null"
      ]
    },
    "cycle_link_url": {
      "type": "string"
    }
  }
}

Instructions

Updates a playbook cycle step's completion status (plan_uuid from get_playbook_cycle or list_my_playbook_steps). Does NOT handle general plan edits (use update_plan for title, prompt, due date, assignee, targeting, or Dismissed).

Actions (action, required)

  • complete: marks content or checklist steps Complete and records proof via optional result_url and note. Open action steps cannot be completed over external MCP (always refused with "Complete this action from its current Marcora conversation"); action steps are completed only inside a Marcora conversation (requiring both result_url and note). Refuses Dismissed steps (409) and plans that are not playbook cycle steps. Repeating complete keeps original completed_at / completed_by while newly supplied result_url / note overwrite previous values (omit them to preserve recorded values).
  • reopen: checklist steps only (refuses content and action steps with 409); returns Complete back to Accepted and clears recorded completion evidence. Rejects result_url / note if sent.

Requires edit access (step assignee or creator). Present link_url as returned.

When to use

When the user wants to mark a cycle step complete with proof (action: "complete") or untick a completed checklist step (action: "reopen"). Find plan_uuid via get_playbook_cycle or list_my_playbook_steps.

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.