Analytics and ads — Voidhash Docs

MCP tools for metrics, charts, events, VoidQL, alerts, ad accounts and ad reports.

These tools let an agent answer questions about revenue, retention and events, manage alerts, and report on Meta ad accounts.

Analytics

Key access: Analytics; Events for events and which are stored. The VoidQL tools need no early access; see Query analytics with VoidQL for the language and its limits.

Tool	What it does
`list_insights`	The built-in business metrics `run_insight` reports.
`run_insight`	Runs metrics such as MRR or churn over a period, optionally against the one before.
`list_analytics_charts`	The charts Studio shows, by what they answer.
`run_analytics_chart`	Runs one chart over a period, such as retention by country.
`acquisition_report`	Who each network, campaign, ad set, ad or surface brought in, and what they paid.
`acquisition_cohorts_report`	How quickly acquisition cohorts pay, by day since their touch.
`get_tracking_health`	Whether Voidhash sees your web and apps, from the last 7 days.
`list_events`	Stored events, newest first, by name or person.
`get_ingest_policy`	Which built-in events are stored and which custom events are blocked.
`set_event_ingest`	Starts or stops storing an event. Asks first when stopping.
`voidql_schema`	The VoidQL relations, columns and rules.
`voidql_explain`	Checks a VoidQL query without running it.
`voidql_query`	Runs a read-only VoidQL query; 100 rows by default, at most 1,000.

Alerts

Key access: Analytics. See Alerts.

Tool	What it does
`list_analytics_alerts`	Alerts and how each stood at its latest hourly check.
`create_analytics_alert`	Adds an alert that notifies owners and admins.
`update_analytics_alert`	Changes an alert, or turns it on or off.
`delete_analytics_alert`	Deletes an alert. Asks first.

create_analytics_alert takes name, kind (event_count, failure_share or volume_drop), eventName, successEventName for failure_share, windowHours (1, 6, 24 or 168), threshold and, for event_count, minPeople. threshold is a count of at least 1 for event_count, and a share between 0 and 1 for the other kinds, such as 0.2 for 20%. See the CLI alert flags.

Key access: Ads. Connect an ad account in Studio or with the CLI.

Tool	What it does
`list_ad_accounts`	Connected ad accounts, their sync health and web-to-app prefixes.
`disconnect_ad_account`	Disconnects an account and deletes its synced data. Asks first.
`set_web_to_app_prefixes`	Sets which landing pages mark website ads as web-to-app.
`list_ad_campaigns`	Synced campaigns with their delivery, objective, destination and budget.
`get_ad_campaign`	One campaign's ad groups and ads, and missing tracking parameters.
`ads_performance_report`	Spend and platform results beside the people and revenue Voidhash measured.
`ads_creatives_report`	Creatives by spend, with fatigue signs.
`view_ad_creative`	Shows one creative's image, carousel card or video poster.
`ads_cohorts_report`	Payback by acquisition cohort.
`find_ads_issues`	What needs attention in the ad accounts, most severe first.
`ads_changes_report`	What changed in the ads over a period, up to 7 days.

Meta measurement

Key access: Ads. See Share purchases with Meta.

Tool	What it does
`get_meta_measurement`	Whether purchases reach Meta's Conversions API, and why not.
`set_meta_conversions`	Turns sending on or off, or sets the dataset or test event code. Asks first when turning it on.

Example

How did trials convert last month compared with the month before?

The agent calls list_insights to find the metric, then run_insight with the previous period to compare.

Next steps

Metric definitions: how each metric is computed.
Alerts: alert kinds and thresholds.
Ad measurement: connect Meta and read ad reports.