How to Use the Firecrawl MCP in Windsurf

Q: Can Windsurf use Firecrawl to find new information?

Yes, the searchweb tool lets your agent query the internet and pull back structured results. It combines search and extraction into one step.

Q: Does Firecrawl handle site-wide crawling in Windsurf?

Absolutely. You can point the crawlsite tool at a domain, and it will process the pages recursively. The server returns a job ID to keep track of the progress.

Turn any website into LLM-ready data directly within Windsurf to fuel Cascade's autonomous planning.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Firecrawl MCP to Windsurf

Create your Vinkius account to connect Firecrawl to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Firecrawl with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Full site data extraction

Cascade uses `crawl_site` to pull entire domains into your context window. It handles the heavy lifting so you don't have to navigate through endless pages manually. This MCP Server provides the raw content in clean Markdown. Your agent gets the full picture of a site's structure without getting stuck on dynamic elements or anti-bot hurdles.

Targeted page scraping

Use `scrape_page` when you need specific details from a single URL. It strips away the noise, leaving only the text that matters for your current task. Windsurf reads this clean output instantly. It's the fastest way to get documentation or product specs into your workspace without leaving the IDE.

Site architecture mapping

Run `map_site` to see what a website looks like before you start pulling content. It generates a sitemap so Cascade can plan its next moves effectively. This prevents wasted requests on irrelevant pages. You get a clear view of the site layout, helping your agent focus on the high-signal areas.

Setup guide

Set up Firecrawl MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Firecrawl MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Firecrawl payment history." If connected, Cascade will call the Firecrawl tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "firecrawl-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Firecrawl. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Firecrawl now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Firecrawl MCP in Windsurf

It acts as a bridge between your browser-based data and Windsurf's internal context. You trigger the tools through the MCP panel, and the server returns clean Markdown directly to Cascade.

Yes, the `search_web` tool lets your agent query the internet and pull back structured results. It combines search and extraction into one step.

Absolutely. You can point the `crawl_site` tool at a domain, and it will process the pages recursively. The server returns a job ID to keep track of the progress.

Your data remains isolated within your session. The server only processes the specific URLs you request and converts them into text for your agent.

The server includes built-in anti-bot protection. It navigates around common hurdles like cookie banners and dynamic overlays automatically.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python