Connect FunnelBrain

Your key is personal. It looks like fb_live_…, it is tied to your email, and everything you ask is logged to your account so we can improve the library. Do not share it or commit it to a repo. Reply to the invitation email if you need it reset.

Claude Code (recommended)

Open a terminal and run this once, replacing YOUR_KEY:

claude mcp add --transport http --scope user funnelbrain https://mcp.funnelbrain.app/mcp \
  --header "Authorization: Bearer YOUR_KEY"

Check it registered:
```
claude mcp list
```
You should see funnelbrain: https://mcp.funnelbrain.app/mcp (HTTP) - ✓ Connected.
Start a session with claude and ask a question in plain language. For example:
Use funnelbrain to show me how supplement brands answer "will this work for me?" before the offer. Show real pages.
Claude decides which library tools to call. Saying "use funnelbrain" in the first message helps it reach for the library instead of guessing.

To remove it later: claude mcp remove funnelbrain -s user. Claude Code runs on your own subscription or API key; the library itself is free during the beta.

Codex CLI

Put the key in your shell profile (~/.zshrc or ~/.bashrc), then open a new terminal:
```
export FUNNELBRAIN_API_KEY="YOUR_KEY"
```

Add this to ~/.codex/config.toml:

[mcp_servers.funnelbrain]
url = "https://mcp.funnelbrain.app/mcp"
bearer_token_env_var = "FUNNELBRAIN_API_KEY"

Run codex and ask: Using the funnelbrain tools, list every brand in the library with a subscription cancellation flow.

Cursor, Windsurf, Claude Agent SDK, and other MCP clients

Any client that supports remote MCP servers over Streamable HTTP with a custom header works. The generic config is:

{
  "mcpServers": {
    "funnelbrain": {
      "url": "https://mcp.funnelbrain.app/mcp",
      "headers": { "Authorization": "Bearer YOUR_KEY" }
    }
  }
}

Cursor: ~/.cursor/mcp.json (or .cursor/mcp.json in a project). Windsurf: ~/.codeium/windsurf/mcp_config.json. OpenClaw and similar agents: the same URL and header in their MCP settings.

Claude Desktop, claude.ai and ChatGPT connectors are not supported yet. They only accept OAuth logins, not an API key. That is next on the list; you will get an email when it lands. Claude Code works today.

Questions to try first

These are real questions members sent in. Each one is answered well by the library today, and the answers we built for them are at the links, so you can compare what you get with what we got.

Show me every brand running a subscription cancellation flow, and what they offer to keep me.

Across the supplement advertorials, which lead type (offer, promise, problem-solution, story, big secret, proclamation) do brands use at each awareness stage?

Which funnels follow up with people who reached checkout but didn't buy? What do they send, when, and does the offer change?

For the top quiz funnels by traffic, what is the order of question intents, and what share collect an email before the offer?

Find funnels where the customer gets a score or assessment. Where is it introduced and how does it hand off to the offer?

Walk the menopause supplement funnels from ad to first rebill. What does checkout pre-select?

Tips: name a vertical, a business model, or a problem ("low AOV", "high CPA", "churn"). Ask for screenshots and the library will return R2-hosted page images plus a link to the full breakdown on the Funnel of the Week site. Ask "what don't you have on this?" to get an honest list of gaps.

How answers are labelled

Every screenshot the library returns carries a provenance label, and good agents keep it in their answer:

Label	Meaning
SCRAPED	A real page captured from the brand's funnel. Authoritative. The reader can open the full page.
VIDEO	A frame from a Funnel of the Week breakdown video where the host screen-shared the funnel. A detail shot, not the live page.
ARTICLE COURSE EMAIL-PDF	From FOTW posts and course lessons, including captured post-purchase and abandon-cart email sequences.
CAI-APP	An automated iPhone walkthrough of a web2app quiz funnel from the Consumer App Index. Ordered screens, no question text.

Results link to the funnel's breakdown space on community.funneloftheweek.com and, for app funnels, the app page on consumerappindex.com. Both need your normal member login.

What the server exposes

Tool	What it does
`search_patterns`	Ranks the 87 documented funnel patterns for your vertical, business model, price point and problems.
`get_pattern`	One pattern in full, or a category index (order bumps, quiz funnels, subscription churn, and 13 more).
`get_exemplars`	The best real page examples for a pattern, with provenance.
`search_media`	Screenshot search across 17,000 indexed images: by brand, page type, pattern, tag or free text.
`search_pages`	Full-text search over the written analysis of 2,800 captured pages.
`get_funnel_overview`, `get_page_detail`, `view_screenshot`	Drill into one funnel, one page, one image.
`search_cai_funnels`, `get_cai_funnel`	The Consumer App Index corpus: 300 apps, quiz, paywall, upsell and cancellation screens, monthly traffic.
`list_skills`, `get_skill`	Structured analysis workflows (funnel triage, AOV booster, churn reducer, landing page audit, gap analysis).
`start_task`, `save_artifact`, `get_artifact`, `list_task_artifacts`, `get_task_summary`	Keep a report or analysis attached to a task so you can come back to it.

Troubleshooting

Symptom	Cause and fix
`401` or "unauthorized"	The key is missing or mistyped. Re-run the add command with the exact key. Keys never contain spaces.
Claude Code shows the server but never uses it	Say "use funnelbrain" in your prompt, or type `/mcp` in the session to confirm it is connected.
Slow first answer	The first call in a session loads the indexes; later calls are fast. A full analysis question can take a few minutes of agent work.
"Session not found"	Your client reconnected. Just ask again; a new session starts automatically.
Is it up?	mcp.funnelbrain.app/healthz should say `"ok":true`.

Feedback

Reply to the invitation email with what you asked, what you got, and what you expected. The most useful feedback is a question the library answered badly. Every question you ask is logged against your key, so "the thing I asked yesterday about listicles" is enough for us to find it.

Funnel of the Week · FunnelBrain beta · this page is unlisted; share it only with people who have a key.