# Tools changed (breaking): Firecrawl (official)

> Source: <https://testedmcp.com/tools/firecrawl/#tool-changes>
> Published: 2026-11-09 00:00:00+00:00

**Key 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.

# Firecrawl (official)

**90**/100

Capped 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)

Test 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)

Test points before the cap (100/100)

- Install20/20
- Handshake30/30
- Maintenance25/25
- Docs15/15
- License10/10

Retested 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).

Tool-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.

**Transport (tested 2026-11-09):** stdio

Tested version: 3.38.0 · tested 2026-11-09

Token-cost, context and security package checks shown here were measured on 3.33.4 (Oct 22).

**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.

## Permissions: 17 read, 9 write (state-changing), 0 unclassified · Auth: API key · Rate limit: unknown · Pricing unit: unknown

Auth: API key. Rate limit: unknown. Pricing unit: unknown.

- `firecrawl_agent` — write (state-changing)
- `firecrawl_agent_status` — read
- `firecrawl_check_crawl_status` — read
- `firecrawl_crawl` — write (state-changing)
- `firecrawl_credit_usage` — read
- `firecrawl_developer_search` — read
- `firecrawl_find_tools` — read
- `firecrawl_gov_search` — read
- `firecrawl_interact` — write (state-changing)
- `firecrawl_interact_stop` — write (state-changing)
- `firecrawl_map` — read
- `firecrawl_monitor_check` — read
- `firecrawl_monitor_checks` — read
- `firecrawl_monitor_create` — write (state-changing)
- `firecrawl_monitor_delete` — write (state-changing)
- `firecrawl_monitor_get` — read
- `firecrawl_monitor_list` — read
- `firecrawl_monitor_run` — write (state-changing)
- `firecrawl_monitor_update` — write (state-changing)
- `firecrawl_parse` — read
- `firecrawl_research_inspect_paper` — read
- `firecrawl_research_read_paper` — read
- `firecrawl_research_related_papers` — read
- `firecrawl_research_search_papers` — read
- `firecrawl_scrape` — write (state-changing)
- `firecrawl_search` — read

recorded env/README key names: FIRECRAWL_API_KEY

Score **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/)

Summary: Firecrawl (official) completed an MCP handshake without credentials and exposed 26 tools.

## Evidence summary

- Handshake
- pass
- Tools listed
- 26
- Context cost
- 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/)
Tool list changed 2026-11-09; count from 2026-11-11 capture
- API key
- No key needed for the tools we called
- Tested
- 2026-11-09

## Test results

| Test | Result | Points | Evidence | 
|---|---|---|---|
| install | pass | 20 | `npm install firecrawl-mcp` (Node 20, Linux) succeeded in 1s. | 
| handshake | pass | 30 | MCP `initialize` +`tools/list` over stdio succeeded with no credentials; 26 tools listed in 0.3s. | 
| maintenance | pass | 25 | Repo pushed 0 days before test; 7,787 GitHub stars. | 
| 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). | 
| license | pass | 10 | MIT (OSI-approved). | 

## Local-model readiness

Token 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).

Small-model friendly (schema heuristic, not a model result): **low**.

## Not tested

Small-model task runs: Not yet tested.

## What we tested and what we didn't

### Tested on 2026-11-09

- Install from the registry
- We connected with no credentials and asked for its tool list: it listed 26 tools (Method details: MCP `initialize` then`tools/list` )
- Maintenance signals (last push, archived/deprecated status)
- Docs (README length, install and config example)
- License (OSI-approved or not)
- Token cost (estimate)

### Not tested

- Security: **not audited** (no code review, no permission or data-flow analysis)
- Real tasks (no functional task runs yet)
- Behaviour with real credentials or a real account
- Performance, rate limits or load
- Correctness of results beyond the listed tasks

Methodology: [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.

## Known security issues

Checked on 2026-11-09 for version `3.33.4` against OSV, GitHub advisories, GitHub repository advisories. Scope: the package itself; dependencies not scanned.

No 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.

⚠ Check is out of date.

Monthly roundup: [MCP security issues, October 2026](https://testedmcp.com/security/2026-10/).

## Tool list changes ↻ Tools changed (breaking) 2026-11-09

**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.

## Show the diff

- Added: `firecrawl_credit_usage`
- Added: `firecrawl_developer_search`
- Added: `firecrawl_find_tools`
- Added: `firecrawl_gov_search`
- Removed: `firecrawl_extract` (breaking)
- Removed: `firecrawl_feedback` (breaking)
- Removed: `firecrawl_research_search_github` (breaking)
- Removed: `firecrawl_search_feedback` (breaking)
- Changed schema: `firecrawl_agent`
- Changed schema: `firecrawl_agent_status`
- Changed schema: `firecrawl_check_crawl_status`
- Changed schema: `firecrawl_crawl`
- Changed schema: `firecrawl_interact`
- Changed schema: `firecrawl_interact_stop`
- Changed schema: `firecrawl_map`
- Changed schema: `firecrawl_monitor_check`
- Changed schema: `firecrawl_monitor_checks`
- Changed schema: `firecrawl_monitor_create`
- Changed schema: `firecrawl_monitor_delete`
- Changed schema: `firecrawl_monitor_get`
- Changed schema: `firecrawl_monitor_list`
- Changed schema: `firecrawl_monitor_run`
- Changed schema: `firecrawl_monitor_update`
- Changed schema: `firecrawl_parse`
- Changed schema: `firecrawl_research_inspect_paper`
- Changed schema: `firecrawl_research_read_paper`
- Changed schema: `firecrawl_research_related_papers`
- Changed schema: `firecrawl_research_search_papers`
- Changed schema: `firecrawl_scrape`
- Changed schema: `firecrawl_search` (breaking)

## Snapshot hash (fingerprint of the tool list)

`e8b7e02f0bb9`: SHA-256 of the canonical tool names, descriptions and input schemas. If it changes, the tool list changed.

## Raw test record (JSON)

```
{
  "name": "firecrawl-mcp",
  "version": "3.38.0",
  "registry": "npm",
  "status": "working",
  "tested": "2026-11-09",
  "tools_count": 26,
  "deprecated": false,
  "archived": false,
  "tests": {
    "install": [
      "pass",
      20,
      "`npm install firecrawl-mcp` (Node 20, Linux) succeeded in 1s."
    ],
    "handshake": [
      "pass",
      30,
      "MCP `initialize` + `tools/list` over stdio succeeded with no credentials; 26 tools listed in 0.3s."
    ],
    "maintenance": [
      "pass",
      25,
      "Repo pushed 0 days before test; 7,787 GitHub stars."
    ],
    "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)."
    ],
    "license": [
      "pass",
      10,
      "MIT (OSI-approved)."
    ]
  }
}
```

## Install

`npx -y firecrawl-mcp`

## Pin the version we tested

`npx -y firecrawl-mcp@3.38.0`

tested 2026-11-09. Newer versions may differ and were not tested by us.

```
{
  "mcpServers": {
    "firecrawl": {
      "command": "npx",
      "args": [
        "-y",
        "firecrawl-mcp@3.38.0"
      ],
      "env": {
        "FIRECRAWL_API_KEY": "<your key>"
      }
    }
  }
}
```

## Tools listed

`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`

Tool history: captured Nov 11, 2026. [All tool history](https://testedmcp.com/changes/).

## Quick config

```
{
  "mcpServers": {
    "firecrawl": {
      "command": "npx",
      "args": [
        "-y",
        "firecrawl-mcp"
      ],
      "env": {
        "FIRECRAWL_API_KEY": "<your key>"
      }
    }
  }
}
```

**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. 

[Add to config](https://testedmcp.com/free-tools/mcp-config-generator/?s=firecrawl) Opens the config generator with this server selected.

## Setup

Env var seen in our test: `FIRECRAWL_API_KEY`

1. **Install.** Run`npm install firecrawl-mcp` (Node 20). This is the exact command we ran on 2026-11-09.
2. **Configure.** Add the mcpServers entry below to your MCP client config and set FIRECRAWL_API_KEY.
3. **Verify.** Restart the client and check that tools/list returns tools (26 in our test).

```
{
  "mcpServers": {
    "firecrawl": {
      "command": "npx",
      "args": [
        "-y",
        "firecrawl-mcp"
      ],
      "env": {
        "FIRECRAWL_API_KEY": "<your key>"
      }
    }
  }
}
```

## Test history

- 2026-11-09: Retested
- 2026-11-09: Tools changed (breaking)
- 2026-10-22: New

Related: [Best web search MCP servers](https://testedmcp.com/best/web-search-mcp-servers/)

## FAQ

### Is Firecrawl deprecated?

No. firecrawl-mcp was not deprecated or archived when we last tested it on 2026-11-09.

### What replaces Firecrawl?

Nothing; Firecrawl (official) is not deprecated as of 2026-11-09.

### Does Firecrawl need an API 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. It completed an MCP handshake with no credentials and listed 26 tools.

## Embed the badge

Every 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.
