Skip to content

docs(mcp): bring MCP docs up to date with Firecrawl MCP v3 - #1804

Merged
micahstairs merged 3 commits into
mainfrom
claude/mcp-v3-docs
Nov 18, 2026
Merged

micahstairs merged 3 commits into
mainfrom
claude/mcp-v3-docs

Conversation

@claude

@claude claude Bot commented Nov 18, 2026 •

Copy link
Copy Markdown
Contributor

Requested by Max Kelly · Slack thread

Before: The Tools page still sent Alexandria through firecrawl_find_tools then firecrawl_scrape with alexandria, left out alexandria_library_search, alexandria_library_read, people_company_search, people_company_enrich and firecrawl_credit_usage, and still recommended the scrape JSON format, which firecrawl_scrape stopped advertising in 3.39.0. Local and quickstart examples pinned firecrawl-mcp@3.33.2 / 3.33.4, and four pages used an unpinned npx -y firecrawl-mcp.

After: The Tools page matches the live hosted tool list (see below), and every English firecrawl-mcp example pins 3.40.0, the latest npm release. Get Started, For Agents and For Humans are unchanged: an earlier revision added a "What's new in v3" section with rate-limit and usage claims. Review dropped it because the rate-limit and usage increases may apply to everyone, not just MCP v3.

How: changed files are mcp-server/tools.mdx (tool table, Alexandria accordion, a new people/company accordion, the Extract note), mcp-server/local.mdx (pin), features/alexandria.mdx and use-cases/sports-fantasy.mdx (MCP tab tool names), migrating-from-extract.mdx (MCP step), version pins in developer-guides/llm-sdks-and-frameworks/google-adk.mdx, developer-guides/mcp-setup-guides/{dyad,factory-ai}.mdx and quickstarts/{ai-sdk-mcp,jetbrains-ai-assistant,kimi-code,pi,qodo,rovo-dev-cli,visual-studio,zencoder}.mdx, and reviewed_mcp_version in scripts/check-hosted-mcp-docs.sh (was 3.23.7). Following CLAUDE.md, I left localized files alone. Tool names and parameters come from firecrawl-mcp-server at the 3.40.0 release commit 07d49d8 (#709).

Checks: check-extraction-hostile-markdown.sh and its selftest pass, the locale-literals selftest passes, and docs.json parses. check-locale-api-literals.sh fails with the same output on main (localized zh pages), so this PR adds nothing there. mint broken-links finds 185 broken links on main already, and none of them are in the files this PR changes. check-hosted-mcp-docs.sh (not in CI) already fails on main. This PR fixes the 15 version-pin failures in it and adds no new ones. The failures that remain have nothing to do with this change, for example the Get Started ## Add an API key heading, the selector client list now including droid, and the localized nav groups.

Hosted server vs. 3.40.0

The hosted server already runs firecrawl-mcp-server changes from after the 3.40.0 tag. An authenticated tools/list on https://mcp.firecrawl.dev/v2/mcp (read through Firebrain's firecrawl_vendor_catalog) returns 38 tools, including jobs_search, firecrawl_save_skill and firecrawl_research_lookup_protein, and no longer lists firecrawl_find_tools. Tool descriptions come back trimmed, so the deploy includes at least 9a655db (#719). The Tools page now lists jobs_search and firecrawl_save_skill, notes that these and the protein lookup are not in the 3.40.0 npm release, and says firecrawl_find_tools and the firecrawl_scrape alexandria body are unlisted but still answer. The keyless tools/list returns firecrawl_scrape, firecrawl_search and firecrawl_parse, as documented. serverInfo.version still reads 3.40.0 because package.json hasn't been bumped since the tag.


Generated by Claude Code

- Get Started: add a v3 callout and a "What's new in v3" section (3,000+
  tools, provider waterfalls, higher rate limits, daily MCP usage,
  subtasks). Server URLs are unchanged.
- For Agents / For Humans: one line pointing authenticated connections
  at the v3 features.
- Tools: Alexandria now runs through alexandria_library_search and
  alexandria_library_read; add people_company_search,
  people_company_enrich and firecrawl_credit_usage; replace the
  JSON-format scrape row, which firecrawl_scrape no longer advertises.
- Pin firecrawl-mcp examples to 3.40.0 (latest npm release) and bump the
  reviewed version in check-hosted-mcp-docs.sh to match.
- Alexandria and sports use-case MCP tabs and the Extract migration
  prompt name the current tools.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01UMyPLF8KU6aHqxCt4TosNJ
@mintlify

mintlify Bot commented Nov 18, 2026 •

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated
firecrawl 🟢 Ready View Preview Nov 18, 2026, 8:53 PM

💡 Tip: Enable Automations to automatically generate PRs for you.

- Get Started: keep the free daily MCP allowance, drop the claim that
  it is used before plan credits.
- Tools: add jobs_search and firecrawl_save_skill, now live on the
  hosted server (confirmed via an authenticated tools/list: 38 tools,
  firecrawl_find_tools no longer listed). Note that these and
  firecrawl_research_lookup_protein are not in firecrawl-mcp 3.40.0.
- Alexandria: /library/skills, nextTool for retained results, and
  firecrawl_find_tools / scrape alexandria body unlisted but still
  answering.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01UMyPLF8KU6aHqxCt4TosNJ
@claude
claude Bot marked this pull request as ready for review November 18, 2026 20:41
Remove the v3 callout and section (rate-limit and usage claims) from
mcp-server.mdx and the one-line v3 links from keyless.mdx and oauth.mdx.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01UMyPLF8KU6aHqxCt4TosNJ
@micahstairs
micahstairs merged commit 05bcecf into main Nov 18, 2026
4 checks passed

This branch was successfully deployed

1 active deployment
staging — 2b4897a4 Deployed Nov 18, 2026 by mintlify[bot]
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.

2 participants