> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kameleoon.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Goal tools

> MCP tools for creating goals and reading their performance.

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`.