Skip to main content

​
Overview

Connect Crawleo to Codeium’s Windsurf IDE to give Cascade AI real-time web search and crawling capabilities.

​
Prerequisites

  • Windsurf IDE installed (download)
  • Active Crawleo subscription with API key
MCP tools use the same credits as the REST API. search_web costs 10 credits per page, and crawl_web costs 1-10 credits per page based on proxy settings. View pricing

​
Configuration

1

Open Windsurf Settings

Open Windsurf and navigate to Settings → Cascade → MCP Servers.
2

Add Crawleo Server

Add a new MCP server with the following configuration:
{
  "crawleo": {
    "url": "https://api.crawleo.dev/mcp",
    "headers": {
      "Authorization": "Bearer YOUR_API_KEY"
    }
  }
}
Replace YOUR_API_KEY with your actual Crawleo API key.
3

Save and Restart

Save the configuration and restart Windsurf to apply the changes.

​
Manual Configuration

You can also edit the configuration file directly:
Edit ~/.windsurf/mcp.json:
{
  "mcpServers": {
    "crawleo": {
      "url": "https://api.crawleo.dev/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

​
Example Use Cases

Use Crawleo with Windsurf’s Cascade AI for: 
Search for comparisons between Next.js and Remix in 2025. 
What are the pros and cons of each?

Crawl the Prisma documentation and show me how to set up 
database migrations.

Search for "TypeError: Cannot read property of undefined" 
in React and find the common causes.

Search for Node.js security best practices and summarize 
the key recommendations.

​
Cascade AI Integration

Cascade can automatically use Crawleo tools when you:
  • Ask questions about current technologies or trends
  • Need to look up documentation
  • Want to research solutions to coding problems
  • Need real-time information not in training data
Be specific in your requests. Instead of “search for React”, try “search for React 19 new features and breaking changes”.

​
Troubleshooting

  1. Verify your API key is correct
  2. Ensure the URL is exactly https://api.crawleo.dev/mcp
  3. Restart Windsurf completely
  4. Check your internet connection
  • Start a new Cascade conversation
  • Verify MCP is enabled in Windsurf settings
  • Check the Cascade status indicator

Need Help?

Contact support if you’re still having issues.
Last modified on January 27, 2026