firecrawl-mcp 3.19.1 → 3.20.1

package/README.md

@@ -18,7 +18,6 @@ A Model Context Protocol (MCP) server that brings [Firecrawl](https://github.com
 - Scrape any URL into clean, structured data
 - Interact with pages — click, navigate, and operate
 - Deep research with autonomous agent
-- Cloud browser sessions with agent-browser automation
 - Automatic retries and rate limiting
 - Cloud and self-hosted support
 - SSE support
@@ -328,7 +327,6 @@ Use this guide to select the right tool for your task:
 - **If you need complex research across multiple unknown sources:** use **agent**
 - **If you want to analyze a whole site or section:** use **crawl** (with limits!)
 - **If you need interactive browser automation** (click, type, navigate): use **scrape** + **interact**
-- **If you need a raw CDP browser session** (advanced): use **browser** (deprecated)
 
 ### Quick Reference Table
 
@@ -341,7 +339,6 @@ Use this guide to select the right tool for your task:
 | crawl        | Multi-page extraction (with limits)            | markdown/html[]                |
 | search       | Web search for info                            | results[]                      |
 | agent        | Complex multi-source research                  | JSON (structured data)         |
-| browser      | Interactive multi-step automation (deprecated) | Session with live browser      |
 
 ### Format Selection Guide
 
@@ -940,111 +937,6 @@ Pass `body` when you need crawl targets, JSON change tracking, custom retention,
 - `firecrawl_monitor_checks`: list checks, optionally filtered by status.
 - `firecrawl_monitor_check`: get page-level results, including `diff`, `snapshot`, `judgment.meaningful`, and `judgment.meaningfulChanges`.
 
-### 12. Browser Create (`firecrawl_browser_create`) — Deprecated
-
-> **Deprecated:** Prefer `firecrawl_scrape` + `firecrawl_interact` instead. Interact lets you scrape a page and then click, fill forms, and navigate without managing sessions manually.
-
-Create a cloud browser session for interactive automation.
-
-**Arguments:**
-
-- `ttl`: Total session lifetime in seconds (30-3600, optional)
-- `activityTtl`: Idle timeout in seconds (10-3600, optional)
-- `streamWebView`: Whether to enable live view streaming (optional)
-- `profile`: Save and reuse browser state across sessions (optional)
-  - `name`: Profile name (sessions with the same name share state)
-  - `saveChanges`: Whether to save changes back to the profile (default: true)
-
-**Usage Example:**
-
-```json
-{
-  "name": "firecrawl_browser_create",
-  "arguments": {
-    "ttl": 600,
-    "profile": { "name": "my-profile", "saveChanges": true }
-  }
-}
-```
-
-**Returns:**
-
-- Session ID, CDP URL, and live view URL
-
-### 13. Browser Execute (`firecrawl_browser_execute`) — Deprecated
-
-> **Deprecated:** Prefer `firecrawl_scrape` + `firecrawl_interact` instead.
-
-Execute code in a browser session. Supports agent-browser commands (bash), Python, or JavaScript.
-
-**Recommended: Use bash with agent-browser commands** (pre-installed in every sandbox):
-
-```json
-{
-  "name": "firecrawl_browser_execute",
-  "arguments": {
-    "sessionId": "session-id-here",
-    "code": "agent-browser open https://example.com",
-    "language": "bash"
-  }
-}
-```
-
-**Common agent-browser commands:**
-
-| Command                         | Description                            |
-| ------------------------------- | -------------------------------------- |
-| `agent-browser open <url>`      | Navigate to URL                        |
-| `agent-browser snapshot`        | Accessibility tree with clickable refs |
-| `agent-browser click @e5`       | Click element by ref from snapshot     |
-| `agent-browser type @e3 "text"` | Type into element                      |
-| `agent-browser get title`       | Get page title                         |
-| `agent-browser screenshot`      | Take screenshot                        |
-| `agent-browser --help`          | Full command reference                 |
-
-**For Playwright scripting, use Python:**
-
-```json
-{
-  "name": "firecrawl_browser_execute",
-  "arguments": {
-    "sessionId": "session-id-here",
-    "code": "await page.goto('https://example.com')\ntitle = await page.title()\nprint(title)",
-    "language": "python"
-  }
-}
-```
-
-### 14. Browser List (`firecrawl_browser_list`) — Deprecated
-
-> **Deprecated:** Prefer `firecrawl_scrape` + `firecrawl_interact` instead.
-
-List browser sessions, optionally filtered by status.
-
-```json
-{
-  "name": "firecrawl_browser_list",
-  "arguments": {
-    "status": "active"
-  }
-}
-```
-
-### 15. Browser Delete (`firecrawl_browser_delete`) — Deprecated
-
-> **Deprecated:** Prefer `firecrawl_scrape` + `firecrawl_interact` instead.
-
-Destroy a browser session.
-
-```json
-{
-  "name": "firecrawl_browser_delete",
-  "arguments": {
-    "sessionId": "session-id-here"
-  }
-}
-```
-
 ## Logging System
 
 The server includes comprehensive logging:

package/dist/index.js

@@ -187,7 +187,15 @@ const server = new FastMCP({
         protectedResourceMetadataUrl: getOAuthProtectedResourceMetadataUrl(),
     },
     authenticate: async (request) => {
-        const headerCred = await resolveCredentialFromHeaders(request.headers);
+        // FastMCP invokes `authenticate(undefined)` for the stdio transport
+        // because there is no HTTP request context. Without this null guard,
+        // accessing `request.headers` throws a TypeError, FastMCP silently
+        // swallows it, and every subsequent tool call fails with
+        // "Unauthorized: API key is required when not using a self-hosted
+        // instance" even though `FIRECRAWL_API_KEY` is set in env.
+        const headerCred = request?.headers
+            ? await resolveCredentialFromHeaders(request.headers)
+            : undefined;
         const envCred = resolveCredentialFromEnv();
         if (process.env.CLOUD_SERVICE === 'true') {
             if (!headerCred) {
@@ -1203,204 +1211,6 @@ Check the status of an agent job and retrieve results when complete. Use this to
         return asText(res);
     },
 });
-// Browser session tools (deprecated — prefer firecrawl_scrape + firecrawl_interact)
-server.addTool({
-    name: 'firecrawl_browser_create',
-    annotations: {
-        title: 'Create browser session',
-        readOnlyHint: false,
-        openWorldHint: false,
-        destructiveHint: false,
-    },
-    description: `
-**DEPRECATED — prefer firecrawl_scrape + firecrawl_interact instead.** Interact lets you scrape a page and then click, fill forms, and navigate without managing sessions manually.
-
-Create a browser session for code execution via CDP (Chrome DevTools Protocol).
-
-**Arguments:**
-- ttl: Total session lifetime in seconds (30-3600, optional)
-- activityTtl: Idle timeout in seconds (10-3600, optional)
-- streamWebView: Whether to enable live view streaming (optional)
-- profile: Save and reuse browser state (cookies, localStorage) across sessions (optional)
-  - name: Profile name (sessions with the same name share state)
-  - saveChanges: Whether to save changes back to the profile (default: true)
-
-**Usage Example:**
-\`\`\`json
-{
-  "name": "firecrawl_browser_create",
-  "arguments": {
-    "profile": { "name": "my-profile", "saveChanges": true }
-  }
-}
-\`\`\`
-**Returns:** Session ID, CDP URL, and live view URL.
-`,
-    parameters: z.object({
-        ttl: z.number().min(30).max(3600).optional(),
-        activityTtl: z.number().min(10).max(3600).optional(),
-        streamWebView: z.boolean().optional(),
-        profile: z
-            .object({
-            name: z.string().min(1).max(128),
-            saveChanges: z.boolean().default(true),
-        })
-            .optional(),
-    }),
-    execute: async (args, { session, log }) => {
-        const client = getClient(session);
-        const a = args;
-        const cleaned = removeEmptyTopLevel(a);
-        log.info('Creating browser session');
-        const res = await client.browser(cleaned);
-        return asText(res);
-    },
-});
-if (!SAFE_MODE) {
-    server.addTool({
-        name: 'firecrawl_browser_execute',
-        annotations: {
-            title: 'Run code in browser session',
-            readOnlyHint: false,
-            openWorldHint: false,
-            destructiveHint: true,
-        },
-        description: `
-**DEPRECATED — prefer firecrawl_scrape + firecrawl_interact instead.** Interact lets you scrape a page and then click, fill forms, and navigate without managing sessions manually.
-
-Execute code in a browser session. Supports agent-browser commands (bash), Python, or JavaScript.
-**Requires:** An active browser session (create one with firecrawl_browser_create first).
-
-**Arguments:**
-- sessionId: The browser session ID (required)
-- code: The code to execute (required)
-- language: "bash", "python", or "node" (optional, defaults to "bash")
-
-**Recommended: Use bash with agent-browser commands** (pre-installed in every sandbox):
-\`\`\`json
-{
-  "name": "firecrawl_browser_execute",
-  "arguments": {
-    "sessionId": "session-id-here",
-    "code": "agent-browser open https://example.com",
-    "language": "bash"
-  }
-}
-\`\`\`
-
-**Common agent-browser commands:**
-- \`agent-browser open <url>\` — Navigate to URL
-- \`agent-browser snapshot\` — Get accessibility tree with clickable refs (for AI)
-- \`agent-browser snapshot -i -c\` — Interactive elements only, compact
-- \`agent-browser click @e5\` — Click element by ref from snapshot
-- \`agent-browser type @e3 "text"\` — Type into element
-- \`agent-browser fill @e3 "text"\` — Clear and fill element
-- \`agent-browser get text @e1\` — Get text content
-- \`agent-browser get title\` — Get page title
-- \`agent-browser get url\` — Get current URL
-- \`agent-browser screenshot [path]\` — Take screenshot
-- \`agent-browser scroll down\` — Scroll page
-- \`agent-browser wait 2000\` — Wait 2 seconds
-- \`agent-browser --help\` — Full command reference
-
-**For Playwright scripting, use Python** (has proper async/await support):
-\`\`\`json
-{
-  "name": "firecrawl_browser_execute",
-  "arguments": {
-    "sessionId": "session-id-here",
-    "code": "await page.goto('https://example.com')\\ntitle = await page.title()\\nprint(title)",
-    "language": "python"
-  }
-}
-\`\`\`
-
-**Note:** Prefer bash (agent-browser) or Python.
-**Returns:** Execution result including stdout, stderr, and exit code.
-`,
-        parameters: z.object({
-            sessionId: z.string(),
-            code: z.string(),
-            language: z.enum(['bash', 'python', 'node']).optional(),
-        }),
-        execute: async (args, { session, log }) => {
-            const client = getClient(session);
-            const { sessionId, code, language } = args;
-            log.info('Executing code in browser session', { sessionId });
-            const res = await client.browserExecute(sessionId, { code, language });
-            return asText(res);
-        },
-    });
-}
-server.addTool({
-    name: 'firecrawl_browser_delete',
-    annotations: {
-        title: 'Delete browser session',
-        readOnlyHint: false,
-        openWorldHint: false,
-        destructiveHint: true,
-    },
-    description: `
-**DEPRECATED — prefer firecrawl_scrape + firecrawl_interact instead.**
-
-Destroy a browser session.
-
-**Usage Example:**
-\`\`\`json
-{
-  "name": "firecrawl_browser_delete",
-  "arguments": {
-    "sessionId": "session-id-here"
-  }
-}
-\`\`\`
-**Returns:** Success confirmation.
-`,
-    parameters: z.object({
-        sessionId: z.string(),
-    }),
-    execute: async (args, { session, log }) => {
-        const client = getClient(session);
-        const { sessionId } = args;
-        log.info('Deleting browser session', { sessionId });
-        const res = await client.deleteBrowser(sessionId);
-        return asText(res);
-    },
-});
-server.addTool({
-    name: 'firecrawl_browser_list',
-    annotations: {
-        title: 'List browser sessions',
-        readOnlyHint: true,
-        openWorldHint: false,
-    },
-    description: `
-**DEPRECATED — prefer firecrawl_scrape + firecrawl_interact instead.**
-
-List browser sessions, optionally filtered by status.
-
-**Usage Example:**
-\`\`\`json
-{
-  "name": "firecrawl_browser_list",
-  "arguments": {
-    "status": "active"
-  }
-}
-\`\`\`
-**Returns:** Array of browser sessions.
-`,
-    parameters: z.object({
-        status: z.enum(['active', 'destroyed']).optional(),
-    }),
-    execute: async (args, { session, log }) => {
-        const client = getClient(session);
-        const { status } = args;
-        log.info('Listing browser sessions', { status });
-        const res = await client.listBrowsers({ status });
-        return asText(res);
-    },
-});
 // Interact tools (scrape-bound browser sessions)
 server.addTool({
     name: 'firecrawl_interact',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "firecrawl-mcp",
-  "version": "3.19.1",
+  "version": "3.20.1",
   "description": "MCP server for Firecrawl — search, scrape, and interact with the web. Supports both cloud and self-hosted instances. Features include web search, scraping, page interaction, batch processing, and LLM-powered content analysis.",
   "type": "module",
   "mcpName": "io.github.firecrawl/firecrawl-mcp-server",