What's Changed

• (feat/versioning) Support for v1 and v2 by @nickscamara in #90
• fix: wrap safeLogs outside of try-catch and name anon functions for better debugging by @mogery in #92
• Fastmcp by @tomkosm in #97

New Contributors

• @mogery made their first contribution in #92

Full Changelog: v2.0.0...v3.0.0

What's Changed

• Updated to Firecrawl v2 API and added Streamable HTTP

Full Changelog: v1.12.0...v2.0.0

What's Changed

• Fix the path in dockerfile and also smithery by @vrknetha in #32
• refactor: General improvements by @ftonato in #33
• Klavis AI Firecrawl hosting. by @xiangkaiz in #42
• Feat sse+remote by @tomkosm in #45
• fix: add missing server listen call in SSE mode by @CodeDuckky in #46
• Add VS Code installation instructions by @burkeholland in #35
• Add collaborator Zihao for hosting the MCP server in Klavis AI. by @xiangkaiz in #43
• changes company name by @vrknetha in #62
• Enhance README.md and index.ts with detailed tool descriptions by @rafaelsideguide in #61
• Implement maxAge fast scraping parameter by @devin-ai-integration in #73

New Contributors

• @ftonato made their first contribution in #33
• @xiangkaiz made their first contribution in #42
• @tomkosm made their first contribution in #45
• @CodeDuckky made their first contribution in #46
• @burkeholland made their first contribution in #35
• @rafaelsideguide made their first contribution in #61
• @devin-ai-integration made their first contribution in #73

Full Changelog: v1.7.2...v1.12.0

What's Changed

• (feat/llms-txt) Generate LLMs txt tool by @nickscamara in #23
• Fix stdio logging issue by @vrknetha in #24

New Contributors

• @nickscamara made their first contribution in #23

Full Changelog: v1.4.1...v1.7.2

• Added Deep Research Tool

Full Changelog: v.1.3.3...v1.4.1

Introducing the Official Firecrawl MCP Server 📡

Give web scraping abilities to Cursor, Claude Desktop and more.

env FIRECRAWL_API_KEY=YOUR_KEY npx -y firecrawl-mcp

Overview

This release adds environment variable configuration support and enhances documentation, making the server more flexible and easier to configure.

🔧 Configuration Updates

New Environment Variables

• Retry Configuration:
  • FIRE_CRAWL_RETRY_MAX_ATTEMPTS (default: 3)
  • FIRE_CRAWL_RETRY_INITIAL_DELAY (default: 1000ms)
  • FIRE_CRAWL_RETRY_MAX_DELAY (default: 10000ms)
  • FIRE_CRAWL_RETRY_BACKOFF_FACTOR (default: 2)
• Credit Monitoring:
  • FIRE_CRAWL_CREDIT_WARNING_THRESHOLD (default: 1000)
  • FIRE_CRAWL_CREDIT_CRITICAL_THRESHOLD (default: 100)

📚 Documentation Improvements

• Added comprehensive configuration examples
• Enhanced retry behavior documentation with timing examples
• Improved credit monitoring documentation
• Updated Claude Desktop configuration guide

💡 Example Usage

Cloud API with custom retry settings

export FIRE_CRAWL_API_KEY=your-api-key
export FIRE_CRAWL_RETRY_MAX_ATTEMPTS=5
export FIRE_CRAWL_RETRY_INITIAL_DELAY=2000

Self-hosted with custom credit thresholds

export FIRE_CRAWL_API_URL=https://firecrawl.your-domain.com
export FIRE_CRAWL_CREDIT_WARNING_THRESHOLD=2000

🔍 Technical Details

• All configuration options now support environment variable overrides
• Maintained backward compatibility with default values
• Enhanced error messages for configuration validation

📋 Full Changelog

See CHANGELOG.md for complete details.

What's Changed

Improvements

• Removed redundant batch configuration to rely on FireCrawl library's built-in functionality
• Simplified batch processing logic by leveraging library's native implementation
• Optimized parallel processing and rate limiting handling
• Reduced code complexity and potential configuration conflicts

Technical Details

• Removed custom CONFIG.batch settings:
  • Removed maxParallelOperations configuration
  • Removed delayBetweenRequests configuration
• Simplified batch operation processing to use library's built-in batch handling
• Updated server startup logging to remove batch configuration references
• Maintained credit usage tracking and error handling functionality

Benefits

• More reliable batch processing using library's battle-tested implementation
• Better handling of rate limits and concurrent operations
• Reduced maintenance overhead
• Improved code maintainability

This release focuses on improving type safety and error handling in the FireCrawl MCP server.

Key Improvements

• Fixed type system warnings by properly implementing ExtractParams and ExtractResponse interfaces
• Enhanced type safety in extract operations with improved type guards
• Refined error messages for better configuration validation
• Fixed API response type casting issues

Technical Details

• Resolved unused TypeScript interface warnings
• Improved type inference in extract operations
• Enhanced type guards for better runtime validation
• Updated error message formatting for configuration issues

Compatibility

• Requires Node.js >= 18.0.0
• Compatible with @mendable/firecrawl-js ^1.16.0
• Compatible with @modelcontextprotocol/sdk ^1.4.1

FireCrawl MCP Server v1.2.1 - Binary Configuration Hotfix

Changes

• Fixed binary configuration in package.json to resolve npx execution issues
• Simplified package configuration for better CLI tool support
• Added proper file inclusions for npm package distribution
• Updated package scripts to ensure proper build during installation