Humblytics MCP

Give Claude, Cursor and other AI agents access to your live website analytics and experiments — so they can find conversion problems, recommend tests, implement tracking and evaluate results.

Endpoint: https://mcp.humblytics.com/v1

Prerequisites

You need a Humblytics account on the Plus plan or higher. Once signed up, grab your API key from Dashboard → Utilities → API.

Connect in 30 seconds

Claude Code

claude mcp add humblytics --transport http https://mcp.humblytics.com/v1 \
  --header "Authorization: Bearer $HUMBLYTICS_API_KEY"

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "humblytics": {
      "url": "https://mcp.humblytics.com/v1",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

VS Code (GitHub Copilot)

Add to .vscode/mcp.json:

{
  "servers": {
    "humblytics": {
      "type": "http",
      "url": "https://mcp.humblytics.com/v1",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Any MCP client (generic)

Transport:     Streamable HTTP
URL:           https://mcp.humblytics.com/v1
Auth header:   Authorization: Bearer <your-api-key>

What your agent can do

Once connected, your agent has 37 tools covering everything in the Humblytics API:

Analytics

Fetch traffic summaries, trends, realtime visitors, page breakdowns, click maps, form analytics, entry/exit pages, and multi-property aggregations.

Funnels

Query any funnel, get Sankey visualisations, fetch AI-generated funnel suggestions, and manage saved funnels.

A/B testing

Get experiment recommendations, create and manage split tests, retrieve results.

create_split_test activates immediately — your agent will present recommendations before creating anything.

Ads attribution

Pull full-funnel revenue attribution connecting Meta/Google ad spend to Stripe conversions.

Ads connections (read-only)

Access Google Ads and Meta campaign metadata, daily insights, ad creative, and campaign performance — through Humblytics' managed connectors. No Meta App Review or Google developer token required.

Properties

list_properties discovers every site your API key can access — useful when you manage multiple properties.

Authentication

Your API key is account-level: one key covers every property you have access to. Pass it as Authorization: Bearer <key> on each request. The server stores nothing.

If your key covers multiple properties, call list_properties first to get the propertyId for the site you want to work with, then pass it explicitly on subsequent tool calls.

Skill prompts

The server also exposes 12 marketing skill prompts. Five connect to your live Humblytics data automatically; the rest are standalone strategy and copy skills.

Prompt	Live data
cro-optimizer	✅
ab-test-generator	✅
heatmap-analyst	✅
revenue-attributor	✅
funnel-reporter	✅
page-cro	—
email-sequences	—
seo-strategist	—
marketing-strategist	—
copywriting	—
ad-expert	—
content-strategist	—

Skill prompts appear in your MCP client's prompt picker. The _shared CRO benchmark library and reasoning frameworks are also exposed as MCP resources.

Example prompts

What pages are losing the most visitors this week?

Suggest an A/B test for my pricing page based on current scroll and click data.

Which Meta campaigns have the best revenue attribution this month?

Run the funnel-reporter skill for my /signup flow.

Skills (standalone, no MCP required)

The skills/ directory contains the same 12 skills as plain markdown files following the Agent Skills spec. They work with Claude Code, Cursor, Windsurf, Cline, and any assistant that supports the spec — without needing the MCP server.

Live-data skills (connect to the Humblytics MCP)

Skill	Description
cro-optimizer	Conversion rate optimization using live Humblytics analytics data
ab-test-generator	Generate and launch A/B tests from analytics and heatmap data
heatmap-analyst	Click, scroll, and rage-click heatmap analysis with UX friction recommendations
revenue-attributor	Connect Meta/Google ad spend to Stripe revenue — ROAS rankings and reallocation
funnel-reporter	End-to-end SaaS funnel reporting from Humblytics data

Marketing & content skills

Skill	Description
page-cro	Page-level conversion audits and optimization recommendations
email-sequences	Multi-email drip campaigns — onboarding, nurture, re-engagement, abandoned cart
seo-strategist	Keyword research, content gaps, on-page and technical SEO audits
marketing-strategist	Full-stack marketing: funnels, GTM, positioning, growth strategy
copywriting	Conversion copywriting for landing pages, emails, and ads
ad-expert	Paid advertising across Meta, Google, TikTok, LinkedIn, YouTube
content-strategist	Multi-format content strategy: articles, newsletters, social, video, SEO

Installing the standalone skills

Claude Code — clone the repo, or reference the skills directly from your project's AGENTS.md:

git clone https://github.com/Humblytics/humblytics-marketing-skills.git

Cursor / Windsurf / other assistants — copy the relevant SKILL.md files into your project's .cursor/skills/ (or equivalent) directory, or point your assistant at this repository.

Connecting the live-data skills

The five live-data skills call the humblytics MCP tools directly — register the server as described in Connect in 30 seconds and they work as-is. There is no API key to paste into a URL and no base URL to manage; the MCP handles auth, routing, and property resolution.

If you manage several properties, you can pin one for the whole connection by adding an optional X-Humblytics-Property-Id: $HUMBLYTICS_PROPERTY_ID header alongside the Authorization header, instead of passing propertyId per tool call. Copy .env.example to a gitignored .env and source it before registering the server.

Your API key is a secret. Keep it out of CLAUDE.md, .cursorrules, AGENTS.md, chat messages, and anything committed to git. Store it in an environment variable and reference it as $HUMBLYTICS_API_KEY.

To verify, ask your agent to list the humblytics server's tools and call get_traffic_realtime with no arguments. If tools don't appear, confirm $HUMBLYTICS_API_KEY is set in the environment the client launched from, then reload the client.

The context-only skills (page-cro, email-sequences, seo-strategist, marketing-strategist, copywriting, ad-expert, content-strategist) work without any connection. ad-expert will additionally pull live spend and attribution through the humblytics MCP when it's connected, but doesn't require it.

Meta Ads and Google Ads — three paths

Path A — Humblytics connectors (preferred, read-only)

Connect Meta Ads and Google Ads once at Connectors in the Humblytics dashboard. Skills then read campaign metadata, daily insights, ad creative, and full-funnel revenue attribution through Humblytics' managed connections — using the same HUMBLYTICS_API_KEY you already set up. No Meta App Review, no Google Ads developer token. revenue-attributor and ad-expert use this path by default. Read-only — connectors don't let agents pause campaigns or change budgets.

Path B — Meta CLI (read + write)

When the agent needs to manage campaigns (pause laggards, shift budget), use Meta's official meta ads CLI (released April 29, 2026). It's a published, supported tool that creates resources in PAUSED status by default. Scope the access token to a single ad account, store it in .env (never CLAUDE.md), and review every campaign before flipping it active. Skills hand off to the CLI for write actions; they don't call it directly.

Path C — Don't roll your own

Do not give the agent direct Meta Marketing API access through a system user on an unapproved developer app. Routing production API traffic through a draft or unpublished Meta App — regardless of how the access token was issued — is how ad accounts, including long-standing ones with seven-figure spend, are getting permanently banned. Meta is actively enforcing against unapproved-app API traffic. Use Path A or Path B above. The only safe DIY route is a Meta Developer App with the Marketing API product and full App Review completed for the permissions you need (e.g. ads_read) — budget weeks for review.

Security

API keys are passed at request time and never stored by the server. Never commit keys to version control or paste them into agent chat.

Resources

• Sign up for Humblytics
• Humblytics Dashboard
• API Documentation
• Agent Skills Spec

Source availability

The Humblytics MCP is a hosted commercial service. This repository contains public integration documentation, skill prompts, and configuration examples. The production server implementation is proprietary and is not distributed through this repository.

License

MIT License — see LICENSE for details.

Copyright 2026 Humblytics, Inc.