Skip to content

Conversation

devin-ai-integration[bot]
Copy link
Contributor

@devin-ai-integration devin-ai-integration bot commented Sep 27, 2025

Fix MCP server documentation to match V2 implementation

Summary

Updated the Firecrawl MCP server documentation to better align with the V2 implementation:

  • Added missing firecrawl_map tool that was implemented but not documented
  • Removed deprecated tools firecrawl_deep_research and firecrawl_generate_llmstxt that were removed in V2
  • Kept batch scrape tools (firecrawl_batch_scrape and firecrawl_check_batch_status) even though not yet implemented in V2
  • Renumbered tools 1-8 to maintain proper sequence after additions/removals

Review & Testing Checklist for Human

  • Verify batch scrape tool documentation strategy - These tools are documented but not implemented in V2. Confirm this is the intended approach vs removing them entirely.
  • Test tool examples and JSON schemas - Validate that all documented tool examples use correct parameter names and schemas that match the actual MCP server implementation.
  • Confirm V2 deprecation strategy - Verify that removing firecrawl_deep_research and firecrawl_generate_llmstxt aligns with the planned V2 migration path and user communication.
  • Validate map tool documentation - Check that the new firecrawl_map tool documentation accurately reflects the actual implementation parameters and behavior.

Notes

This PR addresses a documentation audit request to fix discrepancies between docs and implementation. The main complexity was handling batch scrape tools that are referenced in implementation tool descriptions but not actually implemented as separate tools in V2.

Requested by: Micah Stairs (@micahstairs)
Devin session: https://app.devin.ai/sessions/740f321c754f41368f58d12cce70eb9c

- Remove deprecated tools: deep_research, generate_llmstxt, batch_scrape, check_batch_status
- Add missing firecrawl_map tool documentation
- Update features list to remove 'Deep research and batch scraping'
- Renumber tools to reflect actual 6 tools in V2 implementation

Co-Authored-By: Micah Stairs <[email protected]>
Copy link
Contributor Author

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

  • Address comments on this PR. Add '(aside)' to your comment to have me ignore it.
  • Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

  • Disable automatic comment and CI monitoring

- Add back firecrawl_batch_scrape and firecrawl_check_batch_status tools
- Keep firecrawl_map tool that was missing from original docs
- Update features list to include 'Deep research and batch scraping'
- Documentation now shows all 8 tools (6 implemented + 2 planned)
- Renumber tools 1-8 to maintain proper sequence

Co-Authored-By: Micah Stairs <[email protected]>
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