PlugWiki
Firecrawl MCP Server logo

Firecrawl MCP, Firecrawl's official web scraping server

Official · by FirecrawlRemoteLocal
Gethttps://mcp.firecrawl.dev/v2/mcpfirecrawl/firecrawl-mcp-serverDocs

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.

Install Firecrawl MCP

Claude Code

  1. 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. 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_scrape

  • Searches 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_search

  • Lists 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_map

  • Reads 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_crawl

  • Clicks, 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_interact

  • Turns 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_parse

  • Researches 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_agent

  • Searches 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_search

  • Searches 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_search

  • Searches 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_papers

  • Gets 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_paper

  • Finds 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_papers

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

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-onlyConnect 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 tomcp.firecrawl.dev. api.firecrawl.dev
Sign-in and keysSign 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.

ServerOfficialRunsSign-inGitHub starsWeekly downloads
For Firecrawl
Firecrawl MCP ServerThis pageOfficialHostedLocalAccount or key–190.7K/wk
Other tools for the same job
Exa MCP ServerFor ExaOfficialHostedLocalNone or account––
Tavily MCPOfficial––2.5K–
Apify MCP ServerFor ApifyOfficial––14K30.5K/wk
Playwright MCPFor PlaywrightOfficialLocalNo sign-in38.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

2 more quotes

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.

    Source
  • Read a single page as clean text

    Scrape https://firecrawl.dev and explain what it does.

    Source
  • Click 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 31
  1. docs.firecrawl.dev · docs.firecrawl.dev
  2. MCP OAuth · docs.firecrawl.dev
  3. Keyless MCP · docs.firecrawl.dev
  4. github.com · github.com
  5. docs.firecrawl.dev · docs.firecrawl.dev
  6. www.firecrawl.dev · firecrawl.dev
  7. github.com · github.com
  8. github.com · github.com
  9. github.com · github.com
  10. docs.firecrawl.dev · docs.firecrawl.dev
  11. github.com · github.com
  12. github.com · github.com
  13. docs.firecrawl.dev · docs.firecrawl.dev
  14. docs.firecrawl.dev · docs.firecrawl.dev
  15. github.com · github.com
  16. docs.firecrawl.dev · docs.firecrawl.dev
  17. docs.firecrawl.dev · docs.firecrawl.dev
  18. github.com · github.com
  19. github.com · github.com
  20. github.com · github.com
  21. github.com · github.com
  22. news.ycombinator.com · news.ycombinator.com
  23. news.ycombinator.com · news.ycombinator.com
  24. news.ycombinator.com · news.ycombinator.com
  25. news.ycombinator.com · news.ycombinator.com
  26. news.ycombinator.com · news.ycombinator.com
  27. github.com · github.com
  28. github.com · github.com
  29. github.com · github.com
  30. github.com · github.com
  31. github.com · github.com

Facts from the official MCP registry, GitHub, npm, PyPI and the Docker catalog. Updated Nov 2, 2026.