Pricing

Rating

Developer

Actor stats

Categories

Share

A Model Context Protocol (MCP) server implementation that integrates with Firecrawl for web scraping capabilities.

Big thanks to @vrknetha, @knacklabs for the initial implementation!

About this MCP Server: To understand how to connect to and utilize this MCP server, please refer to the official Model Context Protocol documentation at mcp.apify.com.

✨ Features

• Web scraping, crawling, and discovery
• Search and content extraction
• Deep research and batch scraping
• Automatic retries and rate limiting
• Cloud and self-hosted support
• SSE support

Play around with our MCP Server on MCP.so's playground or on Klavis AI.

🚀 Installation

Running with npx

$envFIRECRAWL_API_KEY=fc-YOUR_API_KEY npx -y firecrawl-mcp

Manual Installation

$npminstall-g firecrawl-mcp

🖥️ Running on Cursor

Requires Cursor version 0.45.6+

For the most up-to-date configuration instructions, see Cursor MCP Server Configuration Guide.

Cursor v0.48.6+

{
"mcpServers":{
"firecrawl-mcp":{
"command":"npx",
"args":["-y","firecrawl-mcp"],
"env":{
"FIRECRAWL_API_KEY":"YOUR-API-KEY"
}
}
}
}

Cursor v0.45.6

• Go to Settings > Features > MCP Servers
• Click Add New MCP Server

Name: firecrawl-mcp
Type: command
Command: envFIRECRAWL_API_KEY=your-api-key npx -y firecrawl-mcp

Note for Windows: Use cmd /c "set FIRECRAWL_API_KEY=your-api-key && npx -y firecrawl-mcp"

🌊 Running on Windsurf

Add this to your ./codeium/windsurf/model_config.json:

{
"mcpServers":{
"mcp-server-firecrawl":{
"command":"npx",
"args":["-y","firecrawl-mcp"],
"env":{
"FIRECRAWL_API_KEY":"YOUR_API_KEY"
}
}
}
}

🔁 Running with SSE (Local Mode)

$envSSE_LOCAL=true FIRECRAWL_API_KEY=fc-YOUR_API_KEY npx -y firecrawl-mcp

Access at: http://localhost:3000/sse

🛠️ Installing via Smithery (Legacy)

$npx -y @smithery/cli install @mendableai/mcp-server-firecrawl --client claude

💻 Running on VS Code

One-click install:

• Install with NPX in VS Code
• Install with NPX in VS Code Insiders

Manual Setup

User Settings (JSON):

{
"mcp":{
"inputs":[
{
"type":"promptString",
"id":"apiKey",
"description":"Firecrawl API Key",
"password":true
}
],
"servers":{
"firecrawl":{
"command":"npx",
"args":["-y","firecrawl-mcp"],
"env":{
"FIRECRAWL_API_KEY":"${input:apiKey}"
}
}
}
}
}

Workspace File: .vscode/mcp.json

{
"inputs":[
{
"type":"promptString",
"id":"apiKey",
"description":"Firecrawl API Key",
"password":true
}
],
"servers":{
"firecrawl":{
"command":"npx",
"args":["-y","firecrawl-mcp"],
"env":{
"FIRECRAWL_API_KEY":"${input:apiKey}"
}
}
}
}

⚙️ Configuration

Required

Optional (Self-hosted)

Retry Configuration

Credit Monitoring

Example:

exportFIRECRAWL_API_KEY=your-api-key
# Retry config
exportFIRECRAWL_RETRY_MAX_ATTEMPTS=5
exportFIRECRAWL_RETRY_INITIAL_DELAY=2000
exportFIRECRAWL_RETRY_MAX_DELAY=30000
exportFIRECRAWL_RETRY_BACKOFF_FACTOR=3
# Credit thresholds
exportFIRECRAWL_CREDIT_WARNING_THRESHOLD=2000
exportFIRECRAWL_CREDIT_CRITICAL_THRESHOLD=500

🧠 System Defaults

constCONFIG={
retry:{
maxAttempts:3,
initialDelay:1000,
maxDelay:10000,
backoffFactor:2,
},
credit:{
warningThreshold:1000,
criticalThreshold:100,
},
};

📦 Available Tools Overview

• firecrawl_scrape — Single page content extraction
• firecrawl_map — URL discovery on websites
• firecrawl_crawl — Multi-page extraction (returns job ID)
• firecrawl_check_crawl_status — Monitor crawl progress
• firecrawl_search — Web search with optional content scraping
• firecrawl_extract — Structured data extraction to JSON

🔧 Key Usage Examples

The examples show proper parameter usage for common scenarios like:

• Basic page scraping with content filtering
• Web search with scraped results
• Structured data extraction with custom schemas

🔎 Decision Tree

Great guidance on tool selection based on needs:

• Known URL → scrape
• Find URLs → map
• Search web → search
• Extract structured data → extract
• Full site coverage → crawl + status check

⚡ Performance Optimization

Valuable tips:

• Use maxAge for caching
• Use onlyMainContent for efficiency

🧪 Prompt Examples

• Scrape:
  “Get the content of https://example.com.”

• Search:
  “Find 2023 papers on AI.”

• Extract:
  “Extract product name, price, description from [urls].”

• Deep research:
  “Research environmental impact of EVs vs gas cars.”

📄 License

MIT © Firecrawl Team

🚩 Claim this MCP server. Contact info.

All credits to the original authors of: https://github.com/mendableai/firecrawl-mcp-server
Contact contact: ai@apify.com