Tool reference — Data & Site

Google Analytics 4 tools

Overview, channel and landing page reports, realtime data, conversion events and Google Ads links.

Tool names and descriptions are generated straight from the server code; the descriptions are the original English text the assistant sees.

Read tools10 tools

list_ga4_properties

Leitura1 credits

GA4 properties (id, name, account) the connected Google account can read, plus the default property used when property_id is omitted.

This tool takes no parameters.

ga4_report

Leitura1 credits

Custom GA4 report (runReport): any dimensions × metrics for a date range with filters, ordering and limit. Rows carry conversion_rate (keyEvents/sessions %) when both are present. 'conversions' are GA4 key events (metric keyEvents). Requires a connected Google account; otherwise connected=false.

Parameter	Type	Description
`property_id`Optional	string	GA4 property id (digits or properties/123). Omit to use the connected default; list_ga4_properties shows the options.
`start_date`Optional	string	YYYY-MM-DD
`end_date`Optional	string	YYYY-MM-DD
`days`Optional	integer (1–730)	window ending today when dates are omitted (default 30)
`metrics`Optional	array<string>	GA4 Data API metric names, default [sessions, totalUsers, keyEvents]
`dimensions`Optional	array<string>	GA4 dimension names, e.g. sessionDefaultChannelGroup, landingPage, date, country, deviceCategory, eventName
`filters`Optional	array<object>	AND-combined dimension filters, e.g. {dimension: sessionDefaultChannelGroup, value: 'Paid Search'}
`order_by`Optional	string	a metric or dimension in the request
`order`Optional	asc \| desc	—
`limit`Optional	integer (1–10000)	—
`offset`Optional	integer (0–…)	—

ga4_overview

Leitura1 credits

Overview totals for the period: sessions, users, new users, engaged sessions, key events (conversions), revenue, page views, with engagement and conversion rates; compare_previous adds the preceding equal period and change.

Parameter	Type	Description
`property_id`Optional	string	GA4 property id (digits or properties/123). Omit to use the connected default; list_ga4_properties shows the options.
`start_date`Optional	string	YYYY-MM-DD
`end_date`Optional	string	YYYY-MM-DD
`days`Optional	integer (1–730)	window ending today when dates are omitted (default 30)
`compare_previous`Optional	boolean	—

ga4_realtime

Leitura1 credits

Active users right now (last 30 minutes) and where they are — by page/screen title by default.

Parameter	Type	Description
`property_id`Optional	string	GA4 property id (digits or properties/123). Omit to use the connected default; list_ga4_properties shows the options.
`dimensions`Optional	array<string>	realtime dimensions: unifiedScreenName (default), country, city, deviceCategory, eventName, platform
`metrics`Optional	array<string>	realtime metrics: activeUsers (default), screenPageViews, eventCount, keyEvents
`limit`Optional	integer (1–1000)	—

ga4_landing_pages

Leitura1 credits

Landing pages with sessions, engaged sessions, key events (conversions), revenue and conversion rate, ordered by key events by default.

Parameter	Type	Description
`property_id`Optional	string	GA4 property id (digits or properties/123). Omit to use the connected default; list_ga4_properties shows the options.
`start_date`Optional	string	YYYY-MM-DD
`end_date`Optional	string	YYYY-MM-DD
`days`Optional	integer (1–730)	window ending today when dates are omitted (default 30)
`filters`Optional	array<object>	AND-combined dimension filters, e.g. {dimension: sessionDefaultChannelGroup, value: 'Paid Search'}
`with_query_string`Optional	boolean	—
`order_by`Optional	keyEvents \| sessions \| engagedSessions \| totalRevenue	—
`limit`Optional	integer (1–1000)	—

ga4_channel_report

Leitura1 credits

Sessions, engaged sessions, users, key events (conversions), revenue and rates by default channel group (or source/medium/campaign).

Parameter	Type	Description
`property_id`Optional	string	GA4 property id (digits or properties/123). Omit to use the connected default; list_ga4_properties shows the options.
`start_date`Optional	string	YYYY-MM-DD
`end_date`Optional	string	YYYY-MM-DD
`days`Optional	integer (1–730)	window ending today when dates are omitted (default 30)
`filters`Optional	array<object>	AND-combined dimension filters, e.g. {dimension: sessionDefaultChannelGroup, value: 'Paid Search'}
`dimension`Optional	string	sessionDefaultChannelGroup (default), sessionSource, sessionMedium, sessionCampaignName, sessionSourceMedium
`limit`Optional	integer (1–1000)	—

ga4_vs_google_ads

Leitura2 credits

GA4 'Paid Search' channel (sessions, key events, revenue) next to Google Ads spend, clicks, conversions and CPA for the same last-N-days window, with the attribution gap. If Google Ads is not connected the Ads side is null with a note.

Parameter	Type	Description
`property_id`Optional	string	GA4 property id (digits or properties/123). Omit to use the connected default; list_ga4_properties shows the options.
`days`Optional	integer (1–90)	—

list_ga4_google_ads_links

Leitura1 credits

Google Ads accounts linked to the GA4 property (customer id, personalization flag, creator, created time); linked=false flags a property with no link.

Parameter	Type	Description
`property_id`Optional	string	GA4 property id (digits or properties/123). Omit to use the connected default; list_ga4_properties shows the options.

list_ga4_conversion_events

Leitura1 credits

Conversion (key) events defined on the property with counting method and custom/deletable flags.

Parameter	Type	Description
`property_id`Optional	string	GA4 property id (digits or properties/123). Omit to use the connected default; list_ga4_properties shows the options.

list_ga4_custom_dimensions

Leitura1 credits

Custom dimensions on the property (parameter name, display name, scope).

Parameter	Type	Description
`property_id`Optional	string	GA4 property id (digits or properties/123). Omit to use the connected default; list_ga4_properties shows the options.

Write tools3 tools

create_ga4_conversion_event

Escrita2 credits

Mark a GA4 event as a conversion (key event). Creates an approval item with a preview; applied via the Admin API only after approval and only with a connected account that has edit access.

Parameter	Type	Description
`property_id`Optional	string	GA4 property id (digits or properties/123). Omit to use the connected default; list_ga4_properties shows the options.
`event_name`Required	string	—
`counting_method`Optional	ONCE_PER_EVENT \| ONCE_PER_SESSION	—

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

create_ga4_custom_dimension

Escrita2 credits

Create a custom dimension (event, user or item scope). Goes through preview and approval before the Admin API call.

Parameter	Type	Description
`property_id`Optional	string	GA4 property id (digits or properties/123). Omit to use the connected default; list_ga4_properties shows the options.
`parameter_name`Required	string	—
`display_name`Optional	string	—
`scope`Optional	EVENT \| USER \| ITEM	—
`description`Optional	string	—

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

create_ga4_google_ads_link

Escrita2 credits

Link a Google Ads account to the GA4 property so conversions flow to Google Ads. Goes through preview and approval; requires edit access on both sides.

Parameter	Type	Description
`property_id`Optional	string	GA4 property id (digits or properties/123). Omit to use the connected default; list_ga4_properties shows the options.
`customer_id`Required	string	Google Ads customer id, 123-456-7890
`ads_personalization`Optional	boolean	—

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.