The agent-native analytics layer
Give your AI agent read access to your site analytics — Gentic Ingest, PostHog, and Northbeam — through one MCP endpoint. Analyze sessions, scroll depth, rage clicks, funnel drop-off, ad attribution, and saved insights. Drop into constrained SQL or raw HogQL when you need something custom.
How it works
From data source to agent query in five steps.
Sign up and get an API key
Create a free account at gentic.co, generate an API key from your dashboard, and use it as a Bearer token to authenticate your agent.
Connect your data sources
Drop the Gentic Ingest snippet on your site, paste your PostHog Personal API Key (read-only), and/or paste your Northbeam API key + Data Client ID. Connect one or all three — they share the same MCP endpoint.
Add the MCP server to your agent
Drop https://mcp.gentic.co/analytics into Claude Code, Claude Web, OpenClaw, ChatGPT, n8n, or any MCP-compatible client. Pass your Gentic API key as a Bearer token.
Ask about a page or campaign
Point the agent at an entry pathname — e.g. a landing page or an ad destination. It calls gentic_ingest_top_pages or posthog_analyze_sessions to compare recent vs previous period, scroll depth, rage clicks, and (with Northbeam connected) attribution back to spend.
Drop into SQL when you need more
For anything the built-in tools don't cover, the agent uses gentic_ingest_execute_query (constrained SQL over your event lakehouse) or posthog_execute_hogql_query (raw HogQL against events, sessions, persons).
Available tools
34 tools your AI agent can call through the Model Context Protocol.
gentic_ingest_avg_engagement_time
Returns per-URL engagement metrics — average wallclock dwell time (avg_ms), average active-engagement time (avg_active_ms, NULL for pre-#68 legacy events), and average max scroll depth (0–100) — over the given window.
gentic_ingest_bounce_rate
Returns the bounce rate for the site over the given window — total sessions (containing at least one pageview), bounces (sessions with exactly ONE pageview), and the bounce rate percentage.
gentic_ingest_checkout_dropoff
Returns checkout-stage drop-off rates over the given window — unique-subject counts at each of (add_to_cart → checkout_started → checkout_completed → purchase), plus the step-to-step conversion percentage computed against the previous stage.
gentic_ingest_click_counts
Returns aggregate click counts grouped by element tag + class_chain over the given window.
gentic_ingest_click_heatmap_grid
Returns a 100×100 viewport-normalized click heatmap grid for the given window — rows of (url, vx_pct, vy_pct, clicks) where coords are integer 0–100.
gentic_ingest_daily_visitors
Returns unique-visitor count per UTC day for the given window.
gentic_ingest_describe_events
Returns the discovered schema for this site's events: per-event-type total_events / first_seen / last_seen aggregates, plus per-property the JSON type, non-null count, and up to 3 distinct sample values.
gentic_ingest_execute_query
Run a constrained SELECT against the events table within the time window.
gentic_ingest_funnel_completion
Returns unique-subject counts at each step of the ecommerce funnel (pageview → product_viewed → add_to_cart → checkout_started → purchase) over the given window.
gentic_ingest_list_available_queries
Returns the catalog of all gentic_ingest_* analytics tools available on this MCP endpoint — each entry has tool_name, a one-line description, category, and the underlying gentic-ingest API endpoint (null for the meta-tool itself).
gentic_ingest_list_sites
Lists the gentic-ingest sites (domains) connected for the current organization, with site_id, created_at, and revoked status.
gentic_ingest_pageviews_by_device_class
Returns pageview count and unique-visitor count grouped by device_class (mobile, desktop, or 'unknown' for pre-tracker-v1 legacy data) over the given window.
gentic_ingest_sessions_by_day
Returns daily session counts + bounces + average duration over the window, one row per UTC day.
gentic_ingest_sessions_summary
Returns dashboard-headline session stats over the given window — total_sessions, avg_pages_per_session, avg_duration_seconds, median_duration_seconds.
gentic_ingest_timeseries_purchases
Returns purchase event counts and summed revenue per HOUR bucket over the given window (rows: { bucket, purchases, revenue }).
gentic_ingest_top_entry_pages
Returns the URLs where the most sessions BEGAN — top landing pages, ordered by session count, with per-page bounce count and bounce rate.
gentic_ingest_top_exit_pages
Returns the URLs where the most sessions ENDED — top exit pages, ordered by exit-session count.
gentic_ingest_top_form_submits
Returns the most-submitted forms over the given window, grouped by (url, form_id), with submit count and unique-visitor count.
gentic_ingest_top_outbound_destinations
Returns the most-clicked outbound destination hosts over the given window, with click count and unique-visitor count per destination.
gentic_ingest_top_pages
Returns the most-viewed URLs over the given window, with pageview count per URL.
gentic_ingest_top_rage_clicks
Returns elements receiving the most rage-click incidents (3+ rapid clicks within 1500ms on the same element) over the given window, grouped by (url, tag, element_id, class_chain), with incident count, total-click count, and unique-visitor count.
gentic_ingest_top_sources
Returns the top referring pages (document.referrer) driving traffic to the site over the given window, with pageview count and unique-visitor count per source URL.
gentic_ingest_web_vitals_summary
Returns Google Core Web Vitals per URL — LCP and CLS averages plus p75 — over the given window.
northbeam_create_export
Kick off a Northbeam Data Export job.
northbeam_get_export
Fetch the result of a Northbeam Data Export submitted via northbeam_create_export.
northbeam_list_attribution_models
List the attribution models available in your Northbeam account (e.g.
northbeam_list_breakdowns
List the breakdown dimensions available in your Northbeam account (e.g.
northbeam_list_metrics
List the metrics available in your Northbeam account (e.g.
northbeam_upsert_spend
Push ad spend records to Northbeam for non-integrated channels (influencer, podcast, newsletter, affiliate, etc.) — the API-equivalent of Northbeam's spreadsheet spend import.
posthog_analyze_button_clicks
Analyze button click breakdown for sessions that entered through a specific page.
posthog_analyze_sessions
Analyze session metrics for a specific entry page, comparing recent vs previous period.
posthog_execute_hogql_query
Execute a raw HogQL query against PostHog.
posthog_get_insights
List saved PostHog insights (dashboards, funnels, trends) for the connected project.
posthog_scroll_depth_analysis
Analyze scroll depth for sessions entering through a specific pathname.
Connect in seconds
Sign up, connect Gentic Ingest, PostHog, or Northbeam — one or all three — and add the MCP server to your agent. Works with Claude Code, Claude Web, OpenClaw, Claude Cowork, ChatGPT, n8n, and any MCP client.
claude mcp add gentic-analytics \
--transport http \
https://mcp.gentic.co/analytics \
--header "Authorization: Bearer YOUR_API_KEY"You can also connect via OAuth — just add gentic-analytics as a connector in Claude or ChatGPT settings. No API key needed; authentication is handled automatically.
Install the Gentic agent skill to teach your agent the optimal workflow so it gets the best results automatically.
npx skills add gentic-co/agent-skillsWorks with Claude Code, Cursor, Copilot, and 40+ other agents.
Transparent per-call pricing
PostHog analytics tools are priced per call. Pricing is visible at connect time and deducted from your Gentic credits.
| Tool | Cost |
|---|---|
| gentic_ingest_avg_engagement_time | 5¢ / call |
| gentic_ingest_bounce_rate | 5¢ / call |
| gentic_ingest_checkout_dropoff | 5¢ / call |
| gentic_ingest_click_counts | 5¢ / call |
| gentic_ingest_click_heatmap_grid | 5¢ / call |
| gentic_ingest_daily_visitors | 5¢ / call |
| gentic_ingest_describe_events | Free |
| gentic_ingest_execute_query | 25¢ / call |
| gentic_ingest_funnel_completion | 5¢ / call |
| gentic_ingest_list_available_queries | Free |
| gentic_ingest_list_sites | Free |
| gentic_ingest_pageviews_by_device_class | 5¢ / call |
| gentic_ingest_sessions_by_day | 5¢ / call |
| gentic_ingest_sessions_summary | 5¢ / call |
| gentic_ingest_timeseries_purchases | 5¢ / call |
| gentic_ingest_top_entry_pages | 5¢ / call |
| gentic_ingest_top_exit_pages | 5¢ / call |
| gentic_ingest_top_form_submits | 5¢ / call |
| gentic_ingest_top_outbound_destinations | 5¢ / call |
| gentic_ingest_top_pages | 5¢ / call |
| gentic_ingest_top_rage_clicks | 5¢ / call |
| gentic_ingest_top_sources | 5¢ / call |
| gentic_ingest_web_vitals_summary | 5¢ / call |
| northbeam_create_export | 50¢ / call |
| northbeam_get_export | Free |
| northbeam_list_attribution_models | Free |
| northbeam_list_breakdowns | Free |
| northbeam_list_metrics | Free |
| northbeam_upsert_spend | Free |
| posthog_analyze_button_clicks | 8¢ / call |
| posthog_analyze_sessions | 10¢ / call |
| posthog_execute_hogql_query | 10¢ / call |
| posthog_get_insights | Free |
| posthog_scroll_depth_analysis | 8¢ / call |
Pricing is pulled live from the Gentic MCP manifest so it always matches what you'll actually be charged. Connect to a PostHog project once and run as many queries as you need.
Why agent-native analytics?
Site analytics platforms are powerful. But your agent can't click through their dashboards — it needs typed tools, clean schemas, and SQL escape hatches when the pre-built tools fall short. That's what this is.
No dashboards to click
Your agent describes what it wants to know — 'why did this landing page convert worse last week?' — and calls the right tool across Gentic Ingest, PostHog, and Northbeam. No dashboard tours, no copy-paste from any UI.
Read-only by default
Gentic Ingest, PostHog, and Northbeam keys are all stored read-only. Your agent cannot mutate, ingest, or delete anything in your connected projects.
SQL escape hatches
When the pre-built tools don't cover what you need, the agent drops into gentic_ingest_execute_query (constrained SQL over your event lakehouse) or posthog_execute_hogql_query (raw HogQL) and writes the exact query it wants.
Composable with every MCP server
Chain analytics data with Gentic Data, Meta ads, Research, and Influencer tools — e.g. pull Gentic Ingest session metrics for an ad's landing page and compare against ad spend from Meta or Northbeam attribution.