--- title: "Humblytics MCP server" url: "https://martechdb.com/vendors/humblytics" markdown_url: "https://martechdb.com/vendors/humblytics.md" api_url: "https://martechdb.com/api/v1/vendors/humblytics.com" updated: "2026-10-05" --- # Humblytics MCP server Yes. Humblytics publishes an official MCP server at https://mcp.humblytics.com/v1. It's hosted. It offers 37 tools. We last checked it on 6 Oct 2026. MartechDB lists only servers the vendor publishes itself, never community servers. - Website: [humblytics.com](https://humblytics.com) - API access for agents: Included in plan, plan: Business, Scale and Enterprise plans (existing Plus accounts keep their current access), no free access. Limits: No numeric rate limit published; 429 rate\_limited on bursts. Max 500 buckets per request; breakdown limit max 50. ([source](https://docs.humblytics.com/api-access-and-agents), [limits source](https://docs.humblytics.com/external-analytics-api)) - Categories: [Web & product analytics](https://martechdb.com/categories/web-product-analytics.md) ## Humblytics MCP - Address: https://mcp.humblytics.com/v1 - Runs: Hosted - Sign-in: Sign-in: see vendor docs (`unknown`) - Cost to use: Included in plan, plan: Business, Scale and Enterprise plans (existing Plus accounts keep their current access), no free access. Limits: No numeric rate limit published; 429 rate\_limited on bursts. Max 500 buckets per request; breakdown limit max 50. ([source](https://docs.humblytics.com/api-access-and-agents), [limits source](https://docs.humblytics.com/external-analytics-api)) - Official MCP Registry: not listed - Documentation: https://docs.humblytics.com/api-access-and-agents - How we know it's official: The vendor's own documentation - First seen: 2026-10-05 - Last checked: 2026-10-06 ### Tools (37) As the server lists them on 2026-10-06. Names and descriptions come from the vendor's server. - `list_properties`: List every property this API key can access (propertyId, domain, name). Account-level keys see every property on the account; property-scoped keys see just their one. Call this first when the user refers to a site by name/domain rather than a propertyId, or when another tool's error says the key can access multiple properties — then pass the matching propertyId to that tool. If the key only sees one property, other tools resolve it automatically and propertyId can be omitted everywhere. - `get_traffic_summary`: Aggregate traffic for a range: page\_views, sessions, unique\_visitors, bounce\_rate (decimal), avg\_session\_duration (seconds). Bots excluded. - `get_traffic_trends`: Time-series page\_views and unique\_visitors, zero-filled per bucket. Max 500 buckets per request. - `get_traffic_realtime`: Live active\_visitors count and a recent visitor feed. No date parameters required. - `get_traffic_breakdown`: Top traffic segments (utm, countries, devices, landing\_pages, referrers) with session share. Missing values return 'unknown'. - `get_entry_exit_pages`: Top entry pages (where sessions begin) and exit pages (last page before leaving), with session share. - `get_pages_breakdown`: Per-page performance: page\_views, unique\_visitors, avg\_scroll\_depth (decimal), bounce\_rate. Sorted by page\_views desc. - `get_page_details`: Single-page deep dive: aggregate metrics plus UTM, device, and country breakdowns. - `get_clicks_breakdown`: Click events grouped by page and target, plus a time-series trend and totals. - `get_clicks_details`: Click targets for a specific page with per-target share. Closest analogue to a click heatmap. - `get_forms_breakdown`: Form submissions grouped by page and form target, plus trend and totals. - `get_forms_details`: Form submissions for a specific page with per-form share and totals. - `aggregate_traffic`: Aggregate a metric across multiple properties in one request. The API key must be valid for every listed property. 'realtime' ignores date params. - `query_funnel`: Run a funnel across a step sequence. Returns per-step sessions and conversion\_rate (relative to previous step) plus overall\_conversion\_rate. - `get_funnel_sankey`: Path-flow (Sankey) view of a funnel showing how sessions move between steps, including (drop-off) nodes. - `get_funnel_suggestions`: AI-generated funnel suggestions for a page, based on real traffic patterns. Each includes steps and a rationale. No date range needed. - `list_saved_funnels`: List all saved funnel configurations for the property (property-scoped, shared across keys). - `save_funnel`: Create a saved funnel, or update an existing one by including its id. - `delete_saved_funnel`: Delete a saved funnel configuration by id. Does not affect historical query results. - `get_split_test_recommendations`: 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_split_test`: 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_split_tests`: List experiments for the property, optionally filtered by status. - `get_split_test`: Full experiment details including per-variant sessions, conversions, and conversion\_rate (decimal). - `update_split_test`: Update an active experiment. Only included fields change (name and/or auto\_stop\_days). - `stop_split_test`: Stop a running experiment (cannot be restarted). Optionally record a reason. - `get_ads_attribution`: 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`: 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_google_ads_connection`: Get a single Google Ads connection by id. - `list_google_ads_campaigns`: List campaigns for a Google Ads customer account. status is ENABLED/PAUSED/REMOVED. For revenue-attached performance use get\_ads\_attribution. - `list_meta_connections`: List Meta Ads connections for a property. adAccounts\[\].id (includes act\_ prefix) is the accountId for account-scoped endpoints. - `get_meta_connection`: Get a single Meta connection by id. - `get_meta_connection_status`: Lightweight health check for a Meta connection (connected/expired/error). Useful before expensive insight queries. - `list_meta_campaigns`: Campaigns grouped by ad account across the whole connection ('show me everything' view, no metrics). - `list_meta_account_campaigns`: Campaigns for one ad account, including performance metrics when since/until are supplied. - `get_meta_daily_insights`: Day-by-day campaign performance for a Meta ad account. Primary endpoint for spend reconciliation. since/until required. - `list_meta_campaign_ads`: Ads inside a Meta campaign — creative metadata, destination URLs, ad-level performance. Good for 'which ads spend without revenue?'. - `get_meta_ad_creative`: Full creative metadata for a single Meta ad — image/video URLs, copy, landing URL, status. ### Connect it Claude Code: ```sh claude mcp add --transport http humblytics https://mcp.humblytics.com/v1 ``` - Add to Cursor: - Add to VS Code: - Claude.ai and Claude Desktop: Customize, Connectors, "+", Add custom connector, then paste https://mcp.humblytics.com/v1 - ChatGPT: Settings, Apps, Advanced settings, turn on Developer mode, Create, then paste https://mcp.humblytics.com/v1 (this usually works only with servers that use self-serve sign-in or none) JSON for Cursor, Windsurf and other clients that connect to hosted servers: ```json { "mcpServers": { "humblytics": { "type": "http", "url": "https://mcp.humblytics.com/v1" } } } ``` ## Questions ### Does Humblytics have an official MCP server? Yes. Humblytics publishes its MCP server itself. Humblytics's own documentation describes it. MartechDB only lists servers a vendor publishes, never community copies. ### What is the Humblytics MCP server URL? The address is https://mcp.humblytics.com/v1. ### How do I connect Humblytics MCP to Claude, ChatGPT or Cursor? In Claude, add https://mcp.humblytics.com/v1 as a custom connector (Customize, Connectors, Add custom connector). In Cursor, use the Add to Cursor link on MartechDB's page, or paste the JSON settings into your mcp.json. In Claude Code, run: claude mcp add --transport http humblytics https://mcp.humblytics.com/v1 ### What can the Humblytics MCP server do? It offers 37 tools, including list\_properties, get\_traffic\_summary, get\_traffic\_trends, get\_traffic\_realtime and get\_traffic\_breakdown (as listed on 6 Oct 2026). ### Is the Humblytics MCP server in the official MCP Registry? No. Humblytics hasn't published it to the official MCP Registry. ### Is the Humblytics MCP server free to use? No, it needs a paid plan. Plan needed: Business, Scale and Enterprise plans (existing Plus accounts keep their current access). It is included in the plan. Limits: No numeric rate limit published; 429 rate\_limited on bursts. Max 500 buckets per request; breakdown limit max 50. From Humblytics's own pages, checked on 6 Oct 2026. ### Is the Humblytics MCP server working? Yes. It answered our most recent check. We last checked it on 6 Oct 2026. ## Change history - 2026-10-05: Humblytics MCP added - 2026-10-05: Added to MartechDB ## Alternatives with an official MCP server In Web & product analytics: - [Amplitude](https://martechdb.com/vendors/amplitude.md) (amplitude.com) - [Mixpanel](https://martechdb.com/vendors/mixpanel.md) (mixpanel.com) - [Pendo](https://martechdb.com/vendors/pendo.md) (pendo.io) - [Conviva](https://martechdb.com/vendors/conviva.md) (conviva.com) ## Get this data - API: `curl https://martechdb.com/api/v1/vendors/humblytics.com` - MCP: `claude mcp add --transport http martechdb https://martechdb.com/mcp`, then ask about Humblytics. - Web page: https://martechdb.com/vendors/humblytics