Optimly MCP
Save Recommendation
Save one evidence-backed onsite or offsite recommendation to the shared Optimly Actions inbox.
save_recommendation · Partner Program · Authentication required
Save one evidence-backed onsite or offsite recommendation to the shared Optimly Actions inbox.
When to use
Use after reading get_agent_work, with a stable producer source reference. Do not save prose-only, duplicate, unsupported, or ungrounded recommendations.
Access
Approved agent access with agent-work write permission
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
title | string | Yes | Short recommendation title. |
body | string | Yes | Recommendation body. |
domain | string | Yes | Work domain. Allowed values: onsite, third_party_presence, media_outreach, earned_media_strategy. |
action_type | string | Yes | Concrete action type. Allowed values: owned_page, metadata_schema, internal_linking, site_file, third_party_profile, media_pitch, earned_media_plan. |
target | { url, kind, label } | Yes | Target of the recommendation. |
target_description | string | Yes | Human-readable target description. |
evidence | object[] | Yes | Supporting evidence items. |
rationale | string | Yes | Why this recommendation matters. |
expected_outcome | string | Yes | What success looks like. |
priority | number | Yes | Queue priority. |
readiness | string | Yes | Execution readiness. Allowed values: ready, needs_customer_input, blocked_by_prerequisite, needs_technical_validation, needs_internal_clarification. |
confidence | string | Yes | Evidence confidence. Allowed values: high, medium, low. |
estimated_effort | string | Yes | Estimated effort. Allowed values: small, medium, large. |
canonical_key | string | Yes | Stable deduplication key for this recommendation. |
producer | { id, type, sourceCreatedAt, sourceReference } | Yes | Producing agent identity and source reference. |
actor | { type, id } | Yes | Actor identity; type is human, agent, or system. |
implementation_package | string | No | Optional paste-ready implementation content. |
parent_work_item_id | uuid | No | Parent work item when this extends existing work. |
brand_id | uuid | No | Authorized brand ID. Required when more than one brand is available. |
Example prompt
Save this evidence-backed FAQ page recommendation to our Optimly Actions inbox.
Side effects and safety
Creates a work item in the brand's shared Optimly Actions inbox. Canonical keys deduplicate repeated saves.