Humblytics MCP server

Form submissions grouped by page and form target, plus trend and totals.

Form submissions for a specific page with per-form share and totals.

Aggregate a metric across multiple properties in one request. The API key must be valid for every listed property. 'realtime' ignores date params.

Run a funnel across a step sequence. Returns per-step sessions and conversion_rate (relative to previous step) plus overall_conversion_rate.

Path-flow (Sankey) view of a funnel showing how sessions move between steps, including (drop-off) nodes.

AI-generated funnel suggestions for a page, based on real traffic patterns. Each includes steps and a rationale. No date range needed.

List all saved funnel configurations for the property (property-scoped, shared across keys).

Create a saved funnel, or update an existing one by including its id.

Delete a saved funnel configuration by id. Does not affect historical query results.

AI-generated A/B test recommendations for a page, from real analytics. Each entry's element_selector -> selector, change_type -> op, variant_value -> value feed create_split_test. Prefer confidence_score > 70.

Create and ACTIVATE an A/B test. The test goes live immediately and visitors are assigned right away — present recommendations to the user for review before calling this. type 'nocode' uses variants[].changes; type 'redirect' uses variants[].url. A Control variant is auto-created.

List experiments for the property, optionally filtered by status.

Full experiment details including per-variant sessions, conversions, and conversion_rate (decimal).

Update an active experiment. Only included fields change (name and/or auto_stop_days).

Stop a running experiment (cannot be restarted). Optionally record a reason.

Per-campaign full-funnel report for the property's connected Meta/Google ad accounts, joined to Humblytics sessions and Stripe/Foxy trials and revenue. Platform-reported (the ad platform's own attribution window, may include view-through): spend, impressions, clicks, ad_conversions (Meta purchases / Google primary conversions) and ad_conversion_events — every conversion event the platform reports, e.g. Meta complete_registration, lead, purchase, custom conversions; Google conversion actions. Humblytics-verified: sessions (utm_campaign match to the campaign name or tracking-template utm_campaign), trial_count (counted on Stripe trial start), revenue / revenue_conversions (counted on payment date; a trial's revenue appears only once it becomes paid), roas, true_cpa, cost_per_trial. Null vs zero: trial/revenue fields are null when their source is unavailable, and 0 only when it is connected and synced. Always read data_availability: ad_platforms.{meta,google}.status (ok/partial/error — a…

List Google Ads connections for a property. customerAccounts[].id is the customerId used by list_google_ads_campaigns. Empty connections means nothing is connected.

Get a single Google Ads connection by id.

List campaigns for a Google Ads customer account. status is ENABLED/PAUSED/REMOVED. For revenue-attached performance use get_ads_attribution.

List Meta Ads connections for a property. adAccounts[].id (includes act_ prefix) is the accountId for account-scoped endpoints.

Get a single Meta connection by id.

Lightweight health check for a Meta connection (connected/expired/error). Useful before expensive insight queries.

Campaigns grouped by ad account across the whole connection ('show me everything' view, no metrics).

Campaigns for one ad account, including performance metrics when since/until are supplied.

Day-by-day campaign performance for a Meta ad account. Primary endpoint for spend reconciliation. since/until required.

Ads inside a Meta campaign — creative metadata, destination URLs, ad-level performance. Good for 'which ads spend without revenue?'.

Full creative metadata for a single Meta ad — image/video URLs, copy, landing URL, status.