Set and manage business goals

Business goals are the strategic objectives a brand is pursuing — they give content work its "why." Reach for these tools when you need to understand what a brand is trying to accomplish, or to curate its goal list before generating content or recommendations.

When to use

Read goals before writing content so each piece maps to a real objective. Create or generate goals when a brand's priorities aren't yet captured. Goals are informed by AI visibility scan data plus the brand's own priorities.

Typical sequence

1. get_goals — see the existing list (and avoid duplicates).
2. create_goal (you write the title + description) or generate_goal_from_prompt (an LLM drafts it from a freeform prompt).
3. update_goal to refine, delete_goal to remove.

Tools

get_goals

Get the brand's business goals — strategic objectives informed by AI visibility scan data and the brand's own priorities.

Authentication: Required.

Returns goalCount plus a goals[] array; each goal has an id, a title (a concrete objective in plain language), and a description (why it matters and how content / AI visibility helps achieve it).

create_goal

Add a business goal you've already worded yourself. Synchronous — no LLM call, no credit cost. Call get_goals first to avoid duplicates.

Authentication: Required.

Returns the created goal with its new id. Edit or remove it later with update_goal / delete_goal.

generate_goal_from_prompt

Draft and save a business goal from a freeform description. An LLM turns your prompt into a structured title + description, grounded in the brand's company profile and voice, then persists it. The goal is created immediately — this is not a suggestion you confirm later; adjust it afterward with update_goal / delete_goal.

Authentication: Paid — requires a Starter or Pro plan (runs an LLM generation).

Returns the generated goal with its new id. To add a goal you've already worded yourself with no plan requirement, use create_goal.

update_goal

Edit an existing goal's title and/or description. Pass goalId plus whichever fields to change — at least one is required. Synchronous, no LLM call, no credit cost. Use get_goals to find the goalId.

Authentication: Required. The goal must belong to one of your agents.

Returns the updated goal.

delete_goal

Permanently remove a goal. Destructive and irreversible — anyone with access to the agent, including shared team members, can delete one. Synchronous, no LLM call. Use get_goals to find the goalId.

Authentication: Required.

Returns deletedGoalId on success.