firecrawl/firecrawl-mcp-server
๐ฅ Official Firecrawl MCP Server - Adds powerful web scraping and search to Cursor, Claude and any other LLM clients.
7,148 โ
839 forksJavaScriptUpdated 22h ago
What you need to know
Official Firecrawl MCP server that brings Firecrawl's web scraping/search platform to MCP clients: search, scrape, crawl, extract, and interact with live web pages for clean agent-ready context. Available hosted (keyless free tier), via npx, and self-hosted.
Install
Hosted: https://mcp.firecrawl.dev/v2/mcp (keyless free tier; OAuth at /v2/mcp-oauth, API key via Authorization: Bearer header) npx: env FIRECRAWL_API_KEY=fc-YOUR_API_KEY npx -y firecrawl-mcp npm install -g firecrawl-mcp Streamable HTTP local mode: env HTTP_STREAMABLE_SERVER=true FIRECRAWL_API_KEY=... npx -y firecrawl-mcp (URL http://localhost:3000/mcp)
Usage
- โขConfigure the server in Cursor (v0.45.6+), Windsurf, VS Code, or Claude Desktop with FIRECRAWL_API_KEY set
- โขChoose the right tool: scrape for a known URL, map to discover URLs, search for open-ended queries, crawl for multi-page extraction, agent for multi-source research, interact for browser automation
- โขPrefer JSON format in firecrawl_scrape with a schema (avoids context-window overflow); use markdown only when full content is needed
- โขCall firecrawl_search_feedback after using search results to refund 1 credit and improve search quality
Key features
- โTools: firecrawl_scrape, firecrawl_map, firecrawl_search, firecrawl_crawl, firecrawl_parse, firecrawl_extract, firecrawl_agent (async, polled), firecrawl_interact (browser automation), firecrawl_monitor_* (recurring page monitors), firecrawl_research_* (papers/GitHub), firecrawl_developer_search (GitHub issues/PRs/READMEs/docs index)
- โDeveloper search index built for coding agents: GitHub issues, merged PRs, READMEs, curated docs
- โKeyless free tier lets scrape/search/interact work without an API key (rate-limited); crawl, map, agent, extract still need a key
- โAutomatic retries and rate limiting; self-hosted support via FIRECRAWL_API_URL; SSE and Streamable HTTP transports
- โSearch feedback tools refund credits and improve search quality
Best for
Giving coding agents a reliable web-scraping/search layer with clean structured output, including a developer-focused index for programming questions.
Caveats
- โ Keyless free tier is rate-limited; full tool set and higher limits require a Firecrawl API key or OAuth login
- โ firecrawl_crawl responses can be very large and exceed token limits - limit depth and page count
- โ Hosted firecrawl_parse cannot read the caller's filesystem directly (two-step upload-ref flow); local file parsing requires a self-hosted FIRECRAWL_API_URL
- โ Never put an API key in the server URL; use headers or env vars
Clients: Cursor ยท Windsurf ยท VS Code ยท Claude Desktop
Documentation โReviewed 2026-08-07
Topics
batch-processingclaudecontent-extractiondata-collectionfirecrawlfirecrawl-aijavascript-renderingllm-toolsmcpmcp-servermodel-context-protocolsearch-apiweb-crawlerweb-scraping
- Stars
- 7,148โ
- Forks
- 839
- Language
- JavaScript
- License
- MIT
- Created
- 2024-12-06
- Last push
- 2026-08-06