{"slug": "tools-changed-breaking-firecrawl-official", "title": "Tools changed (breaking): Firecrawl (official)", "summary": "Firecrawl's official MCP server, npm firecrawl-mcp 3.38.0, scored 90/100 in a retest on 2026-11-09, capped because only 2 of 3 real keyless tool calls passed. The server completed an MCP handshake without credentials and listed 26 tools, with firecrawl_scrape and firecrawl_search returning results in keyless mode while firecrawl_map failed with \"API key is required when not using a self-hosted instance\"; the tool list carries an estimated 11,825 tokens under cl100k_base, measured 2026-11-11. The version was previously 3.33.4 in a 2026-10-22 test, and Firecrawl limits keyless use per IP, a daily cap the tester hit in a 2026-10-29 fetch-token test.", "body_md": "# Firecrawl (official)\n\n**90**/100\n\nCapped at 90: 2 of 3 real tool calls passed in our test; the tests add up to 100. [Why scores are capped](https://testedmcp.com/methodology/#pass-ratio)\n\nTest points add up to 100; the score is capped at 90 because not every real tool call passed. Not a quality or security rating. [Why scores are capped](https://testedmcp.com/methodology/#pass-ratio)\n\nTest points before the cap (100/100)\n\n- Install20/20\n- Handshake30/30\n- Maintenance25/25\n- Docs15/15\n- License10/10\n\nRetested 2026-11-09 with npm firecrawl-mcp 3.38.0 (was 3.33.4 on 2026-10-22). No API key and no account: the server starts in keyless mode (\"firecrawl_scrape and firecrawl_search are free (rate-limited per IP) against the Firecrawl cloud; other tools require an API key\"). Initialize and tools/list listed 26 tools. Real keyless calls: firecrawl_scrape of https://example.com/ returned markdown and firecrawl_search returned web results; firecrawl_map failed with \"API key is required when not using a self-hosted instance\". Crawl, agent, interact, monitor, research and credit tools need an API key and were not called. Keyless use is limited per IP by Firecrawl (our 2026-10-29 fetch-token test hit that daily limit).\n\nTool-call test (2026-11-09, direct MCP stdio client, no LLM): **pass**. 2 of 3 keyless calls passed (scrape, search); firecrawl_map needs an API key. Other key-only tools not called. Evidence: local test run, Nov 9, 2026.\n\n**Transport (tested 2026-11-09):** stdio\n\nTested version: 3.38.0 · tested 2026-11-09\n\nToken-cost, context and security package checks shown here were measured on 3.33.4 (Oct 22).\n\n**Token cost (estimate):** approx. 11825 tokens, cl100k estimate (26 tools, measured 2026-11-11, version 3.38.0). This is an estimate from our testing of the tool names, descriptions and input schemas, counted with cl100k_base.\n\n## Permissions: 17 read, 9 write (state-changing), 0 unclassified · Auth: API key · Rate limit: unknown · Pricing unit: unknown\n\nAuth: API key. Rate limit: unknown. Pricing unit: unknown.\n\n- `firecrawl_agent` — write (state-changing)\n- `firecrawl_agent_status` — read\n- `firecrawl_check_crawl_status` — read\n- `firecrawl_crawl` — write (state-changing)\n- `firecrawl_credit_usage` — read\n- `firecrawl_developer_search` — read\n- `firecrawl_find_tools` — read\n- `firecrawl_gov_search` — read\n- `firecrawl_interact` — write (state-changing)\n- `firecrawl_interact_stop` — write (state-changing)\n- `firecrawl_map` — read\n- `firecrawl_monitor_check` — read\n- `firecrawl_monitor_checks` — read\n- `firecrawl_monitor_create` — write (state-changing)\n- `firecrawl_monitor_delete` — write (state-changing)\n- `firecrawl_monitor_get` — read\n- `firecrawl_monitor_list` — read\n- `firecrawl_monitor_run` — write (state-changing)\n- `firecrawl_monitor_update` — write (state-changing)\n- `firecrawl_parse` — read\n- `firecrawl_research_inspect_paper` — read\n- `firecrawl_research_read_paper` — read\n- `firecrawl_research_related_papers` — read\n- `firecrawl_research_search_papers` — read\n- `firecrawl_scrape` — write (state-changing)\n- `firecrawl_search` — read\n\nrecorded env/README key names: FIRECRAWL_API_KEY\n\nScore **90/100** · Tools **26** · Token cost **approx. 11,825 tokens** (Tool list changed 2026-11-09; count from 2026-11-11 capture) · [Compare](https://testedmcp.com/compare/?s=firecrawl) · Last tested **2026-11-09** · Version tested `3.38.0` · Package [firecrawl-mcp](https://www.npmjs.com/package/firecrawl-mcp)[firecrawl/firecrawl-mcp-server](https://testedmcp.com/go/firecrawl/)\n\nSummary: Firecrawl (official) completed an MCP handshake without credentials and exposed 26 tools.\n\n## Evidence summary\n\n- Handshake\n- pass\n- Tools listed\n- 26\n- Context cost\n- approx. 11825 tokens, cl100k estimate (26 tools, measured 2026-11-11, version 3.38.0; an estimate) [ranking](https://testedmcp.com/best/lowest-context-cost-mcp-servers/) ·[add up your servers' context cost](https://testedmcp.com/guides/how-much-context-mcp-servers-cost/)\nTool list changed 2026-11-09; count from 2026-11-11 capture\n- API key\n- No key needed for the tools we called\n- Tested\n- 2026-11-09\n\n## Test results\n\n| Test | Result | Points | Evidence | \n|---|---|---|---|\n| install | pass | 20 | `npm install firecrawl-mcp` (Node 20, Linux) succeeded in 1s. | \n| handshake | pass | 30 | MCP `initialize` +`tools/list` over stdio succeeded with no credentials; 26 tools listed in 0.3s. | \n| maintenance | pass | 25 | Repo pushed 0 days before test; 7,787 GitHub stars. | \n| docs | pass | 15 | README over 3,000 chars; install instructions present; `mcpServers` config example present. Check of the package's own README (README shipped in npm package). | \n| license | pass | 10 | MIT (OSI-approved). | \n\n## Local-model readiness\n\nToken cost (estimate): **approx. 11825 tokens, cl100k estimate** for 26 tools · about 144% of an 8k context. This is an estimate from our testing (counted with cl100k_base).\n\nSmall-model friendly (schema heuristic, not a model result): **low**.\n\n## Not tested\n\nSmall-model task runs: Not yet tested.\n\n## What we tested and what we didn't\n\n### Tested on 2026-11-09\n\n- Install from the registry\n- We connected with no credentials and asked for its tool list: it listed 26 tools (Method details: MCP `initialize` then`tools/list` )\n- Maintenance signals (last push, archived/deprecated status)\n- Docs (README length, install and config example)\n- License (OSI-approved or not)\n- Token cost (estimate)\n\n### Not tested\n\n- Security: **not audited** (no code review, no permission or data-flow analysis)\n- Real tasks (no functional task runs yet)\n- Behaviour with real credentials or a real account\n- Performance, rate limits or load\n- Correctness of results beyond the listed tasks\n\nMethodology: [how we test](https://testedmcp.com/methodology/). A high score means it installs and responds, not that giving it access to your data carries no risk.\n\n## Known security issues\n\nChecked on 2026-11-09 for version `3.33.4` against OSV, GitHub advisories, GitHub repository advisories. Scope: the package itself; dependencies not scanned.\n\nNo published advisories found in OSV and GitHub advisories for firecrawl-mcp 3.33.4 as of 2026-11-09. This is not a security audit.\n\n⚠ Check is out of date.\n\nMonthly roundup: [MCP security issues, October 2026](https://testedmcp.com/security/2026-10/).\n\n## Tool list changes ↻ Tools changed (breaking) 2026-11-09\n\n**Tool list changed since last test (2026-10-22 → 2026-11-09): +4 added, 4 removed, 22 changed (breaking).** Confirmed by a re-run with the same arguments.\n\n## Show the diff\n\n- Added: `firecrawl_credit_usage`\n- Added: `firecrawl_developer_search`\n- Added: `firecrawl_find_tools`\n- Added: `firecrawl_gov_search`\n- Removed: `firecrawl_extract` (breaking)\n- Removed: `firecrawl_feedback` (breaking)\n- Removed: `firecrawl_research_search_github` (breaking)\n- Removed: `firecrawl_search_feedback` (breaking)\n- Changed schema: `firecrawl_agent`\n- Changed schema: `firecrawl_agent_status`\n- Changed schema: `firecrawl_check_crawl_status`\n- Changed schema: `firecrawl_crawl`\n- Changed schema: `firecrawl_interact`\n- Changed schema: `firecrawl_interact_stop`\n- Changed schema: `firecrawl_map`\n- Changed schema: `firecrawl_monitor_check`\n- Changed schema: `firecrawl_monitor_checks`\n- Changed schema: `firecrawl_monitor_create`\n- Changed schema: `firecrawl_monitor_delete`\n- Changed schema: `firecrawl_monitor_get`\n- Changed schema: `firecrawl_monitor_list`\n- Changed schema: `firecrawl_monitor_run`\n- Changed schema: `firecrawl_monitor_update`\n- Changed schema: `firecrawl_parse`\n- Changed schema: `firecrawl_research_inspect_paper`\n- Changed schema: `firecrawl_research_read_paper`\n- Changed schema: `firecrawl_research_related_papers`\n- Changed schema: `firecrawl_research_search_papers`\n- Changed schema: `firecrawl_scrape`\n- Changed schema: `firecrawl_search` (breaking)\n\n## Snapshot hash (fingerprint of the tool list)\n\n`e8b7e02f0bb9`: SHA-256 of the canonical tool names, descriptions and input schemas. If it changes, the tool list changed.\n\n## Raw test record (JSON)\n\n```\n{\n  \"name\": \"firecrawl-mcp\",\n  \"version\": \"3.38.0\",\n  \"registry\": \"npm\",\n  \"status\": \"working\",\n  \"tested\": \"2026-11-09\",\n  \"tools_count\": 26,\n  \"deprecated\": false,\n  \"archived\": false,\n  \"tests\": {\n    \"install\": [\n      \"pass\",\n      20,\n      \"`npm install firecrawl-mcp` (Node 20, Linux) succeeded in 1s.\"\n    ],\n    \"handshake\": [\n      \"pass\",\n      30,\n      \"MCP `initialize` + `tools/list` over stdio succeeded with no credentials; 26 tools listed in 0.3s.\"\n    ],\n    \"maintenance\": [\n      \"pass\",\n      25,\n      \"Repo pushed 0 days before test; 7,787 GitHub stars.\"\n    ],\n    \"docs\": [\n      \"pass\",\n      15,\n      \"README over 3,000 chars; install instructions present; `mcpServers` config example present. Check of the package's own README (README shipped in npm package).\"\n    ],\n    \"license\": [\n      \"pass\",\n      10,\n      \"MIT (OSI-approved).\"\n    ]\n  }\n}\n```\n\n## Install\n\n`npx -y firecrawl-mcp`\n\n## Pin the version we tested\n\n`npx -y firecrawl-mcp@3.38.0`\n\ntested 2026-11-09. Newer versions may differ and were not tested by us.\n\n```\n{\n  \"mcpServers\": {\n    \"firecrawl\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"firecrawl-mcp@3.38.0\"\n      ],\n      \"env\": {\n        \"FIRECRAWL_API_KEY\": \"<your key>\"\n      }\n    }\n  }\n}\n```\n\n## Tools listed\n\n`firecrawl_agent`, `firecrawl_agent_status`, `firecrawl_check_crawl_status`, `firecrawl_crawl`, `firecrawl_credit_usage`, `firecrawl_developer_search`, `firecrawl_find_tools`, `firecrawl_gov_search`, `firecrawl_interact`, `firecrawl_interact_stop`, `firecrawl_map`, `firecrawl_monitor_check`, `firecrawl_monitor_checks`, `firecrawl_monitor_create`, `firecrawl_monitor_delete`, `firecrawl_monitor_get`, `firecrawl_monitor_list`, `firecrawl_monitor_run`, `firecrawl_monitor_update`, `firecrawl_parse`, `firecrawl_research_inspect_paper`, `firecrawl_research_read_paper`, `firecrawl_research_related_papers`, `firecrawl_research_search_papers`, `firecrawl_scrape`, `firecrawl_search`\n\nTool history: captured Nov 11, 2026. [All tool history](https://testedmcp.com/changes/).\n\n## Quick config\n\n```\n{\n  \"mcpServers\": {\n    \"firecrawl\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"firecrawl-mcp\"\n      ],\n      \"env\": {\n        \"FIRECRAWL_API_KEY\": \"<your key>\"\n      }\n    }\n  }\n}\n```\n\n**API key:** optional — set `FIRECRAWL_API_KEY` in `env` (replace `<your key>`). firecrawl_scrape and firecrawl_search ran without a key in our 2026-11-09 tests (rate-limited per IP); other tools need FIRECRAWL_API_KEY. \n\n[Add to config](https://testedmcp.com/free-tools/mcp-config-generator/?s=firecrawl) Opens the config generator with this server selected.\n\n## Setup\n\nEnv var seen in our test: `FIRECRAWL_API_KEY`\n\n1. **Install.** Run`npm install firecrawl-mcp` (Node 20). This is the exact command we ran on 2026-11-09.\n2. **Configure.** Add the mcpServers entry below to your MCP client config and set FIRECRAWL_API_KEY.\n3. **Verify.** Restart the client and check that tools/list returns tools (26 in our test).\n\n```\n{\n  \"mcpServers\": {\n    \"firecrawl\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"firecrawl-mcp\"\n      ],\n      \"env\": {\n        \"FIRECRAWL_API_KEY\": \"<your key>\"\n      }\n    }\n  }\n}\n```\n\n## Test history\n\n- 2026-11-09: Retested\n- 2026-11-09: Tools changed (breaking)\n- 2026-10-22: New\n\nRelated: [Best web search MCP servers](https://testedmcp.com/best/web-search-mcp-servers/)\n\n## FAQ\n\n### Is Firecrawl deprecated?\n\nNo. firecrawl-mcp was not deprecated or archived when we last tested it on 2026-11-09.\n\n### What replaces Firecrawl?\n\nNothing; Firecrawl (official) is not deprecated as of 2026-11-09.\n\n### Does Firecrawl need an API key?\n\nfirecrawl_scrape and firecrawl_search ran without a key in our 2026-11-09 tests (rate-limited per IP); other tools need FIRECRAWL_API_KEY. It completed an MCP handshake with no credentials and listed 26 tools.\n\n## Embed the badge\n\nEvery tested server gets a free embeddable badge. It shows the current score and test date and expires after 90 days. Testing is free; payment never changes a score.", "url": "https://wpnews.pro/news/tools-changed-breaking-firecrawl-official", "canonical_source": "https://testedmcp.com/tools/firecrawl/#tool-changes", "published_at": "2026-11-09 00:00:00+00:00", "updated_at": "2026-11-12 14:23:37.777357+00:00", "lang": "en", "topics": ["ai-agents", "agent-protocols", "developer-tools", "ai-tools"], "entities": ["Firecrawl", "firecrawl-mcp", "npm", "firecrawl_scrape", "firecrawl_search", "firecrawl_map"], "also_reported_by": [], "takeaway": "Firecrawl's MCP server 3.38.0 exposes 26 tools at an estimated 11,825 cl100k tokens, but only firecrawl_scrape and firecrawl_search work without an API key — firecrawl_map and the other 23 tools require one.", "recommendation": null, "alternates": {"html": "https://wpnews.pro/news/tools-changed-breaking-firecrawl-official", "markdown": "https://wpnews.pro/news/tools-changed-breaking-firecrawl-official.md", "text": "https://wpnews.pro/news/tools-changed-breaking-firecrawl-official.txt", "jsonld": "https://wpnews.pro/news/tools-changed-breaking-firecrawl-official.jsonld"}}