List daily suggestions
Lists the daily suggestions Koast raised on Home for the active brand: each card's kind (pause, lower or raise a budget, a note), its state, title, reason with its numbers and date ranges, expected effect, when it expires, and the result once a person decided it.
Tool name: list-agent-suggestions.
Lists the daily suggestions Koast raised on Home for the active brand: each card's kind (pause, lower or raise a budget, a note), its state, title, reason with its numbers and date ranges, expected effect, when it expires, and the result once a person decided it. Read-only: only a person approves or declines a card, on Home.
When to use
The user asks what Koast suggested, why it suggested something, or what happened to a suggestion.
Access
| Property | Value |
|---|---|
| Required scope | read |
| Publishes | No |
| Read-only | Yes |
| Destructive | No |
| Idempotent | Yes |
| Open world | No |
Input
| Field | Type | Required | Description |
|---|---|---|---|
state | string | No | open: cards waiting for a person on Home. closed: approved, declined, expired or withdrawn ones. Default open. One of open, closed. |
days | integer | No | How many days back to look, 1 to 30. Default 7. Minimum 1, maximum 30. |
Output
| Field | Type | Required | Description |
|---|---|---|---|
state | string | Yes | One of open, closed. |
days | number | Yes | |
suggestions | object[] | Yes |
REST equivalent
MCP only. No REST operation does the same thing.
Get structure template rules
Return a human-readable summary of a structure template's engine rules (creative count, ad sets, placement/split, custom-rule flags, ops) and the distribution it will produce (sets x creatives).
List promo windows
Lists the active brand's promo windows, the sales the user entered in Koast: name, first and last day, how many days of aftermath follow, and whether each is coming up, running, in its aftermath or over.