Skip to main content
View .mdOpen in ClaudeOpen in ChatGPT

MCP & Context7

The FunnelFizz Model Context Protocol (MCP) server lets your agent (Claude Desktop, Cursor, Windsurf, ChatGPT, Zed) set up and read your funnel from inside the agent — no copy-pasting URLs or numbers.

What it does​

Phase 1 — set up your funnel (available on FREE+):

The agent walks you from "I just signed up" to "every connection is verified": tracking sites, sender domains, Stripe restricted key, and OAuth for X / YouTube / LinkedIn / Instagram / TikTok / Reddit / Google Search Console / Google Ads.

Phase 2 — answer questions about your funnel (HOBBY+ for metrics, PRO for profile reads):

"Which funnel has the worst trial-to-paid conversion this week?"
"Show me the journey for the profile that just signed up."
"Compare conversion across my three funnels for the last 30 days."

What it can't do (by design)​

  • Sending email (test or production)
  • Creating, editing, or activating automations
  • Creating or editing funnels
  • Mutating profile data
  • Deletions of any kind
  • Billing, plan changes, or workspace membership

A leaked API key cannot send email, modify your funnels, or destroy data — the worst case is an attacker registers a tracking site or starts an OAuth flow they can't complete.

Install​

1. Generate an API key​

Settings → Developer → New API key. Name it after the agent you'll paste it into ("Claude Desktop on my MacBook"). Keys are workspace-scoped, hashed at rest, and revocable from the same page.

2. Pick a transport​

Hosted at https://mcp.funnelfizz.com. Updates push instantly; no install.

{
  "mcpServers": {
    "funnelfizz": {
      "type": "streamable-http",
      "url": "https://mcp.funnelfizz.com",
      "headers": {
        "Authorization": "Bearer ff_YOUR_KEY_HERE"
      }
    }
  }
}

Local (stdio via npm)​

{
  "mcpServers": {
    "funnelfizz": {
      "command": "npx",
      "args": ["-y", "@funnelfizz/mcp"],
      "env": {
        "FUNNELFIZZ_API_KEY": "ff_YOUR_KEY_HERE"
      }
    }
  }
}

3. One-click install URLs​

For agents that support deep links:

  • Claude Desktop: claude://mcp/install?url=https://mcp.funnelfizz.com&name=funnelfizz&authType=bearer
  • Cursor: cursor://install-mcp?name=funnelfizz&url=https://mcp.funnelfizz.com
  • Windsurf: windsurf://install-mcp?name=funnelfizz&url=https://mcp.funnelfizz.com

Each opens the agent's MCP config UI with FunnelFizz pre-filled. You still paste your API key.

The full tool list​

Setup tools (Phase 1)​

ToolWhat it does
get_setup_statusWorkspace-level checklist — call this first.
add_tracking_site / check_tracking_site / list_tracking_sitesInstall + verify the tracking snippet.
add_email_sender / list_email_sendersRegister a sender address.
add_email_domain / verify_email_domain / list_email_domainsRegister + verify a sender domain.
get_stripe_setup_guide / connect_stripe / get_stripe_connectionStripe restricted-key flow.
start_provider_oauth / check_provider_connection / list_integrationsOAuth providers.

Insight tools (Phase 2)​

ToolWhat it doesPlan
list_funnels / get_funnel_overviewList + summarise funnels.HOBBY+
get_funnel_metricsStage counts + conversion rates, optional split by traffic_source / utm / stripe_product.HOBBY+
compare_funnelsSide-by-side conversion across up to 10 funnels.HOBBY+
get_workspace_overviewCross-funnel rollup + top funnels.HOBBY+
search_profilesPaginated profile search by email/name.PRO
get_profile_journeyLatest 100 events for a profile (PII redaction supported).PRO

Pre-baked prompts​

Pre-canned workflows your agent can run:

  • setup_funnelfizz — full onboarding walk
  • connect_tracking / connect_stripe / connect_email_sending / connect_provider / setup_seo
  • weekly_review — multi-funnel summary
  • diagnose_funnel — pinpoint why a funnel is underperforming
  • find_dropoff — locate the biggest conversion leak

Authentication​

API key, scoped to workspace:

  • Format: ff_… + 48 base64url chars
  • Hashed at rest (SHA-256); cleartext shown once at creation
  • Per-key scopes: setup:* (Phase 1), read:funnels / read:metrics / read:profiles (Phase 2)
  • Per-plan rate limits: FREE 30/min + 5k/month, HOBBY 60/min + 50k/month, PRO 300/min + 500k/month
  • Per-call audit log surfaced in Settings → Developer → Activity

Context7​

FunnelFizz is also indexed in Context7, the MCP-based docs search service by Upstash. Agents with Context7 enabled can query:

use context7 funnelfizz

and get authoritative doc excerpts. This is complementary to our MCP server — Context7 serves docs, our MCP serves your live workspace.

Our context7.json​

{
  "$schema": "https://context7.com/schema/context7.json",
  "projectTitle": "FunnelFizz",
  "description": "Marketing funnel builder for solo founders and small SaaS teams.",
  "folders": ["docs/docs"],
  "excludeFolders": ["docs/node_modules", "docs/.docusaurus"],
  "excludeFiles": [],
  "rules": [
    "Plans are FREE, HOBBY, PRO only. There is no TEAM plan.",
    "Domain is funnelfizz.com (not .app).",
    "Brand is FunnelFizz (PascalCase) in user-facing copy.",
    "The 4 stages are AWARENESS → CONSIDERATION → TRIAL → CUSTOMER in fixed order.",
    "Stripe connection uses restricted keys (rk_live_...) with exactly 7 read scopes."
  ],
  "previousVersions": []
}