Optimly MCP
Record Agent Feedback
Record explicit customer feedback on a recommendation or draft. Use the customer's stated reason and explanation; never invent feedback or treat silence as dismissal.
record_agent_feedback · Partner Program · Authentication required
Record explicit customer feedback on a recommendation or draft. Use the customer's stated reason and explanation; never invent feedback or treat silence as dismissal.
When to use
Use when a customer explicitly accepts, adapts, snoozes, dismisses, restores, or requests revision of a work item.
Access
Approved agent access with agent-work write permission
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
work_item_id | uuid | Yes | Work item receiving feedback. |
decision | string | Yes | Customer decision. Allowed values: accept, adapt, snooze, dismiss, restore, request_revision, mark_duplicate. |
reason | string | Yes | Customer's stated reason category, for example not_relevant, already_completed, duplicate, not_priority, or wrong_timing. The manifest enumerates the full set. |
explanation | string | Yes | Customer's stated explanation. |
actor | { type, id } | Yes | Actor identity; type is human, agent, or system. |
snoozed_until | string | No | Required for snooze decisions. |
suppress_similar | boolean | No | Suppress similar future work. |
suppression_expires_at | string | No | When suppression lapses. |
brand_id | uuid | No | Authorized brand ID. Required when more than one brand is available. |
Example prompt
The customer dismissed this recommendation as already completed — record that feedback.
Side effects and safety
Writes feedback to the work item and can suppress similar future recommendations.