v1.0.0 — ShantyCrawl MCP

🚀 v1.0.0 — ShantyCrawl MCP

Firecrawl with a chill token footprint. A drop-in replacement for firecrawl-mcp that saves ~18,000 tokens per session by lazy-loading 22 advanced tools.

✨ Since v0.5.2

🎯 Implicit Tool Activation (The Big One)

Advanced tools now auto-activate on first use — call map directly without tool_enable and it works for that call, then auto-deactivates. Explicit tool_enable still persists until tool_disable. Best of both worlds: zero friction for one-off use, full control for heavy sessions.

🔧 Monitor Tools — v2 API Compliance

• monitor_create body format updated to Firecrawl v2 (targets: [{type:"scrape", urls: [...]}], schedule: {text|cron})
• monitor_update now has a dedicated buildBody mapper — no more raw-arg fallback

🧪 Full Test Suite

10 test files covering: smoke test, state persistence, activation lifecycle, prompts, error handling, scrape, search, crawl, advanced tools, and monitor CRUD. Zero external test frameworks — pure JSON-RPC over stdio.

🤖 CodeRabbit Automation

• scripts/coderabbit-loop.ts polls PR issues for early green light (avoids waiting for full review)
• Infinite loop bug in the polling logic fixed
• Enforced green-light rule before merge

🧹 And More

• Zero third-party wrappers — native fetch, pure TypeScript
• FIRECRAWL_API_URL auto-detects local vs cloud from FIRECRAWL_API_KEY presence
• All routes target Firecrawl v2 API

🔌 Quick Start

FIRECRAWL_API_URL=http://localhost:3002 npx shantycrawl-mcp

⚙️ Claude Desktop

{
  "mcpServers": {
    "shantycrawl": {
      "command": "npx",
      "args": ["shantycrawl-mcp"],
      "env": { "FIRECRAWL_API_URL": "http://localhost:3002" }
    }
  }
}

📦 Install

npm install -g shantycrawl-mcp

🙏 Special Thanks

To the Firecrawl team for the excellent API, and to everyone who beta-tested the 0.x releases.

---

Full changelog: v0.5.2...v1.0.0