Optimly Developer Documentation

Optimly MCP

Get Agent Work

In short

Read the selected brand's current recommendations, drafts, queue placement, dismissals, and checklist state before proposing new work. This tool never changes work.

get_agent_work · Partner Program · Authentication required

Read the selected brand's current recommendations, drafts, queue placement, dismissals, and checklist state before proposing new work. This tool never changes work.

When to use

Always call this before save_recommendation or save_draft to avoid duplicates and respect dismissals.

Access

Partner Program or approved access with read_brand permission

Parameters

ParameterTypeRequiredDescription
brand_iduuidNoAuthorized brand ID. Required when more than one brand is available.
include_dismissedbooleanNoInclude dismissed items.

Example prompt

What work is already in our Optimly Actions inbox?