MCP Tools
Plans & Playbooks

dismiss_playbook_suggestion

Dismiss a call-detected playbook suggestion so that initiative and occurrence will not be suggested again, optionally saving a standing call-guidance instruction.

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.
suggestion_idstring (uuid)Yes—UUID of the playbook suggestion to dismiss (from list_playbook_suggestions).
instructionobjectNo—Optional standing call-guidance rule to save atomically on first dismissal. Omit to dismiss only this initiative.

Input Schema

{
  "type": "object",
  "required": [
    "team_id",
    "suggestion_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."
    },
    "instruction": {
      "type": "object",
      "required": [
        "text"
      ],
      "properties": {
        "text": {
          "type": "string",
          "maxLength": 300,
          "minLength": 1,
          "description": "One-line guidance rule (no line breaks, 1-300 characters) applied to future calls."
        }
      },
      "description": "Optional standing call-guidance rule to save atomically on first dismissal. Omit to dismiss only this initiative."
    },
    "suggestion_id": {
      "type": "string",
      "format": "uuid",
      "description": "UUID of the playbook suggestion to dismiss (from list_playbook_suggestions)."
    }
  }
}

Output Schema

{
  "type": "object",
  "required": [
    "suggestion"
  ],
  "properties": {
    "team": {
      "type": "object",
      "required": [
        "id",
        "name"
      ],
      "properties": {
        "id": {
          "type": "integer"
        },
        "name": {
          "type": "string"
        }
      },
      "description": "Team this action applied to."
    },
    "suggestion": {
      "type": "object",
      "required": [
        "id",
        "initiative",
        "playbook",
        "call",
        "visibility",
        "variables",
        "anchor_date",
        "supporting_quote",
        "status",
        "run",
        "created_at",
        "updated_at"
      ],
      "properties": {
        "id": {
          "type": "string",
          "format": "uuid"
        },
        "run": {
          "type": [
            "object",
            "null"
          ],
          "required": [
            "playbook_run_uuid",
            "link_url"
          ],
          "properties": {
            "link_url": {
              "type": "string"
            },
            "playbook_run_uuid": {
              "type": "string",
              "format": "uuid"
            }
          }
        },
        "call": {
          "type": "object",
          "required": [
            "context_item_id",
            "name"
          ],
          "properties": {
            "name": {
              "type": "string"
            },
            "context_item_id": {
              "type": "string",
              "format": "uuid"
            }
          }
        },
        "status": {
          "enum": [
            "suggested",
            "started",
            "dismissed"
          ],
          "type": "string"
        },
        "coverage": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "item_id",
              "plan_uuid"
            ],
            "properties": {
              "item_id": {
                "type": "integer",
                "description": "Playbook step id already covered by an existing plan."
              },
              "plan_uuid": {
                "type": "string",
                "format": "uuid",
                "description": "UUID of the existing plan covering that step."
              }
            },
            "additionalProperties": false
          },
          "description": "Which steps the call already planned; edits to those steps are refused."
        },
        "playbook": {
          "type": "object",
          "required": [
            "playbook_uuid",
            "name",
            "link_url"
          ],
          "properties": {
            "name": {
              "type": "string"
            },
            "link_url": {
              "type": "string"
            },
            "playbook_uuid": {
              "type": "string",
              "format": "uuid"
            }
          }
        },
        "variables": {
          "type": "object",
          "additionalProperties": {
            "type": "string"
          }
        },
        "created_at": {
          "type": "integer",
          "description": "Unix ms timestamp."
        },
        "initiative": {
          "type": "object",
          "required": [
            "id",
            "name",
            "occurrence"
          ],
          "properties": {
            "id": {
              "type": "string",
              "format": "uuid"
            },
            "name": {
              "type": "string"
            },
            "occurrence": {
              "type": "string"
            }
          }
        },
        "updated_at": {
          "type": "integer",
          "description": "Unix ms timestamp."
        },
        "visibility": {
          "enum": [
            "private",
            "team"
          ],
          "type": "string"
        },
        "anchor_date": {
          "type": [
            "string",
            "null"
          ]
        },
        "supporting_quote": {
          "type": "string"
        }
      },
      "additionalProperties": false
    }
  }
}

Instructions

Dismiss a call-detected playbook suggestion (suggestion_id from list_playbook_suggestions) so that initiative and occurrence will not be suggested again.

Dismissing without instruction blocks only that specific initiative. Optionally pass instruction: { text } (one line, 1–300 chars) only when the user explicitly wants to save a standing call-guidance rule for future calls (for example, "never suggest newsletter playbooks"). Already-started suggestions are refused (409); repeating a dismissal is idempotent and ignores new instruction text.

When to use

When the user declines or dismisses a suggested playbook from a call. Get suggestion_id from list_playbook_suggestions.

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.