Skip to content

Docs: sync README with the actual tools and install methods#272

Open
rakshith48 wants to merge 2 commits into
firecrawl:mainfrom
rakshith48:docs/readme-sync-with-code
Open

Docs: sync README with the actual tools and install methods#272
rakshith48 wants to merge 2 commits into
firecrawl:mainfrom
rakshith48:docs/readme-sync-with-code

Conversation

@rakshith48

@rakshith48 rakshith48 commented Jun 9, 2026

Copy link
Copy Markdown

The README had drifted from both the code and the docs. I verified the registered tools and their availability guards against src/ on main (v3.20.4) and brought the README in line with what the hosted MCP actually exposes.

Tools

  • Removed firecrawl_batch_scrape + firecrawl_check_batch_statusnot registered in the code (only in prose / src/legacy/). Also cleaned up stale batch_scrape prose references.
  • Removed the firecrawl_extract section (per product direction).
  • Added real-but-undocumented tools, with correct availability:
    • firecrawl_parseself-hosted only (registered only when CLOUD_SERVICE !== 'true'; needs FIRECRAWL_API_URL).
    • firecrawl_interact / firecrawl_interact_stop.
    • firecrawl_research_*experimental / opt-in (FIRECRAWL_RESEARCH=true or ?research=true); not on the standard hosted MCP.
  • Renumbered the Available Tools sections and refreshed the quick-reference table + "How to Choose a Tool".

Install & params

  • Added the remote hosted URL (https://mcp.firecrawl.dev/{KEY}/v2/mcp) and Claude Code / Google Antigravity / n8n sections.
  • Fixed the local Streamable HTTP path /mcp/v2/mcp.
  • Fixed crawl maxDepthmaxDiscoveryDepth; modernized search params (lang/countrylocation/sources).
  • Features: "SSE support" → "Streamable HTTP support"; added monitor + research bullets.

Note for maintainers

The published docs at docs.firecrawl.dev/mcp-server still list a browser-session suite (firecrawl_browser_create/execute/delete/list) that is not in the code — looks like a docs bug (flagging separately; not touched here).

🤖 Generated with Claude Code

rakshith48 and others added 2 commits June 9, 2026 22:25
The README had drifted from the code and the docs. Verified the registered
tools against src/ (server.addTool) on main and reconciled both.

Tools:
- Remove firecrawl_batch_scrape / firecrawl_check_batch_status — not
  registered in the code (only referenced in prose / legacy).
- Add firecrawl_parse (local-file parse via self-hosted /v2/parse),
  firecrawl_interact, firecrawl_interact_stop, and the firecrawl_research_*
  suite (arXiv + GitHub, gated on research access) — all present in code,
  previously undocumented.
- Renumber the Available Tools sections and refresh the quick-reference
  table and "How to Choose a Tool" guidance.

Install & params:
- Add the remote hosted URL (https://mcp.firecrawl.dev/{KEY}/v2/mcp) plus
  Claude Code, Google Antigravity, and n8n sections.
- Fix the local Streamable HTTP path /mcp -> /v2/mcp.
- Fix crawl maxDepth -> maxDiscoveryDepth; modernize search params
  (lang/country -> location/sources).
- Features: "SSE support" -> "Streamable HTTP support"; add monitor +
  research bullets.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
…ntal

- Remove the firecrawl_extract tool section + table row (per product direction).
- Parse: clarify it is self-hosted only (registered only when CLOUD_SERVICE != true).
- Research: reframe as experimental/opt-in (FIRECRAWL_RESEARCH=true or ?research=true);
  not exposed on the standard hosted MCP.
- Remove remaining stale batch_scrape prose references.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant