Windsurf Integration

Sign in from the terminal: the CLI opens a browser page where you approve a new key, then saves it to ~/.crawlforge/config.json.

npm install -g crawlforge-mcp-server
crawlforge login        # opens the browser approval page

Or copy a key from the dashboard and paste it into the config in the next step.

AOption A: Edit mcp_config.json

Open ~/.codeium/windsurf/mcp_config.json (%USERPROFILE%\.codeium\windsurf\mcp_config.json on Windows) and add the server:

{
  "mcpServers": {
    "crawlforge": {
      "command": "npx",
      "args": [
        "-y",
        "crawlforge-mcp-server@latest",
        "mcp"
      ],
      "env": {
        "CRAWLFORGE_API_KEY": "cf_live_your_api_key_here"
      }
    }
  }
}

Save the file, then press Refresh in the MCPs panel so Cascade picks up the change.

BOption B: Cascade panel

Click the MCPs icon in the Cascade toolbar and choose Configure to open the same file in the editor; paste the entry there and save.

Limit the tool list (optional)

CrawlForge ships 31 tools. Set CRAWLFORGE_TOOL_GROUPS in the same env block to load only the groups you need, for example basic,search:

"env": {
  "CRAWLFORGE_API_KEY": "cf_live_your_api_key_here",
  "CRAWLFORGE_TOOL_GROUPS": "basic,search"
}

Groups: basic, search, crawl, extract, batch, research, tracking, llmstxt, stealth, templates, scrape, agent.

• Open Cascade — press Cmd+L / Ctrl+L
• Check the server — the MCPs panel lists crawlforge with its tools once it starts
• Test a prompt — try one of the examples below; Cascade picks the CrawlForge tool itself

Example Prompts