Saved analyses tools

search_funnels: List the saved funnel analyses in a project, or fetch one by ID.
search_trends: List the saved trend analyses in a project, or fetch one by ID.
search_reports: List the saved report analyses in a project, or fetch one by ID.

search_funnels

Searches the saved funnel analyses in a project, or fetches one by ID. Funnels measure step-by-step customer conversion through event sequences. Omit funnel_id to list all funnels — the response gives you the name, tags, archived flag, and initiative assignment. Pass funnel_id to fetch the full definition of a single funnel analysis: the steps (event filters), the date range, the conversion window, and any breakdown attributes.

Request parameters

Name	Type	Required?	Description
`project_id`	`str`	Yes	The project ID returned by `list_projects`.
`funnel_id`	`str`	No	The funnel ID. Omit to list all funnels; provide to fetch one.

Response parameters

The tool returns a FunnelsResponse when funnel_id is omitted, or a FunnelResponse when it's provided.

When funnel_id is omitted, the FunnelsResponse object has the following parameters:

Parameter	Type	Description
`success`	`bool`	Whether the request succeeded.
`data`	`list[FunnelSummary]`	The funnel summaries.
`error`	`str \| null`	Error message if the request failed.

The FunnelSummary object has the following fields:

Field	Type	Description
`id`	`str`	The funnel's unique ID.
`name`	`str`	The funnel's display name.
`archived`	`bool`	Whether the funnel has been archived.
`tags`	`list[str]`	User-defined tags.
`initiative_id`	`str \| null`	The initiative this funnel belongs to, if any.
`created`	`any \| null`	Unix timestamp of when the funnel was created.
`created_by_display_name`	`str \| null`	Display name of the creator.
`edited`	`any \| null`	Unix timestamp of the last edit.
`edited_by_display_name`	`str \| null`	Display name of the last editor.

When funnel_id is provided, the FunnelResponse object has the following parameters:

Parameter	Type	Description
`success`	`bool`	Whether the request succeeded.
`data`	`Funnel \| null`	The full funnel definition.
`error`	`str \| null`	Error message if the request failed.

The Funnel object adds the following field on top of the summary record:

Field	Type	Description
`definition`	`any \| null`	The funnel analysis definition: steps (event filters), date range, conversion window, and breakdown attributes.

search_trends

Searches the saved trend analyses in a project, or fetches one by ID. Trend analyses show how a metric changes over time, for example daily event count or weekly revenue. Omit trend_id to list all trends — the response gives you the name, tags, archived flag, and initiative assignment. Pass trend_id to fetch the full definition of a single trend analysis: the metrics, event filters, date range, and time granularity.

Request parameters

Name	Type	Required?	Description
`project_id`	`str`	Yes	The project ID returned by `list_projects`.
`trend_id`	`str`	No	The trend ID. Omit to list all trends; provide to fetch one.

Response parameters

The tool returns a TrendsResponse when trend_id is omitted, or a TrendResponse when it's provided.

When trend_id is omitted, the TrendsResponse object has the following parameters:

Parameter	Type	Description
`success`	`bool`	Whether the request succeeded.
`data`	`list[TrendSummary]`	The trend analysis summaries.
`error`	`str \| null`	Error message if the request failed.

The TrendSummary object has the following fields:

Field	Type	Description
`id`	`str`	The trend's unique ID.
`name`	`str`	The trend's display name.
`archived`	`bool`	Whether the trend has been archived.
`tags`	`list[str]`	User-defined tags.
`initiative_id`	`str \| null`	The initiative this trend belongs to, if any.
`created`	`any \| null`	Unix timestamp of when the trend was created.
`created_by_display_name`	`str`	Display name of the creator.
`edited`	`any \| null`	Unix timestamp of the last edit.
`edited_by_display_name`	`str`	Display name of the last editor.

When trend_id is provided, the TrendResponse object has the following parameters:

Parameter	Type	Description
`success`	`bool`	Whether the request succeeded.
`data`	`Trend \| null`	The full trend analysis definition.
`error`	`str \| null`	Error message if the request failed.

The Trend object adds the following field on top of the summary record:

Field	Type	Description
`definition`	`any \| null`	The trend analysis definition: metrics, event filters, date range, and granularity.

search_reports

Searches the saved report analyses in a project, or fetches one by ID. Reports are multi-metric analytics views that combine event data across dimensions. Omit report_id to list all reports — the response gives you the name, tags, archived flag, and initiative assignment. Pass report_id to fetch the full definition of a single report analysis: the metrics, dimensions, filters, and date range. To execute a report and get computed results, use calculate_report.

Request parameters

Name	Type	Required?	Description
`project_id`	`str`	Yes	The project ID returned by `list_projects`.
`report_id`	`str`	No	The report ID. Omit to list all reports; provide to fetch one.

Response parameters

The tool returns a ReportsResponse when report_id is omitted, or a ReportResponse when it's provided.

When report_id is omitted, the ReportsResponse object has the following parameters:

Parameter	Type	Description
`success`	`bool`	Whether the request succeeded.
`data`	`list[ReportSummary]`	The report summaries.
`error`	`str \| null`	Error message if the request failed.

The ReportSummary object has the following fields:

Field	Type	Description
`id`	`str`	The report's unique ID.
`name`	`str`	The report's display name.
`archived`	`bool`	Whether the report has been archived.
`tags`	`list[str]`	User-defined tags.
`initiative_id`	`str \| null`	The initiative this report belongs to, if any.
`created`	`any \| null`	Unix timestamp of when the report was created.
`created_by_display_name`	`str`	Display name of the creator.
`edited`	`any \| null`	Unix timestamp of the last edit.
`edited_by_display_name`	`str`	Display name of the last editor.

When report_id is provided, the ReportResponse object has the following parameters:

Parameter	Type	Description
`success`	`bool`	Whether the request succeeded.
`data`	`Report \| null`	The full report definition.
`error`	`str \| null`	Error message if the request failed.

The Report object adds the following field on top of the summary record:

Field	Type	Description
`definition`	`any \| null`	The report definition: metrics, dimensions, filters, and date range.