MCP Tools
Plans & Playbooks

list_playbook_owner_names

List the owner names in use on your team's playbook steps: agents, or people who are not team members, typed as a step's owner instead of picking a team member. Alphabetical, in the spelling first used. Read-only.

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.

Input Schema

{
  "type": "object",
  "required": [
    "team_id"
  ],
  "properties": {
    "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": {
    "total": {
      "type": "integer"
    },
    "owner_names": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Owner names in use, alphabetical."
    }
  }
}

Instructions

List the owner names in use on your team's playbook steps: agents, or people who are not team members, typed as a step's owner instead of picking a team member. Alphabetical, in the spelling first used. Read-only.

When to use: before setting owner_name on a playbook step (create_playbook, update_playbook, add_playbook_step, update_plan) so you pick the exact existing spelling, or before asking list_my_playbook_steps for the steps owned by a name. A name drops off the list once no step uses it.

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