Skip to content
Back to search

humblytics-marketing-skills

Hosted MCP server and 12 marketing skills for Claude and Codex. Give your agent live web analytics, A/B tests, funnels, heatmaps and paid-ads attribution resolved to Stripe revenue.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/humblytics--humblytics-marketing-skills/badge.svg)](/listings/humblytics--humblytics-marketing-skills)

HTML

<a href="/listings/humblytics--humblytics-marketing-skills"><img src="/api/listings/humblytics--humblytics-marketing-skills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

**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.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 213 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Humblytics MCP
  2. 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.
  3. **Endpoint:** `https://mcp.humblytics.com/v1`
  4. ## Prerequisites
  5. You need a [Humblytics](https://humblytics.com) account on the Plus plan or higher. Once signed up, grab your API key from **Dashboard → Utilities → API**.
  6. ## Connect in 30 seconds
  7. ### Claude Code
  8. ```bash
  9. claude mcp add humblytics --transport http https://mcp.humblytics.com/v1 \
  10. --header "Authorization: Bearer $HUMBLYTICS_API_KEY"
  11. ```
  12. ### Cursor
  13. Add to `.cursor/mcp.json`:
  14. ```json
  15. {
  16. "mcpServers": {
  17. "humblytics": {
  18. "url": "https://mcp.humblytics.com/v1",
  19. "headers": {
  20. "Authorization": "Bearer YOUR_API_KEY"
  21. }
  22. }
  23. }
  24. }
  25. ```
  26. ### VS Code (GitHub Copilot)
  27. Add to `.vscode/mcp.json`:
  28. ```json
  29. {
  30. "servers": {
  31. "humblytics": {
  32. "type": "http",
  33. "url": "https://mcp.humblytics.com/v1",
  34. "headers": {
  35. "Authorization": "Bearer YOUR_API_KEY"
  36. }
  37. }
  38. }
  39. }
  40. ```
  41. ### Any MCP client (generic)
  42. ```
  43. Transport: Streamable HTTP
  44. URL: https://mcp.humblytics.com/v1
  45. Auth header: Authorization: Bearer <your-api-key>
  46. ```
  47. ## What your agent can do
  48. Once connected, your agent has 37 tools covering everything in the Humblytics API:
  49. ### Analytics
  50. Fetch traffic summaries, trends, realtime visitors, page breakdowns, click maps, form analytics, entry/exit pages, and multi-property aggregations.
  51. ### Funnels
  52. Query any funnel, get Sankey visualisations, fetch AI-generated funnel suggestions, and manage saved funnels.
  53. ### A/B testing
  54. Get experiment recommendations, create and manage split tests, retrieve results.
  55. > `create_split_test` activates immediately — your agent will present recommendations before creating anything.
  56. ### Ads attribution
  57. Pull full-funnel revenue attribution connecting Meta/Google ad spend to Stripe conversions.
  58. ### Ads connections (read-only)
  59. 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.
  60. ### Properties
  61. `list_properties` discovers every site your API key can access — useful when you manage multiple properties.
  62. ## Authentication
  63. 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.
  64. 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.
  65. ## Skill prompts
  66. The server also exposes 12 marketing skill prompts. Five connect to your live Humblytics data automatically; the rest are standalone strategy and copy skills.
  67. | Prompt | Live data |
  68. |---|---|
  69. | `cro-optimizer` | ✅ |
  70. | `ab-test-generator` | ✅ |
  71. | `heatmap-analyst` | ✅ |
  72. | `revenue-attributor` | ✅ |
  73. | `funnel-reporter` | ✅ |
  74. | `page-cro` | — |
  75. | `email-sequences` | — |
  76. | `seo-strategist` | — |
  77. | `marketing-strategist` | — |
  78. | `copywriting` | — |
  79. | `ad-expert` | — |
  80. | `content-strategist` | — |
  81. Skill prompts appear in your MCP client's prompt picker. The `_shared` CRO benchmark library and reasoning frameworks are also exposed as MCP resources.
  82. ## Example prompts
  83. ```
  84. What pages are losing the most visitors this week?
  85. ```
  86. ```
  87. Suggest an A/B test for my pricing page based on current scroll and click data.
  88. ```
  89. ```
  90. Which Meta campaigns have the best revenue attribution this month?
  91. ```
  92. ```
  93. Run the funnel-reporter skill for my /signup flow.
  94. ```
  95. ## Skills (standalone, no MCP required)
  96. The `skills/` directory contains the same 12 skills as plain markdown files following the [Agent Skills](https://agentskills.io) spec. They work with Claude Code, Cursor, Windsurf, Cline, and any assistant that supports the spec — without needing the MCP server.
  97. ### Live-data skills (connect to the Humblytics MCP)
  98. | Skill | Description |
  99. |-------|-------------|
  100. | [cro-optimizer](skills/cro-optimizer/SKILL.md) | Conversion rate optimization using live Humblytics analytics data |
  101. | [ab-test-generator](skills/ab-test-generator/SKILL.md) | Generate and launch A/B tests from analytics and heatmap data |
  102. | [heatmap-analyst](skills/heatmap-analyst/SKILL.md) | Click, scroll, and rage-click heatmap analysis with UX friction recommendations |
  103. | [revenue-attributor](skills/revenue-attributor/SKILL.md) | Connect Meta/Google ad spend to Stripe revenue — ROAS rankings and reallocation |
  104. | [funnel-reporter](skills/funnel-reporter/SKILL.md) | End-to-end SaaS funnel reporting from Humblytics data |
  105. ### Marketing & content skills
  106. | Skill | Description |
  107. |-------|-------------|
  108. | [page-cro](skills/page-cro/SKILL.md) | Page-level conversion audits and optimization recommendations |
  109. | [email-sequences](skills/email-sequences/SKILL.md) | Multi-email drip campaigns — onboarding, nurture, re-engagement, abandoned cart |
  110. | [seo-strategist](skills/seo-strategist/SKILL.md) | Keyword research, content gaps, on-page and technical SEO audits |
  111. | [marketing-strategist](skills/marketing-strategist/SKILL.md) | Full-stack marketing: funnels, GTM, positioning, growth strategy |
  112. | [copywriting](skills/copywriting/SKILL.md) | Conversion copywriting for landing pages, emails, and ads |
  113. | [ad-expert](skills/ad-expert/SKILL.md) | Paid advertising across Meta, Google, TikTok, LinkedIn, YouTube |
  114. | [content-strategist](skills/content-strategist/SKILL.md) | Multi-format content strategy: articles, newsletters, social, video, SEO |
  115. ### Installing the standalone skills
  116. **Claude Code** — clone the repo, or reference the skills directly from your project's `AGENTS.md`:
  117. ```bash
  118. git clone https://github.com/Humblytics/humblytics-marketing-skills.git
  119. ```
  120. **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.
  121. ### Connecting the live-data skills
  122. The five live-data skills call the `humblytics` MCP tools directly — register the server as described in [Connect in 30 seconds](#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.
  123. 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.
  124. > **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`.
  125. 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.
  126. > 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.
  127. ## Meta Ads and Google Ads — three paths
  128. ### Path A — Humblytics connectors (preferred, read-only)
  129. 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.
  130. ### Path B — Meta CLI (read + write)
  131. 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.
  132. ### Path C — Don't roll your own
  133. **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.
  134. ## Security
  135. 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.
  136. ## Resources
  137. - [Sign up for Humblytics](https://humblytics.com)
  138. - [Humblytics Dashboard](https://app.humblytics.com)
  139. - [API Documentation](https://docs.humblytics.com/api)
  140. - [Agent Skills Spec](https://agentskills.io)
  141. ## Source availability
  142. 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.
  143. ## License
  144. MIT License — see [LICENSE](LICENSE) for details.
  145. Copyright 2026 Humblytics, Inc.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.