Firecrawl MCP Server

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

$env FIRECRAWL_API_KEY=fc-YOUR_API_KEY npx -y firecrawl-mcp

Manual Installation

$npm install -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: env FIRECRAWL_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)

$env SSE_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

Name	Description
FIRECRAWL_API_KEY	Your Firecrawl API key

Optional (Self-hosted)

Name	Description
FIRECRAWL_API_URL	Custom Firecrawl API endpoint

Retry Configuration

Variable	Default	Description
FIRECRAWL_RETRY_MAX_ATTEMPTS	3	Number of retry attempts
FIRECRAWL_RETRY_INITIAL_DELAY	1000	Initial delay (ms)
FIRECRAWL_RETRY_MAX_DELAY	10000	Maximum delay (ms)
FIRECRAWL_RETRY_BACKOFF_FACTOR	2	Exponential backoff factor

Credit Monitoring

Variable	Default
FIRECRAWL_CREDIT_WARNING_THRESHOLD	1000
FIRECRAWL_CREDIT_CRITICAL_THRESHOLD	100

Example:

export FIRECRAWL_API_KEY=your-api-key

# Retry config
export FIRECRAWL_RETRY_MAX_ATTEMPTS=5
export FIRECRAWL_RETRY_INITIAL_DELAY=2000
export FIRECRAWL_RETRY_MAX_DELAY=30000
export FIRECRAWL_RETRY_BACKOFF_FACTOR=3

# Credit thresholds
export FIRECRAWL_CREDIT_WARNING_THRESHOLD=2000
export FIRECRAWL_CREDIT_CRITICAL_THRESHOLD=500

---

🧠 System Defaults

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

---

📦 Available Tools & Use Cases

Tool Name	Best for	Returns
scrape	Single page content	markdown/html
batch_scrape	Many known URLs	markdown/html[]
map	Discovering URLs	URL[]
crawl	Multi-page extraction	markdown/html[]
search	Web search	results[]
extract	Structured data	JSON
deep_research	In-depth research	summary, sources
generate_llmstxt	Create llms.txt for a site	text

---

🔧 Example Usage

{
  "name": "firecrawl_scrape",
  "arguments": {
    "url": "https://example.com",
    "formats": ["markdown"],
    "onlyMainContent": true,
    "waitFor": 1000,
    "timeout": 30000,
    "mobile": false,
    "includeTags": ["article", "main"],
    "excludeTags": ["nav", "footer"],
    "skipTlsVerification": false
  }
}

---

🔎 Choosing the Right Tool

• Know the exact URL?
  • Use scrape (single) or batch_scrape (multiple)
• Need to find URLs on a site? → map
• Want to search the web? → search
• Want structured data? → extract
• Need full-site coverage? → crawl
• Need multi-source research? → deep_research

---

🧪 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