Goal tools

Goal tools manage the conversion goals that experiments and feature flags measure. Your assistant can create and edit goals, check how a goal performs over a period, and find the experiments that moved it.

Check goal performance

Two read-only tools answer these questions about a goal:

How’s a goal doing? goal_performance_get returns the goal’s KPIs for a period, the change against the previous period, and daily events with unusual days flagged.
Which tests moved a goal? goal_experiment_impacts_list lists the variations whose effect reached the site’s reliability threshold, strongest first.

Tools

Tool	Description	Example prompt
`goal_list`	Browse goals on a site, with usage counts across experiments, flags, and personalizations.	”List goals for site `d1alzzxd7k`.”
`goal_get`	Inspect a goal’s type configuration, tags, and usage counts.	”Show goal `271552`.”
`goal_search`	Find a goal by a substring of its name.	”Search goals for `checkout`.”
`goal_create`	Create a goal of any type (URL, CLICK, SCROLL, PAGE_VIEWS, TIME_SPENT, CUSTOM, and more).	”Create a URL goal that matches `/thank-you`.”
`goal_update`	Edit a goal’s name, description, tags, tracking tools, or multiple-conversions setting.	”Rename goal `271552` to `Signup complete`.”
`goal_update_type`	Switch a goal’s type and replace its type-specific configuration, keeping existing tags.	”Change goal `271552` to a CLICK goal.”
`goal_delete`	Permanently delete a goal.	”Delete goal `271552`.”
`goal_performance_get`	Get a goal’s events, conversion rate, and revenue for a period, the change against the previous period, and daily events with the expected range and flagged anomalies.	”Did the Purchase goal drop last week? Which days were unusual?”
`goal_experiment_impacts_list`	List the experiment variations whose effect on a goal reached the site’s reliability threshold, positive and negative, strongest first.	”Which experiments moved the Purchase goal the most, good and bad?”

The MCP server can’t set or read the JavaScript code of a custom goal, because the Automation API doesn’t expose it. When you create a custom goal with goal_create and include code, the assistant adds the code to the experiment’s global script instead.

Parameters

Use the exact parameter names that tools/list returns.

Tool	Required parameters	Optional parameters
`goal_list`	None	`siteCode`, `page`, `perPage`
`goal_get`	`goalId`	None
`goal_search`	`query`	`siteCode`, `page`, `perPage`
`goal_create`	`payload` (`name`, `siteCode`, `type`, `hasMultipleConversions`)	`payload`: type-specific params (`matchString`, `matchType`, `scrollType`, `scrollValue`, `timeSeconds`, `pageViews`, `url`), `tags`, `description`, `status`, `trackingTools`
`goal_update`	`goalId`	`name`, `description`, `tags`, `trackingTools`, `hasMultipleConversions`
`goal_update_type`	`goalId`, `type`	type-specific params
`goal_delete`	`goalId`	None
`goal_performance_get`	`siteCode`, `goalId`	`period` (`7D`, `14D`, `30D`, `3M`, or `6M`; default `30D`), `dateFrom` and `dateTo` (`YYYY-MM-DD`, at most 366 days)
`goal_experiment_impacts_list`	`siteCode`, `goalId`	`impact` (`POSITIVE`, `NEGATIVE`, or `BOTH`), `limit` (1 to 50, default 10), `cursor`

Accepted enum values: Goal type is CLICK, CUSTOM, SCROLL, PAGE_VIEWS, URL, TIME_SPENT, RETENTION_RATE, WAREHOUSE, or RATIO_METRICS.

Home

Set up

Tool reference

Tutorials

Troubleshooting

Check goal performance

Tools

Parameters

Home

Set up

Tool reference

Tutorials

Troubleshooting

​Check goal performance

​Tools

​Parameters

Check goal performance

Tools

Parameters