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.
{
"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
- Step 1: Open
~/.cursor/mcp.json(or.cursor/mcp.jsonin a project) and add the block at the top of this page insidemcpServers. - Step 2: Save. When Cursor asks, sign in to Firecrawl in the browser and pick a team.
- Step 3: Open Cursor's MCP settings and check firecrawl is enabled with its tools listed. Refresh the server list if it is empty.
- 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
| URL | How it signs in | Good for |
|---|---|---|
https://mcp.firecrawl.dev/v2/mcp-oauth | Browser sign-in, no key in the file | Most people; safe to share the file |
https://mcp.firecrawl.dev/v2/mcp | Nothing: keyless, search, scrape and parse only | A 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:
{
"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=1andFIRECRAWL_NO_ENDPOINT_FEEDBACK=1remove the feedback tools.
Troubleshooting
| What you see | What to do |
|---|---|
| No tools after adding | Refresh the server list in MCP settings, or restart Cursor. |
| Sign-in did not open | Toggle firecrawl off and on to start the sign-in again. Do not paste the URL into your browser. |
| The agent never uses Firecrawl | Use Agent mode and describe the web task plainly, for example "scrape this URL". |
| Local server fails on Windows | Use 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.
