Copy as markdown[View .md](https://docs.funnelfizz.com/ai-agents/mcp-and-context7 "View the raw markdown for this page")[Open in Claude](https://claude.ai/new?q=Read%20https%3A%2F%2Fdocs.funnelfizz.com%2Fai-agents%2Fmcp-and-context7.md%20and%20help%20me%20with%20this%20FunnelFizz%20topic%3A%20MCP%20%26%20Context7 "Open this page in Claude with context")[Open in ChatGPT](https://chat.openai.com/?q=Read%20https%3A%2F%2Fdocs.funnelfizz.com%2Fai-agents%2Fmcp-and-context7.md%20and%20help%20me%20with%20this%20FunnelFizz%20topic%3A%20MCP%20%26%20Context7 "Open this page in ChatGPT with context") # 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[​](#what-it-does "Direct link to 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)[​](#what-it-cant-do-by-design "Direct link to 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[​](#install "Direct link to Install") ### 1. Generate an API key[​](#1-generate-an-api-key "Direct link to 1. Generate an API key") [Settings → Developer → New API key](https://funnelfizz.com/settings/developer). 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[​](#2-pick-a-transport "Direct link to 2. Pick a transport") #### Remote (recommended)[​](#remote-recommended "Direct link to Remote (recommended)") 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)[​](#local-stdio-via-npm "Direct link to 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[​](#3-one-click-install-urls "Direct link to 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[​](#the-full-tool-list "Direct link to The full tool list") ### Setup tools (Phase 1)[​](#setup-tools-phase-1 "Direct link to Setup tools (Phase 1)") | Tool | What it does | | -------------------------------------------------------------------------- | -------------------------------------------- | | `get_setup_status` | Workspace-level checklist — call this first. | | `add_tracking_site` / `check_tracking_site` / `list_tracking_sites` | Install + verify the tracking snippet. | | `add_email_sender` / `list_email_senders` | Register a sender address. | | `add_email_domain` / `verify_email_domain` / `list_email_domains` | Register + verify a sender domain. | | `get_stripe_setup_guide` / `connect_stripe` / `get_stripe_connection` | Stripe restricted-key flow. | | `start_provider_oauth` / `check_provider_connection` / `list_integrations` | OAuth providers. | ### Insight tools (Phase 2)[​](#insight-tools-phase-2 "Direct link to Insight tools (Phase 2)") | Tool | What it does | Plan | | -------------------------------------- | ------------------------------------------------------------------------------------------- | ------ | | `list_funnels` / `get_funnel_overview` | List + summarise funnels. | HOBBY+ | | `get_funnel_metrics` | Stage counts + conversion rates, optional split by traffic\_source / utm / stripe\_product. | HOBBY+ | | `compare_funnels` | Side-by-side conversion across up to 10 funnels. | HOBBY+ | | `get_workspace_overview` | Cross-funnel rollup + top funnels. | HOBBY+ | | `search_profiles` | Paginated profile search by email/name. | PRO | | `get_profile_journey` | Latest 100 events for a profile (PII redaction supported). | PRO | ## Pre-baked prompts[​](#pre-baked-prompts "Direct link to 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[​](#authentication "Direct link to 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[​](#context7 "Direct link to Context7") FunnelFizz is also indexed in [Context7](https://context7.com), 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[​](#our-context7json "Direct link to 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": [] } ``` ## Related[​](#related "Direct link to Related") * [MCP homepage](https://modelcontextprotocol.io) * [Context7 homepage](https://context7.com) * [AI agents → Overview](https://docs.funnelfizz.com/ai-agents/overview.md) * [Hand it to your agent](https://docs.funnelfizz.com/ai-agents/hand-it-to-your-agent.md) * [`llms.txt`](https://docs.funnelfizz.com/ai-agents/llms-txt.md)