Firecrawl MCP Server: Setup Guide, Use Cases & Limitations

What Is Firecrawl MCP Server?

Firecrawl MCP Server is an MCP integration built on top of the Firecrawl API that lets Claude extract clean markdown content from websites via web scraping and crawling. It is maintained by Mendable AI, the team behind the Firecrawl service.

Quick Facts

What You Can Do With It

• Web scraping: Fetch the content of any publicly accessible URL and receive it as clean, structured markdown rather than raw HTML.
• Content extraction: Pull article text, documentation, or product data from pages without writing custom parsers.
• Site crawling: Traverse multiple pages of a site to gather content across an entire domain or subdomain.
• Competitor analysis: Systematically retrieve and compare content from competitor websites to identify messaging or feature differences.

How to Set It Up

Prerequisites: You need a Firecrawl API key. Obtain one from firecrawl.dev.

Claude Code (CLI)

Run the following to add the server to your Claude Code environment:

claude mcp add firecrawl-mcp -e FIRECRAWL_API_KEY=your_api_key_here -- npx firecrawl-mcp
**Claude Desktop**

Add the following block to your `claude_desktop_config.json` (typically located at `~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):

```json
{
  "mcpServers": {
    "firecrawl-mcp": {
      "command": "npx",
      "args": ["firecrawl-mcp"],
      "env": {
        "FIRECRAWL_API_KEY": "your_api_key_here"
      }
    }
  }
}

Replace your_api_key_here with your actual Firecrawl API key. Restart Claude Desktop after saving the config.

Works Best With

Firecrawl MCP Server is documented as compatible with both Claude Code and Claude Desktop. Claude Code is the better choice for scripted or iterative workflows — for example, writing a script that crawls a list of URLs and pipes results into a file. Claude Desktop suits more conversational use cases where you want to scrape a page mid-conversation and immediately reference the content.

Known Limitations

• API key required: This server does not work without a valid Firecrawl API key. There is no unauthenticated or local-only fallback.
• Rate limits: Firecrawl enforces rate limits based on your subscription tier. Free-tier keys will hit limits quickly during site crawls. Check the Firecrawl pricing page for current tier details.
• Public pages only: Firecrawl can only scrape pages that are accessible without a login session. Content behind authentication walls, paywalls, or bot-detection systems may not be retrievable.
• Dynamic JavaScript rendering: Firecrawl handles JavaScript rendering for many sites, but heavily client-rendered applications or pages with aggressive anti-bot measures may return incomplete content.
• Cost awareness: Each scrape or crawl operation consumes API credits. Long crawls across large sites can exhaust credits unexpectedly — set scope limits when crawling.

Community Resources

• GitHub Issues: https://github.com/mendableai/firecrawl-mcp-server/issues — report bugs or check known problems before filing new issues.
• Firecrawl GitHub (main repo): https://github.com/mendableai/firecrawl — broader Firecrawl discussion including API behavior.
• r/ClaudeAI: Search for “Firecrawl MCP” on reddit.com/r/ClaudeAI for community setup threads and tips.