Set up Firecrawl MCP in a client

Start with Connect Firecrawl MCP to choose account OAuth, unattended API-key access, or keyless access. These client-specific examples use that same mode-aware contract.

Running on Cursor

Install the hosted keyless server in one click (no API key required):

Or add it to ~/.cursor/mcp.json manually:

{
  "mcpServers": {
    "firecrawl": {
      "url": "https://mcp.firecrawl.dev/v2/mcp"
    }
  }
}

Running locally with an API key

Note: Requires Cursor version 0.45.6+ For the most up-to-date configuration instructions, please refer to the official Cursor documentation on configuring MCP servers: Cursor MCP Server Configuration Guide To configure Firecrawl MCP in Cursor v0.48.6

Open Cursor Settings
Go to Features > MCP Servers
Click ”+ Add new global MCP server”

Enter the following code:

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

To configure Firecrawl MCP in Cursor v0.45.6

Open Cursor Settings
Go to Features > MCP Servers
Click ”+ Add New MCP Server”
Enter the following:
- Name: “firecrawl-mcp” (or your preferred name)
- Type: “command”
- Command: env FIRECRAWL_API_KEY=your-api-key npx -y firecrawl-mcp@3.22.4

If you are using Windows and are running into issues, try cmd /c "set FIRECRAWL_API_KEY=your-api-key && npx -y firecrawl-mcp@3.22.4"

Replace 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 After 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 data needs. Access the Composer via Command+L (Mac), select “Agent” next to the submit button, and enter your query.

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 Streamable HTTP Mode

To run the server using streamable HTTP transport locally instead of the default stdio transport:

env HTTP_STREAMABLE_SERVER=true FIRECRAWL_API_KEY=fc-YOUR_API_KEY npx -y firecrawl-mcp@3.22.4

Use the url: http://localhost:3000/v2/mcp locally, or the hosted https://mcp.firecrawl.dev/v2/mcp

Installing via Smithery (Legacy)

To install Firecrawl for Claude Desktop automatically via Smithery:

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

Running on VS Code

For one-click installation, click one of the install buttons below…

For 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).

{
  "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}"
        }
      }
    }
  }
}

Optionally, you can add it to a file called .vscode/mcp.json in your workspace. This will allow you to share the configuration with others:

{
  "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}"
      }
    }
  }
}

Note: Some users have reported issues when adding the MCP server to VS Code due to how it validates JSON with an outdated schema format (microsoft/vscode#155379). This affects several MCP tools, including Firecrawl. Workaround: Disable JSON validation in VS Code to allow the MCP server to load properly. See reference: directus/directus#25906 (comment). The MCP server still works fine when invoked via other extensions, but the issue occurs specifically when registering it directly in the MCP server list. We plan to add guidance once VS Code updates their schema validation.

Running on Claude Desktop

For an interactive account connection, add the account endpoint and complete the browser OAuth flow:

{
  "mcpServers": {
    "firecrawl": {
      "url": "https://mcp.firecrawl.dev/v2/mcp-oauth"
    }
  }
}

For an unattended or API-key-backed configuration, use https://mcp.firecrawl.dev/v2/mcp with an Authorization: Bearer <FIRECRAWL_API_KEY> header instead. If you get a “Couldn’t reach the MCP server” error, your Claude Desktop version may not support streamable HTTP transport. Use the local npx approach instead (requires Node.js):

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

If you see a spawn npx ENOENT error, Node.js is not installed or not in your system PATH. Install Node.js from nodejs.org (LTS version), then fully restart Claude Desktop. On Windows, you can also run where npx in Command Prompt and use the full path (e.g. C:\\Program Files\\nodejs\\npx.cmd) as the command value.

Running on Claude Code

Add the Firecrawl MCP server using the Claude Code CLI. You can use the remote hosted URL or run locally:

# Interactive account connection (recommended)
claude mcp add --transport http firecrawl https://mcp.firecrawl.dev/v2/mcp-oauth

# For an unattended API-key configuration, use an Authorization header
claude mcp add --transport http firecrawl https://mcp.firecrawl.dev/v2/mcp --header "Authorization: Bearer <FIRECRAWL_API_KEY>"

# Or run locally via npx
claude mcp add firecrawl -e FIRECRAWL_API_KEY=fc-your-api-key -- npx -y firecrawl-mcp@3.22.4

Running on Google Antigravity

Google Antigravity allows you to configure MCP servers directly through its Agent interface.

Open the Agent sidebar in the Editor or the Agent Manager view
Click the ”…” (More Actions) menu and select MCP Servers
Select View raw config to open your local mcp_config.json file
Add the following configuration:

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

Save the file and click Refresh in the Antigravity MCP interface to see the new tools

Replace YOUR_FIRECRAWL_API_KEY with your API key from https://firecrawl.dev/app/api-keys.

Running on n8n

To connect the Firecrawl MCP server in n8n:

Get your Firecrawl API key from https://firecrawl.dev/app/api-keys
In your n8n workflow, add an AI Agent node
In the AI Agent configuration, add a new Tool
Select MCP Client Tool as the tool type
Enter the MCP server Endpoint:

https://mcp.firecrawl.dev/v2/mcp

Set Server Transport to HTTP Streamable
Set Authentication to Bearer and paste your Firecrawl API key, or leave it as None to use the keyless free tier
For Tools to include, you can select All, Selected, or All Except - this will expose the Firecrawl tools (scrape, crawl, map, search, extract, etc.)

For self-hosted deployments, run the MCP server with npx and enable HTTP transport mode:

env HTTP_STREAMABLE_SERVER=true \
    FIRECRAWL_API_KEY=fc-YOUR_API_KEY \
    FIRECRAWL_API_URL=YOUR_FIRECRAWL_INSTANCE \
    npx -y firecrawl-mcp@3.22.4

This will start the server on http://localhost:3000/v2/mcp which you can use in your n8n workflow as Endpoint. The HTTP_STREAMABLE_SERVER=true environment variable is required since n8n needs HTTP transport.

Get Started

Core Endpoints

More

Quickstarts

Developer Guides

Webhooks

Use Cases

Other

Contributing

Set up Firecrawl MCP in a client

Running on Cursor

Running locally with an API key

Running on Windsurf

Running with Streamable HTTP Mode

Installing via Smithery (Legacy)

Running on VS Code

Running on Claude Desktop

Running on Claude Code

Running on Google Antigravity

Running on n8n

​Running on Cursor

​Running locally with an API key

​Running on Windsurf

​Running with Streamable HTTP Mode

​Installing via Smithery (Legacy)

​Running on VS Code

​Running on Claude Desktop

​Running on Claude Code

​Running on Google Antigravity

​Running on n8n

Running on Cursor

Running locally with an API key

Running on Windsurf

Running with Streamable HTTP Mode

Installing via Smithery (Legacy)

Running on VS Code

Running on Claude Desktop

Running on Claude Code

Running on Google Antigravity

Running on n8n