MCP Directory

How to add Firecrawl to Cursor

Official Firecrawl MCP server — scrape, crawl, map, search, and structured extraction for any LLM client. Paste the config into ~/.cursor/mcp.json and restart Cursor.

Last updated June 15, 2026 · 6.6k★ · stdio · apikey · official

Cursor config for Firecrawl

npx -y firecrawl-mcp
{
  "mcpServers": {
    "firecrawl": {
      "command": "npx",
      "args": [
        "-y",
        "firecrawl-mcp"
      ],
      "env": {
        "FIRECRAWL_API_KEY": "<your-firecrawl-api-key>"
      }
    }
  }
}

Setup steps

  1. 1Open Cursor → Settings → MCP → Add new MCP server (or edit ~/.cursor/mcp.json directly).
  2. 2Paste the Firecrawl config below into the "mcpServers" object.
  3. 3Fill in placeholder secrets, then save.
  4. 4Cursor reloads MCP servers automatically — check Settings → MCP for a green status dot.
  5. 5Ask Cursor to use one of Firecrawl's tools to confirm it's connected.

Before you start

  • Node.js (18+) with npx, or install globally via npm
  • A Firecrawl API key (format fc-...) from https://www.firecrawl.dev/app/api-keys
  • Optional: FIRECRAWL_API_URL to target a self-hosted Firecrawl instance instead of the cloud API

What Firecrawl can do in Cursor

firecrawl_scrape

Scrape a single URL and return clean Markdown or JSON content.

firecrawl_batch_scrape

Scrape multiple known URLs in one async batch job.

firecrawl_check_batch_status

Poll the progress and results of a batch scrape job.

firecrawl_map

Discover and list all indexed/linked URLs on a website.

firecrawl_search

Run a web search and optionally scrape the result pages' content.

firecrawl_crawl

Asynchronously crawl a site across multiple pages with depth and limit controls.

firecrawl_check_crawl_status

Poll the status and accumulated results of a crawl job.

firecrawl_extract

Extract structured data from pages using an LLM and a custom JSON schema/prompt.

Security

Requires a FIRECRAWL_API_KEY that gates billable credits; keep it secret and watch for credit-usage warnings. The crawl/scrape tools fetch arbitrary URLs you supply, so treat all returned page content as untrusted model input.

Firecrawl + Cursor FAQ

Where is the Cursor config file?

Cursor reads MCP servers from ~/.cursor/mcp.json. Paste the Firecrawl config there under the "mcpServers" key and restart the client.

Is Firecrawl safe to use with Cursor?

Requires a FIRECRAWL_API_KEY that gates billable credits; keep it secret and watch for credit-usage warnings. The crawl/scrape tools fetch arbitrary URLs you supply, so treat all returned page content as untrusted model input.

Do I need an API key?

Yes. The server is a client for the hosted Firecrawl API and requires a FIRECRAWL_API_KEY (format fc-...). You can self-host the Firecrawl backend and point FIRECRAWL_API_URL at it.

Is there a free tier?

Firecrawl offers a free plan with a limited monthly credit allowance; scrapes, crawls, and extractions consume credits. Heavy crawling requires a paid plan.

Which MCP clients does it support?

Any MCP-compatible client over stdio, including Claude Desktop, Cursor, VS Code, and Windsurf. It can also run as an HTTP Streamable or local SSE server for remote setups.

View repo Full Firecrawl page