
Firecrawl MCP, Firecrawl's official web scraping server
Lets your AI assistant search the web, read pages as clean text, crawl whole sites and click through dynamic pages.
This is Firecrawl's own server. It lets Claude, ChatGPT, Cursor and other assistants search the web, read pages as clean text, crawl whole sites and click through dynamic pages. The free plan gives 1,000 credits a month, and you are charged even when a page answers with a 403 or 404. A keyless hosted address works without an account for scrape, search and parse, with a daily cap.
Good for
- Anyone who wants Claude or ChatGPT to research a topic from current web sources
- Developers who need clean page text from sites for an agent or a RAG pipeline
- Teams mapping or crawling a whole site to pull out its content
- Self-hosters who want to run scraping on their own Firecrawl instance
Works in
9 supported · 1 with issues · 4 should work
Tap an app to see how to set it up and any known problems.
Documented by Firecrawl. Add its connector from the Claude directory, then sign in.
Known problems
- Fixed
Every tool call returned Unauthorized over local stdio even with an API key set
Reported May 2026 · GitHub
Documented by Firecrawl. Add the hosted address to your MCP config, or run the npm package with your key. docs.firecrawl.dev
Documented by Firecrawl. Run MCP: Add Server, choose HTTP and sign in when asked. docs.firecrawl.dev
Documented in the README. Add an npx entry with your API key to the MCP config. GitHub
Documented by Firecrawl. Add the server, then run codex mcp login firecrawl. docs.firecrawl.dev
The repo ships a Gemini CLI extension that runs the npm package with your key.
Known problems
- Fixed
Gemini rejected the scrape tool because of how its formats option was described
Reported Feb 2026 · GitHub
Documented by Firecrawl. A browser sign-in opens on first use. docs.firecrawl.dev
Documented by Firecrawl through its native ChatGPT app. Add it from the apps directory and sign in. docs.firecrawl.dev
Documented by Firecrawl. Add a remote server entry to opencode.json. docs.firecrawl.dev
Documented by Firecrawl. Search can fail on the hosted server, and large results are cut short.
Known problems
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports hosted MCP servers.
Install Firecrawl MCP
Claude Code
- 1
Copy this prompt.
Add the Firecrawl MCP server to Claude Code. Run this command: claude mcp add --transport http firecrawl https://mcp.firecrawl.dev/v2/mcp-oauth Then check that it loaded and tell me if I need to sign in or restart.
- 2
Paste it into Claude Code. It shows the change and asks before running it.
Requires Firecrawl account.
Read-only mode: Want search only? Use https://mcp.firecrawl.dev/v2/mcp-search instead of the main address. It exposes 9 search and lookup tools, and its search does not fetch page content.
The hosted sign-in address is https://mcp.firecrawl.dev/v2/mcp-oauth: your client opens Firecrawl, you pick a team, and you can revoke the connection later in Firecrawl MCP settings. The keyless address https://mcp.firecrawl.dev/v2/mcp needs no account but only offers scrape, search and parse at a rate limit; crawl, map and agent need a key or sign-in. To use an API key with the hosted server, send the header Authorization: Bearer <FIRECRAWL_API_KEY>; never put the key in the URL. The local npx method needs Node.js 22 or newer. Set FIRECRAWL_API_URL if you run a self-hosted Firecrawl. After adding, run /mcp and finish the Firecrawl sign-in.
From the vendor's docs. Source.
Tools
Reads one web page and returns its content
Scrapes a single known URL and returns the content, preferably as structured JSON or else markdown. Use it when you know the exact page you want.
Try: “Scrape https://example.com/pricing and give me the plan names and prices”
Network ·
firecrawl_scrapeSearches the web and can return page content
Runs a web search and returns results, with options to restrict by category or source. Use it when you do not know which page has the answer.
Try: “Search the web for the latest Next.js release notes”
Network ·
firecrawl_searchLists the URLs found on a website
Discovers URLs on a site so you can see what pages exist before reading any of them. Use it to find the right page on a large site.
Try: “Map docs.example.com and list the pages about authentication”
Network ·
firecrawl_mapReads many pages across a site or section
Crawls a site or section and returns the extracted pages once the crawl finishes. Always set limits so it does not run wide. Use it to pull a whole docs section.
Try: “Crawl the first 20 pages of docs.example.com/api”
Network ·
firecrawl_crawlClicks, types and navigates on a live web page
Opens a URL, or continues on a page already scraped, and lets the assistant click, type and navigate to reach content that needs interaction. Use it for dynamic pages.
Try: “Open the site, click the Pricing tab and read the annual prices”
Runs code ·
firecrawl_interactTurns an uploaded file into markdown or structured data
Parses files such as PDFs, Word documents, spreadsheets and HTML into markdown or JSON. Pass one file per call. Local file reads need a self-hosted setup. Use it to extract text from documents.
Try: “Parse this PDF report and give me the key tables as JSON”
Files ·
firecrawl_parseResearches a question across unknown sites and returns structured data
Starts an agent that searches several sites on its own and returns structured data, such as a list or a set of fields about an entity. Use it when you do not know which pages hold the answer.
Try: “Find the founders and funding of 10 AI observability startups”
Network ·
firecrawl_agentSearches issues, pull requests, READMEs and docs for coding answers
Searches an index built for coding agents that covers GitHub issues, merged pull requests, READMEs and code documentation. Use it for library behavior, API contracts, error messages and known bugs.
Try: “Why does this library throw a ECONNRESET error on retry?”
Network ·
firecrawl_developer_searchSearches US government law and regulation sources
Searches statutes, regulations, codes, court opinions and other US federal, state and local government publications. Use it when you need the governing text or an official source.
Try: “Find the federal regulation on data breach notification timelines”
Network ·
firecrawl_gov_searchSearches scientific paper abstracts
Searches paper metadata and abstracts with a natural-language query, with optional author, category and date filters. Use it to start a literature search.
Try: “Find recent papers on GLP-1 agonists and kidney outcomes”
Network ·
firecrawl_research_search_papersGets the details of one paper by its ID
Retrieves the canonical metadata for a single paper from an arXiv, PMC, PMID or DOI identifier. Use it to confirm what a specific paper is.
Try: “Show details for the paper with DOI 10.1000/xyz123”
Network ·
firecrawl_research_inspect_paperFinds papers connected to ones you already have
Expands from one or more anchor papers through the citation graph to find related work. Use it to widen a literature review.
Try: “Find papers related to arXiv 1706.03762”
Network ·
firecrawl_research_related_papersReads passages from a paper's full text
Reads full-text passages from a specific paper. Use it when the abstract is not enough and you need the detail.
Try: “Read the methods section of that paper”
Network ·
firecrawl_research_read_paperSets up a recurring check on a web page
Creates a monitor that rescans one or more pages on a schedule and compares each result with the last snapshot. A plain-English goal tells it which changes matter. Use it to watch pages for updates.
Try: “Monitor example.com/pricing and tell me if the prices change”
Write ·
firecrawl_monitor_createLists your page monitors
Lists the monitors on your account. Use it to see what you are already watching.
Try: “List my web page monitors”
Network ·
firecrawl_monitor_listShows the details of one monitor
Returns the settings and state of a single monitor. Use it to check how a monitor is configured.
Try: “Show the details of my pricing monitor”
Network ·
firecrawl_monitor_getChanges a monitor's goal or alert settings
Updates a monitor, including its goal, whether change judging is on, and its webhook or notification settings. Use it to tune what you get alerted about.
Try: “Update my pricing monitor to only alert on price changes”
Write ·
firecrawl_monitor_updateRuns a monitor check right now
Triggers an immediate check instead of waiting for the next scheduled run. Use it to test a monitor or get fresh results.
Try: “Run my pricing monitor now”
Runs code ·
firecrawl_monitor_runRemoves a monitor permanently
Deletes a monitor. The docs mark it as destructive, so only use it when you mean to remove it.
Try: “Delete my old pricing monitor”
Delete ·
firecrawl_monitor_deleteLists the past checks of a monitor
Lists the checks a monitor has run, optionally filtered by status. Use it to see the history of runs.
Try: “Show the last checks for my pricing monitor”
Network ·
firecrawl_monitor_checksShows what changed in one monitor check
Returns page-level results for a single check, including the diff, the snapshot and whether the change was judged meaningful. Use it to see exactly what changed.
Try: “Show what changed in the latest pricing check”
Network ·
firecrawl_monitor_checkShows your remaining Firecrawl credits
Returns your remaining and plan credits for the billing period, or historical usage by month and by API key. It needs an authenticated account. Use it to check spend.
Try: “How many Firecrawl credits do I have left?”
Network ·
firecrawl_credit_usageUsed by the assistant behind the scenes
Checks how far a crawl job has got
Looks up the status of a crawl that was started earlier. Use it when a crawl is still running and you need its progress or results.
Try: “Check the status of my crawl job”
Network ·
firecrawl_check_crawl_statusEnds a browser session started for a page
Stops an interact session for a scraped page once you are done. Use it to clean up after browsing a page.
Try: “Stop the browser session on that page”
Runs code ·
firecrawl_interact_stopChecks the progress of a research agent job
Looks up the status and results of an agent job started earlier. Use it to fetch the answer once the agent finishes.
Try: “Check whether my research agent has finished”
Network ·
firecrawl_agent_statusBrowses the Alexandria catalogue of data providers
Browses the catalogue of data providers step by step, from categories down to the exact tool contract. It runs nothing and costs no credits. It needs an API key on a team with Alexandria access.
Try: “What data providers does the Alexandria catalogue have for podcasts?”
Network ·
firecrawl_find_toolsSends a quality rating on a search result back to Firecrawl
Sends structured feedback on an earlier search. The first feedback per search refunds one credit. It can be disabled with an environment variable. Use it after using a search.
Try: “Send feedback that the last search missed the official docs”
Write ·
firecrawl_search_feedbackSends feedback on a finished scrape, parse, map or search job
Sends structured feedback for a completed endpoint job. For search quality specifically, the search feedback tool is preferred.
Try: “Send feedback on that scrape job”
Write ·
firecrawl_feedback
Read from the source code
Pros and cons
Good
- Made and run by Firecrawl.
- Search, scrape, crawl, map, parse documents and click through pages.
- A keyless hosted address works with no account.
- Sign in with your account or use an API key.
- Can run against your own self-hosted Firecrawl.
- Works with Claude, ChatGPT, Codex, Cursor, VS Code and Gemini CLI.
Watch out
- Credits are charged even when a page answers 403 or 404.
- The free plan has 1,000 credits a month and no pay-as-you-go top-ups.
- The keyless address has a daily cap.
- Self-hosted Firecrawl lacks anti-bot, page actions and Agent.
- Pages and queries go to Firecrawl's cloud.
- Long tool descriptions use a lot of context.
Permissions
medium risk · 6 things to watch
Medium risk
The assistant can click through sites, run crawls that spend your credits, and every page and query goes to Firecrawl's cloud. Use the search-only address if you just need search, and set credit limits on crawls and agent runs.
What it can do
- Read your data
- Create and change things
- Delete things
- Read-only modeHow to turn it on
Watch out for
Local file read through parse in self-hosted setups
When the local server points at a self-hosted Firecrawl, the parse tool reads any file path the model passes, including files outside your project. Two reports are still open, so keep the model away from sensitive folders. github.com
Search is marked read-only but can click and type
The search tool tells clients it is read-only, yet its scrape options accept browser actions such as clicking, typing and running JavaScript. A client may skip asking you first, so review these calls. github.com
Agent runs and crawls can spend many credits
An agent run may spend up to 2,500 credits by default, and crawls bill per page. Set a credit limit and crawl limits, and use a key with a pay-as-you-go cap. github.com
An exposed local HTTP server shares your API key
If you run HTTP mode on 0.0.0.0, anyone who can reach the port uses your Firecrawl key. Keep it on localhost. github.com
Pages are fetched by Firecrawl's cloud
With the hosted address or a cloud API key, every URL and query goes to Firecrawl's servers. Self-host Firecrawl if pages or queries must stay in-house. docs.firecrawl.dev
The bundled zod library has a high-severity advisory
The Firecrawl SDK the server pins pulls in zod 3, which npm audit flags for a memory-exhaustion advisory with no 3.x fix. It is waiting on an SDK release. github.com
Security advisories
No published security advisories as of Nov 1, 2026.
Technical details
| Turning on read-only | Connect to the search-only address https://mcp.firecrawl.dev/v2/mcp-search. It exposes search and lookup tools only, with no browser actions or page fetching. The keyless address is also limited to scrape, search and parse. |
|---|---|
| Talks to | mcp.firecrawl.dev. api.firecrawl.dev |
| Sign-in and keys | Sign in with your Firecrawl account in the browser, or send your API key in a header. The docs say never to put the key in the address. |
Alternatives
Use Firecrawl when you need whole pages or sites as clean text, or want to self-host. Pick Exa or Tavily for search-first work, Apify for ready-made scrapers for specific sites, and Playwright for a free browser on your own machine.
| Server | Official | Runs | Sign-in | GitHub stars | Weekly downloads |
|---|---|---|---|---|---|
| For Firecrawl | |||||
| Firecrawl MCP ServerThis page | Official | HostedLocal | Account or key | – | 190.7K/wk |
| Other tools for the same job | |||||
| Exa MCP ServerFor Exa | Official | HostedLocal | None or account | – | – |
| Tavily MCP | Official | – | – | 2.5K | – |
| Apify MCP ServerFor Apify | Official | – | – | 14K | 30.5K/wk |
| Playwright MCPFor Playwright | Official | Local | No sign-in | 38.9K | – |
What people say
People like its extraction quality and the option to self-host, and dislike its broad terms, long tool descriptions and crawler behaviour.
What people like
- Users report better extraction results than with alternatives.
- The team ships features quickly and its core scraping has become really good.
- Self-hosting avoids paying for credits, if you can live without some cloud features.
Common complaints
- Firecrawl's terms grant it a broad licence to content you submit, so check them before sending private data.
- Site operators say its crawlers hide their identity and ignore robots rules.
- Against a self-hosted Firecrawl, search breaks because the server sends cloud-only options.
- Tool descriptions are long, around 18k tokens per session, which eats context.
In their words
“I personally used to use Firecrawl's paid credits (got a bunch of em for free at an event) before I realized that they allow you to self-host your own instance (albeit missing some features I never use anyways).”hrideshmgHacker NewsOct 2026
“You'd probably be better off using free services like Jina directly, or if you're going paid, Parallel, Firecrawl, Tavily and Exa are all pretty good now.”ggnore7452Hacker NewsJul 2026
“their team has been shipping great features extremely quickly lately, and their core offerings have become really good.”m_w_Hacker NewsMar 2026
“I am getting much better results from Firecrawl (not affiliated with them, just a happy customer).”davidhariri
Questions
What is the Firecrawl MCP server URL?
The main hosted address is https://mcp.firecrawl.dev/v2/mcp. Use https://mcp.firecrawl.dev/v2/mcp-oauth to sign in with your account, and https://mcp.firecrawl.dev/v2/mcp-search for search only.
Is Firecrawl MCP free?
Partly. The keyless hosted address works with no account for scrape, search and parse, with a daily cap. The free plan adds 1,000 credits a month and unlocks crawl, map and the other tools, and paid plans start at $19 a month for 5,000 credits.
Am I charged when a page fails to load?
Yes, if Firecrawl returns a document, even when the site answered 403 or 404. If no document comes back, nothing is charged.
What happens when I run out of credits?
Requests fail with an HTTP 402 error. On the free plan they stay blocked until the monthly reset, and unused credits do not roll over. Paid plans can turn on pay-as-you-go top-ups in $5 steps.
How many credits does each call use?
Scrape and crawl cost 1 credit per page, map 1 per call, and search 2 per 10 results. JSON extraction adds 4 per page, PDFs add 1 per page, and browser interaction costs 2 to 7 credits per minute.
What are the limits of the keyless address?
It is capped per IP address per day by requests and credits, and you get a 429 error when you hit it. On the free plan, scrape, map and search allow 10 requests a minute, and crawl, agent and interact allow 2.
Can I use it with self-hosted Firecrawl?
Yes, with the npm package pointed at your own instance, and the API key becomes optional. Self-hosted Firecrawl lacks the anti-bot engine, page actions and Agent, and an open issue reports search failing against self-hosted instances on recent versions.
How do I make it read-only?
Connect to the search-only address instead of the main one. It offers search and lookup tools only, with no browser actions or page fetching.
Should I sign in or use an API key?
Sign in with your account for interactive clients. For unattended setups, use the main address with your key in an Authorization header. Both reach the same tools on your plan.
Firecrawl, Exa or Tavily?
Exa and Tavily focus on web search for agents. Firecrawl also scrapes, crawls and maps whole sites, can click through pages, and can run against your own self-hosted instance.
Examples
Research a topic from current sources
Search for the latest Next.js release notes and summarize the sources.
SourceRead a single page as clean text
Scrape https://firecrawl.dev and explain what it does.
SourceClick through a dynamic page to reach data
Click the pricing link and summarize the visible plans
Source
Information
updated Nov 2, 2026
- Publisher
- Firecrawl (official)
- Package
firecrawl-mcp- Registry
- npm
- Endpoint
https://mcp.firecrawl.dev/v2/mcp- Transport
- stdio, Streamable HTTP
- Auth
- API key
- Version
- 3.36.0
- License
- MIT
- Last commit
- Oct 29, 2026
- Listed in
- Official MCP registry
WebsiteFirecrawl MCP docsGitHubnpmOfficial MCP RegistryChangelogPricing
Other Firecrawl MCP servers
Sources
Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.
Show all 31Hide
- docs.firecrawl.dev · docs.firecrawl.dev
- MCP OAuth · docs.firecrawl.dev
- Keyless MCP · docs.firecrawl.dev
- github.com · github.com
- docs.firecrawl.dev · docs.firecrawl.dev
- www.firecrawl.dev · firecrawl.dev
- github.com · github.com
- github.com · github.com
- github.com · github.com
- docs.firecrawl.dev · docs.firecrawl.dev
- github.com · github.com
- github.com · github.com
- docs.firecrawl.dev · docs.firecrawl.dev
- docs.firecrawl.dev · docs.firecrawl.dev
- github.com · github.com
- docs.firecrawl.dev · docs.firecrawl.dev
- docs.firecrawl.dev · docs.firecrawl.dev
- github.com · github.com
- github.com · github.com
- github.com · github.com
- github.com · github.com
- news.ycombinator.com · news.ycombinator.com
- news.ycombinator.com · news.ycombinator.com
- news.ycombinator.com · news.ycombinator.com
- news.ycombinator.com · news.ycombinator.com
- news.ycombinator.com · news.ycombinator.com
- github.com · github.com
- github.com · github.com
- github.com · github.com
- github.com · github.com
- github.com · github.com