{"repo":"firecrawl/firecrawl-mcp-server","free":true,"listed":false,"github":"https://github.com/firecrawl/firecrawl-mcp-server","clone":"git clone https://github.com/firecrawl/firecrawl-mcp-server.git","description":"🔥 Official Firecrawl MCP Server - Adds powerful web scraping and search to Cursor, Claude and any other LLM clients.","language":"JavaScript","stars":7249,"topics":["batch-processing","claude","content-extraction","data-collection","firecrawl","firecrawl-ai","javascript-rendering","llm-tools","mcp","mcp-server","model-context-protocol","search-api","web-crawler","web-scraping"],"license":"MIT","category":"ai_infrastructure","readme_excerpt":"\n\n# Firecrawl MCP Server\n\nA Model Context Protocol (MCP) server that brings [Firecrawl](https://github.com/firecrawl/firecrawl) to MCP-compatible AI agents — search, scrape, and interact with the live web for clean, agent-ready context.\n\n> Big thanks to [@vrknetha](https://github.com/vrknetha), [@knacklabs](https://www.knacklabs.ai) for the initial implementation!\n\n## Features\n\n- Search the web and get full page content\n- Search an index built for coding agents: GitHub issues, merged pull requests, READMEs, and docs\n- Scrape any URL into clean, structured data\n- Interact with pages — click, navigate, and operate\n- Deep research with autonomous agent\n- Automatic retries and rate limiting\n- Cloud and self-hosted support\n- SSE support\n\n> Play around with [our MCP Server on MCP.so's playground](https://mcp.so/playground?server=firecrawl-mcp-server) or on [Klavis AI](https://www.klavis.ai/mcp-servers).\n\n## Installation\n\n### Hosted MCP (keyless free tier)\n\nConnect to the remote hosted server with no setup:\n\n```\nhttps://mcp.firecrawl.dev/v2/mcp\n```\n\nOn the keyless free tier, `scrape`, `search`, and `parse` work without an API key (rate-limited). Other tools such as `crawl`, `map`, and `agent` still need a key.\n\nPrefer OAuth or an API key whenever the human can sign up. It unlocks the full tool set and higher limits.\n\nFor an interactive account connection, configure your MCP client to use this server URL. This is an MCP endpoint, **not a browser page**; use the client's account-connection flow and do not add a second Firecrawl server entry when reconnecting:\n\n```\nhttps://mcp.firecrawl.dev/v2/mcp-oauth\n```\n\nFor an API-key connection (for example, an unattended integration), keep the server URL as:\n\n```\nhttps://mcp.firecrawl.dev/v2/mcp\n```\n\nThen configure the client's secure header or secret setting with:\n\n```\nAuthorization: Bearer \n```\n\nNever put an API key in the server URL. Never put an API key in an agent chat. Configure it directly in the client or secret manager. See the [hosted MCP setup guide](https://docs.firecrawl.dev/mcp-server) and the [agent onboarding guide](https://www.firecrawl.dev/agent-onboarding/SKILL.md) for client-specific instructions.\n\n#### Search-only endpoint\n\nA read-only, search-only surface is also hosted at:\n\n```\nhttps://mcp.firecrawl.dev/v2/mcp-search\n```\n\nIt exposes a fixed set of six read-only tools: `firecrawl_search` and the five `firecrawl_research_*` tools. It performs no page-content fetching and has its own OAuth identity; the full endpoint above is unchanged. See [docs/search-profile.md](docs/search-profile.md) for the full contract.\n\n### Running with npx\n\n```bash\nenv FIRECRAWL_API_KEY=fc-YOUR_API_KEY npx -y firecrawl-mcp\n```\n\n### Manual Installation\n\n```bash\nnpm install -g firecrawl-mcp\n```\n\n### Running on Cursor\n\nConfiguring Cursor 🖥️\nNote: Requires Cursor version 0.45.6+\nFor the most up-to-date configuration instructions, please refer to the official Cursor documentation on configuring MCP servers:\n[Cursor MCP Server Configuration Guide](https://docs.cursor.com/context/model-context-protocol#configuring-mcp-servers)\n\nTo configure Firecrawl MCP in Cursor **v0.48.6**\n\n1. Open Cursor Settings\n2. Go to Features > MCP Servers\n3. Click \"+ Add new global MCP server\"\n4. Enter the following code:\n ```json\n {\n \"mcpServers\": {\n \"firecrawl-mcp\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"firecrawl-mcp\"],\n \"env\": {\n \"FIRECRAWL_API_KEY\": \"YOUR-API-KEY\"\n }\n }\n }\n }\n ```\n\nTo configure Firecrawl MCP in Cursor **v0.45.6**\n\n1. Open Cursor Settings\n2. Go to Features > MCP Servers\n3. Click \"+ Add New MCP Server\"\n4. Enter the following:\n - Name: \"firecrawl-mcp\" (or your preferred name)\n - Type: \"command\"\n - Command: `env FIRECRAWL_API_KEY=your-api-key npx -y firecrawl-mcp`\n\n> If you are using Windows and are running into issues, try `cmd /c \"set FIRECRAWL_API_KEY=your-api-key && npx -y firecrawl-mcp\"`\n\nReplace `your-api-key` with your Firecrawl API key. If you don't have one yet, you can create an account and get it from https://www.firecrawl.dev/app/api-keys\n\nAfter adding, refresh the MCP server list to see the new tools. The Composer Agent will automatically use Firecrawl MCP when appropriate, but you can explicitly request it by describing your web scraping needs. Access the Composer via Command+L (Mac), select \"Agent\" next to the submit button, and enter your query.\n\n### Running on Windsurf\n\nAdd this to your `./codeium/windsurf/model_config.json`:\n\n```json\n{\n \"mcpServers\": {\n \"mcp-server-firecrawl\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"firecrawl-mcp\"],\n \"env\": {\n \"FIRECRAWL_API_KEY\": \"YOUR_API_KEY\"\n }\n }\n }\n}\n```\n\n### Running with Streamable HTTP Local Mode\n\nTo run the server using Streamable HTTP locally instead of the default stdio transport:\n\n```bash\nenv HTTP_STREAMABLE_SERVER=true FIRECRAWL_API_KEY=fc-YOUR_API_KEY npx -y firecrawl-mcp\n```\n\nUse the url: http://localhost:3000/mcp\n\n### Installing via Smithery (Legacy)\n\nTo install Firecrawl for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@mendableai/mcp-server-firecrawl):\n\n```bash\nnpx -y @smithery/cli install @mendableai/mcp-server-firecrawl --client claude\n```\n\n### Running on VS Code\n\nFor one-click installation, click one of the install buttons below...\n\n[](https://insiders.vscode.dev/redirect/mcp/install?name=firecrawl&inputs=%5B%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22apiKey%22%2C%22description%22%3A%22Firecrawl%20API%20Key%22%2C%22password%22%3Atrue%7D%5D&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22firecrawl-mcp%22%5D%2C%22env%22%3A%7B%22FIRECRAWL_API_KEY%22%3A%22%24%7Binput%3AapiKey%7D%22%7D%7D) [](https://insiders.vscode.dev/redirect/mcp/install?name=firecrawl&inputs=%5B%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22apiKey%22%2C%22description%22%3A%22Firecrawl%20API%20Key%22%2C%22password%22%3Atrue%7D%5D&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22firecrawl-mcp%22%5D%2C%22env%22%3A%7B%22FIRECRAWL_API_KEY%22%3A%22%24%7Binput%3AapiKey%7D%22%7D%7D&quality=insiders)\n\nFor manual installation, add the following JSON block to your User Settings (JSON) file in VS Code. You can do this by pressing `Ctrl + Shift + P` and typing `Preferences: Open User Settings (JSON)`.\n\n```json\n{\n \"mcp\": {\n \"inputs\": [\n {\n \"type\": \"promptString\",\n \"id\": \"apiKey\",\n \"description\": \"Firecrawl API Key\",\n \"password\": true\n }\n ],\n \"servers\": {\n \"firecrawl\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"firecrawl-mcp\"],\n \"env\": {\n \"FIRECRAWL_API_KEY\": \"${input:apiKey}\"\n }\n }\n }\n }\n}\n```\n\nOptionally, you can add it to a file called `.vscode/mcp.json` in your workspace. This will allow you to share the configuration with others:\n\n```json\n{\n \"inputs\": [\n {\n \"type\": \"promptString\",\n \"id\": \"apiKey\",\n \"description\": \"Firecrawl API Key\",\n \"password\": true\n }\n ],\n \"servers\": {\n \"firecrawl\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"firecrawl-mcp\"],\n \"env\": {\n \"FIRECRAWL_API_KEY\": \"${input:apiKey}\"\n }\n }\n }\n}\n```\n\n## Configuration\n\n### Environment Variables\n\n#### Required for Cloud API\n\n- `FIRECRAWL_API_KEY`: Your Firecrawl API key\n - Required when using cloud API (default)\n - Optional when using self-hosted instance with `FIRECRAWL_API_URL`\n- `FIRECRAWL_API_URL` (Optional): Custom API endpoint for self-hosted instances\n - Example: `https://firecrawl.your-domain.com`\n - If not provided, the cloud API will be used (requires API key)\n\n#### MCP OAuth (Bearer access tokens)\n\nHosted Firecrawl can issue OAuth **access tokens** (`fco_…`) via the authorization server on [firecrawl.dev](https://firecrawl.dev). This MCP server forwards whichever credential it resolves to the Firecrawl API as `Authorization: Bearer …`.\n\n- **HTTP stream transports** (`CLOUD_SERVICE=true`, `HTTP_STREAMABLE_SERVER=true`, or `SSE_LOCAL=true`): Clients should send `Authorization: Bearer ` on MCP requests. An OAuth bearer token takes precedence over `x-firecrawl-api-key` / `x-api-key` when both are present.\n- **stdio:** Use `FIRECRAWL_OAUTH_TOKEN` for a static access token, or keep using `FIRECRAWL_API_KEY` for an API key.\n\nUse **access** tokens (`fco_…`) only. Refresh tokens (`fcr_…`) must be exchanged at the token endpoint, not passed to the scrape/search API.\n\n#### Search-only surface (hosted)\n\nIn hosted mode (`CLOUD_SERVICE=true`) a second in-process instance serves the [search-only endpoint](#search-only-endpoint). The bundled service has a fixed deployment contract: nginx routes `/v2/mcp-search` to the instance on local port `3001`, and the OAuth protected-resource identifier is `https://mcp.firecrawl.dev/v2/mcp-search`.\n\n`FIRECRAWL_MCP_SEARCH_ENABLED` (default `true`) is the supported operational toggle; set it to `false` to prevent the search instance from starting. The Node process also accepts `FIRECRAWL_MCP_SEARCH_PORT`, `FIRECRAWL_MCP_SEARCH_ENDPOINT`, and `FIRECRAWL_MCP_SEARCH_RESOURCE_URL` for isolated tests. Those overrides do not reconfigure the bundled nginx routes or the authorization server allowlist and must not be used independently in the hosted deployment.\n\nThe search instance requires authentication for every request (including `tools/list`) and rejects OAuth tokens whose audience does not match its own resource.\n\n### Configuration Examples\n\nFor cloud API us","default_branch":"main","files":44,"tree":[".dockerignore",".eslintrc.json",".github/workflows/ci.yml",".github/workflows/image-staging.yml",".github/workflows/image.yml",".github/workflows/publish.yml",".gitignore",".prettierrc","CHANGELOG.md","Dockerfile","Dockerfile.service","LICENSE","README.md","VERSIONING.md","docker/entrypoint.sh","docker/nginx.conf","docs/search-profile.md","glama.json","img/fire.png","img/firecrawl-logo.png","img/firecrawl-wordmark.png","package.json","patches/fastmcp@4.3.2.patch","pnpm-lock.yaml","pnpm-workspace.yaml","scripts/agent-metadata-policy.mjs","server.json","smithery.yaml","src/developer.ts","src/index.ts","src/keyless-client-ip.ts","src/legacy/index.md","src/monitor.ts","src/research.ts","src/session-credential.ts","src/www-authenticate.ts","tests/agent-metadata-policy.test.mjs","tests/mcp-search-profile.test.mjs","tests/mcp-smoke.test.mjs","tests/nginx-config.test.mjs","tests/readme-security.test.mjs","tests/www-authenticate.test.mjs","tsconfig.json","tsup.config.ts"],"storefront":"/r/firecrawl","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/firecrawl/firecrawl-mcp-server/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}