All integrations/Windsurf45s setupeasy

Hooklayer for Windsurf

Windsurf supports MCP natively as of v1.4+. Add Hooklayer via Settings → MCP Servers → Add new. Paste the JSON config with your hl_live_ Bearer key. Cascade agent can now call analyze_account, score_hook, and the other 5 Hooklayer tools from any IDE conversation.

Get free API key Try the playground first

What works in Windsurf

All 7 Hooklayer tools
Cascade agent integration
Native HTTP MCP transport
Token-budget aware tool surface
recommended_chain auto-firing

Setup (45s)

Config file: ~/.codeium/windsurf/mcp_config.json

JSONCopy + paste

{
  "mcpServers": {
    "hooklayer": {
      "url": "https://hooklayer.dev/api/mcp",
      "transport": "http",
      "headers": {
        "Authorization": "Bearer hl_live_..."
      }
    }
  }
}

1
Get your API key
Sign up at hooklayer.dev/auth/signup for an hl_live_ key. Free tier: 100 lifetime credits.
2
Open Windsurf settings
Windsurf → Settings (Cmd+,) → MCP Servers → Add new MCP server.
3
Paste the JSON
Paste the config above. Replace hl_live_... with your real key. Save.
4
Open a Cascade chat
Cmd+L to open Cascade. Hooklayer's 7 tools should appear in the available-tools list when Cascade plans its actions.

Example prompts for Windsurf

Paste any of these to see Hooklayer respond live.

Plan a developer-marketing TikTok strategy in Cascade

I'm building a TypeScript autocomplete tool and want to do TikTok marketing. Use Hooklayer to analyze @theo.gg, @primagen, and @t3dotgg. Compare their replicability scores and tell me which dev creator's structure I should copy. Show me the steal_map for the winner.

Expected: Cascade fires 3 analyze_account calls in parallel (15 credits), picks the highest-replicability creator, and surfaces the steal_map. Developer-niche use case.

Score TikTok hook drafts you write in the IDE

Here's a TikTok hook draft I wrote: "POV: you just shipped a feature that breaks production at 3am." Use Hooklayer to score it — I want signals, would_fail_because, and 3 rewrites.

Expected: score_hook returns 0-100 score, 6 evidence-cited signals, counterfactual. Useful for dev creators writing scripts in the IDE.

Get the trending dev-tool TikTok formats

Call Hooklayer trend_pulse for "Tech & Coding". Show me decimal % growth, sources, and signal_window for each rising trend. I want to know what video format is winning for dev content this week.

Expected: Returns 3 rising + 2 saturated patterns with decimal % growth (no rounded numbers). Helps dev-tool creators pick the format their TikTok strategy should follow.

Frequently asked

What Windsurf version do I need?

Windsurf 1.4+ for native MCP support (released 2026-Q1). Earlier versions don't recognize MCP server configs. Update from the Codeium dashboard or your package manager.

Does Cascade decide when to call Hooklayer tools?

Yes. Cascade reads the MCP tool catalog at session start and picks the right tool when planning actions. You don't need to explicitly say "use analyze_account" — saying "analyze @humphreytalks" is enough; Cascade picks the tool itself.

Can I use Hooklayer with Windsurf's inline edit mode?

Cascade (chat mode) is the primary surface — that's where tool calls happen. Inline edits (Cmd+I) are scoped to code transformations; MCP tools aren't invoked in that context. For Hooklayer use, open a Cascade chat.

How does Windsurf's tool-budget interact with Hooklayer?

Windsurf budgets MCP tool definitions like Cursor does — each tool costs 500-1,000 tokens in the system prompt. Hooklayer's 7 tools total ~5K tokens, well within typical budgets. Run 3-5 MCP servers comfortably; 20+ will start to slow Cascade.

Does Hooklayer work with Windsurf's free tier?

Yes. MCP support is available across all Windsurf tiers (Free, Pro, Team, Enterprise). Hooklayer's free tier (100 lifetime credits) pairs with Windsurf's free tier for zero-cost initial exploration.

Can I share my Hooklayer config across team Windsurf installs?

Yes. mcp_config.json is a plain JSON file — check it into a dotfiles repo (with your Bearer key in an environment variable, not hardcoded) and sync across team installs. Standard config-sharing patterns apply.

Hooklayer also works with

Hooklayer for Claude Desktop

Hooklayer for OpenAI Agents SDK

60s setup

Hooklayer for LangChain

90s setup

Try it in Windsurf.

100 free credits at signup. No card. Windsurf setup in 45 seconds.

Get API key See all 7 tools