Skip to content
MCP Shelf

Pod to App: Cursor

How to install Firecrawl MCP in Cursor

By Sophie Filer · Updated 11 Nov 2026 · Steps checked against Firecrawl's own docs on 11 Nov 2026

The short answer

Add the entry below to ~/.cursor/mcp.json and save. Cursor opens a Firecrawl sign-in in your browser; approve a team and the scrape, crawl and search tools appear in Agent chat.

~/.cursor/mcp.json
{
  "mcpServers": {
    "firecrawl": {
      "url": "https://mcp.firecrawl.dev/v2/mcp-oauth"
    }
  }
}
File
~/.cursor/mcp.json
Sign-in
Browser, key, or keyless
Local option
npx firecrawl-mcp
Price
Free tier, paid plans

Set it up step by step

  1. Step 1: Open ~/.cursor/mcp.json (or .cursor/mcp.json in a project) and add the block at the top of this page inside mcpServers.
  2. Step 2: Save. When Cursor asks, sign in to Firecrawl in the browser and pick a team.
  3. Step 3: Open Cursor's MCP settings and check firecrawl is enabled with its tools listed. Refresh the server list if it is empty.
  4. Step 4: In Agent chat, ask: "Scrape the pricing page of example.com and put the plans in a Markdown table."

Three ways to authenticate

URLHow it signs inGood for
https://mcp.firecrawl.dev/v2/mcp-oauthBrowser sign-in, no key in the fileMost people; safe to share the file
https://mcp.firecrawl.dev/v2/mcpNothing: keyless, search, scrape and parse onlyA quick try before making an account
https://mcp.firecrawl.dev/v2/mcp with a header"headers": {"Authorization": "Bearer YOUR_KEY"}Setups where nobody can sign in

The local server, as in the README

Firecrawl's README also shows the open-source server running locally through npx. It needs an API key, or a self-hosted Firecrawl URL:

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

On Windows, if the command form gives trouble, the README suggests cmd /c "set FIRECRAWL_API_KEY=your-api-key && npx -y firecrawl-mcp".

Too many tools for Cursor?

The full local server lists around thirty tools, which eats into what Cursor can keep active across all your servers. Two lighter options from Firecrawl:

  • The keyless endpoint exposes just three tools: scrape, search and parse.
  • The search-only endpoint, https://mcp.firecrawl.dev/v2/mcp-search, has a fixed set of eleven search tools.
  • Locally, FIRECRAWL_NO_SEARCH_FEEDBACK=1 and FIRECRAWL_NO_ENDPOINT_FEEDBACK=1 remove the feedback tools.

Troubleshooting

What you seeWhat to do
No tools after addingRefresh the server list in MCP settings, or restart Cursor.
Sign-in did not openToggle firecrawl off and on to start the sign-in again. Do not paste the URL into your browser.
The agent never uses FirecrawlUse Agent mode and describe the web task plainly, for example "scrape this URL".
Local server fails on WindowsUse the cmd /c form from the README.

MCP Shelf take

Is Firecrawl worth adding to Cursor?

Cursor's agent is good at code and poor at the live web; Firecrawl fills that gap neatly. Use it to pull current API docs, scrape a competitor's pricing page into a table, or crawl a docs site into Markdown you can keep in the repo. The hosted sign-in URL is the one to use: nothing secret in the file, and you get the full tool set. Keep crawls bounded so credits do not run away, and if Cursor complains about tool count, the keyless or search-only endpoints are lighter.

Sophie Filer

Questions

Does Firecrawl MCP need an API key in Cursor?

No. The mcp-oauth URL signs you in through the browser. Keys are only needed for the local npx server or for headless setups.

Which Cursor version does Firecrawl need?

The README lists Cursor 0.45.6 or newer for the local server. The hosted URL needs a Cursor that supports remote MCP servers, which current versions do.

Can I use a self-hosted Firecrawl with Cursor?

Yes, with the local npx server: set FIRECRAWL_API_URL to your instance in the env block. The API key becomes optional.

Sources: the steps on this page are written in our own words from Firecrawl's own install docs, the README, the README. If they disagree with this page, the project's docs win; please tell us from the server page.