firecrawl-mcp 3.29.1 → 3.30.0

package/dist/server.js

@@ -80,7 +80,7 @@ var alexandriaSessionFeedbackSchema = z.strictObject({
 // src/server.ts
 import FirecrawlApp from "firecrawl";
 
-// node_modules/.pnpm/fastmcp@4.3.2_patch_hash=08f77b633292d9ae4cb022c0fa5bd722dbd5c1aaaad600204f8ed38339bfd37b/node_modules/fastmcp/dist/chunk-LWU5CQGW.js
+// node_modules/.pnpm/fastmcp@4.3.2_patch_hash=37f9a424ae5b0b6202b2b16109a1ea88b69cdcda5407f13eda6654a56489ad70/node_modules/fastmcp/dist/chunk-LWU5CQGW.js
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import {
@@ -884,6 +884,7 @@ ${error2 instanceof Error ? error2.stack : JSON.stringify(error2)}`
             // Top-level Tool.title (MCP 2025-06-18). Clients such as Codex index this
             // for tool search and do not read annotations.title.
             ...tool.annotations?.title && { title: tool.annotations.title },
+            ...tool.icons && { icons: tool.icons },
             description: tool.description,
             inputSchema: tool.parameters ? strictJsonSchema(await toJsonSchema(tool.parameters)) : {
               additionalProperties: false,
@@ -2059,7 +2060,7 @@ var FastMCP = class extends FastMCPEventEmitter {
   }
 };
 
-// node_modules/.pnpm/fastmcp@4.3.2_patch_hash=08f77b633292d9ae4cb022c0fa5bd722dbd5c1aaaad600204f8ed38339bfd37b/node_modules/fastmcp/dist/chunk-OJG4XYXA.js
+// node_modules/.pnpm/fastmcp@4.3.2_patch_hash=37f9a424ae5b0b6202b2b16109a1ea88b69cdcda5407f13eda6654a56489ad70/node_modules/fastmcp/dist/chunk-OJG4XYXA.js
 import { z as z3 } from "zod";
 import { createHmac as createHmac2, pbkdf2, randomBytes } from "crypto";
 import { promisify } from "util";
@@ -2072,45 +2073,6 @@ import { randomUUID as randomUUID2 } from "crypto";
 import path from "path";
 import { z as z12 } from "zod";
 
-// src/agent-hints.ts
-var AGENT_HINTS_HEADERS = { "X-Firecrawl-Agent-Hints": "true" };
-function readAgentHints(value) {
-  if (!value || typeof value !== "object") return void 0;
-  const hints = value.agent_hints;
-  return Array.isArray(hints) && hints.every((hint) => typeof hint === "string") ? hints : void 0;
-}
-function preserveAgentHints(data, envelope) {
-  const hints = readAgentHints(envelope);
-  if (!hints) return data;
-  return data && typeof data === "object" && !Array.isArray(data) ? { ...data, agent_hints: hints } : { data, agent_hints: hints };
-}
-function agentHintsText(hints) {
-  return `Firecrawl API agent_hints (response guidance, separate from page content):
-${JSON.stringify(hints, null, 2)}`;
-}
-function withAgentHints(result, response, separateText = false) {
-  const hints = readAgentHints(response);
-  if (!hints) return result;
-  return {
-    ...result,
-    content: separateText && hints.length ? [...result.content, { type: "text", text: agentHintsText(hints) }] : result.content,
-    structuredContent: { ...result.structuredContent, agent_hints: hints }
-  };
-}
-function readErrorAgentHints(error2) {
-  const hints = readAgentHints(error2);
-  if (hints) return hints;
-  if (!error2 || typeof error2 !== "object") return void 0;
-  const extras = error2.extras;
-  const extrasHints = readAgentHints(extras);
-  if (extrasHints) return extrasHints;
-  const details = error2.details;
-  const detailsHints = readAgentHints(details);
-  if (detailsHints) return detailsHints;
-  const response = error2.response;
-  return readAgentHints(response?.data);
-}
-
 // src/tool-output.ts
 import { z as z4 } from "zod";
 function isRecord(value) {
@@ -2139,9 +2101,6 @@ var unknown = (description) => z4.unknown().optional().describe(description);
 var success = bool("Whether the API call succeeded.");
 var error = unknown("Error message or error object when the call did not succeed.");
 var warning = str("Non-fatal warning about the result.");
-var agentHints = {
-  agent_hints: z4.array(z4.string()).optional().describe("Optional response guidance from the Firecrawl API.")
-};
 var alexandriaEnvelope = {
   requestId: str("Identifier of this Alexandria execution."),
   scrape_id: str("Identifier of the underlying scrape."),
@@ -2159,7 +2118,6 @@ var alexandriaEnvelope = {
   feedbackTool: unknown("Pointer to the feedback tool for reporting how this result served the task.")
 };
 var scrapeOutputSchema = z4.object({
-  ...agentHints,
   // URL mode: the scraped document, with the formats that were requested.
   markdown: str("Page content as markdown."),
   html: str("Processed HTML of the page."),
@@ -2191,7 +2149,6 @@ var scrapeOutputSchema = z4.object({
   ...alexandriaEnvelope
 }).describe("A scraped document, or the Alexandria execution envelope when `alexandria` was passed.");
 var mapOutputSchema = z4.object({
-  ...agentHints,
   links: unknown("URLs discovered under the website."),
   success,
   error,
@@ -2199,7 +2156,6 @@ var mapOutputSchema = z4.object({
   id: str("Identifier of the map run, for optional map feedback.")
 }).describe("URLs indexed under the requested website.");
 var searchOutputSchema = z4.object({
-  ...agentHints,
   success,
   data: unknown("Ranked results grouped by source, such as `web`, `news`, `images`, and `alexandria`."),
   error,
@@ -2211,14 +2167,12 @@ var searchOutputSchema = z4.object({
   feedbackTool: unknown("Pointer to the feedback tool for this search.")
 }).describe("Ranked search results grouped by source.");
 var findToolsOutputSchema = z4.object({
-  ...agentHints,
   success,
   data: unknown("Discovery page in `data.alexandria[0].data`, with `level`, `items`, `total`, and an optional `nextTool`."),
   error,
   ...alexandriaEnvelope
 }).describe("One page of the Alexandria catalogue: categories, providers, tools, or one contract.");
 var feedbackOutputSchema = z4.object({
-  ...agentHints,
   success,
   error,
   status: num("HTTP status when the submission was rejected."),
@@ -2237,7 +2191,6 @@ var feedbackOutputSchema = z4.object({
   raw: str("Response body when it was not JSON.")
 }).describe("Result of submitting feedback.");
 var crawlOutputSchema = z4.object({
-  ...agentHints,
   success,
   error,
   warning,
@@ -2252,7 +2205,6 @@ var crawlOutputSchema = z4.object({
   data: unknown("Scraped documents collected by the crawl.")
 }).describe("Crawl job state and the documents collected so far.");
 var agentOutputSchema = z4.object({
-  ...agentHints,
   success,
   error,
   id: str("Agent job identifier, for `firecrawl_agent_status`."),
@@ -2261,7 +2213,6 @@ var agentOutputSchema = z4.object({
   threadTurn: num("Turn number of this job within its thread.")
 }).describe("The queued research job. The result is read with `firecrawl_agent_status`.");
 var agentStatusOutputSchema = z4.object({
-  ...agentHints,
   success,
   error,
   id: str("Agent job identifier."),
@@ -2289,7 +2240,6 @@ var agentStatusOutputSchema = z4.object({
   )
 }).describe("Progress or final result of a research agent job.");
 var interactOutputSchema = z4.object({
-  ...agentHints,
   success,
   error: unknown("Why the interaction or the session could not run."),
   url: str("The URL the session was opened from, when opening failed."),
@@ -2304,14 +2254,12 @@ var interactOutputSchema = z4.object({
   liveUrl: str("URL for viewing the live session.")
 }).describe("Result of a browser interaction, with the session identifier to continue or stop it.");
 var interactStopOutputSchema = z4.object({
-  ...agentHints,
   success,
   error,
   message: str("Confirmation that the session was stopped."),
   scrapeId: str("Session that was stopped.")
 }).describe("Confirmation that the interact session was stopped.");
 var parseOutputSchema = z4.object({
-  ...agentHints,
   success,
   error,
   warning,
@@ -2339,39 +2287,33 @@ var deprecatedToolOutputSchema = z4.object({
   docs_url: str("Documentation for the replacement.")
 }).describe("A pointer to the replacement tool. This entry point is deprecated and always errors.");
 var monitorOutputSchema = z4.object({
-  ...agentHints,
   success,
   error,
   data: unknown("The monitor record: configuration, schedule, targets, and current state.")
 }).describe("One monitor record.");
 var monitorListOutputSchema = z4.object({
-  ...agentHints,
   success,
   error,
   data: unknown("One page of monitor records."),
   pagination: unknown("Pagination metadata for the listing.")
 }).describe("One page of monitors for the authenticated account.");
 var monitorDeleteOutputSchema = z4.object({
-  ...agentHints,
   success,
   error,
   data: unknown("Deletion details, when the API returns any.")
 }).describe("Deletion status for the monitor.");
 var monitorRunOutputSchema = z4.object({
-  ...agentHints,
   success,
   error,
   data: unknown("The queued check.")
 }).describe("The check queued outside the monitor schedule.");
 var monitorChecksOutputSchema = z4.object({
-  ...agentHints,
   success,
   error,
   data: unknown("One page of check summaries."),
   pagination: unknown("Pagination metadata for the listing.")
 }).describe("One page of historical checks for the monitor.");
 var monitorCheckOutputSchema = z4.object({
-  ...agentHints,
   success,
   error,
   data: unknown("The check and its page-level results: each page reports `same`, `new`, `changed`, `removed`, or `error`, with diffs and any goal judgment."),
@@ -2390,25 +2332,20 @@ var paperSchema = z4.looseObject({
   updateDate: str("Date the paper was last updated.")
 });
 var researchSearchOutputSchema = z4.object({
-  ...agentHints,
   results: z4.array(paperSchema).describe("Ranked papers, in the order the text block lists them.")
 }).describe("Ranked papers with canonical IDs, titles, authors, and abstracts.");
 var researchPaperOutputSchema = z4.object({
-  ...agentHints,
   paper: paperSchema.optional().describe("Canonical metadata for the requested paper, absent when it was not found.")
 }).describe("Canonical metadata for one paper.");
 var researchRelatedOutputSchema = z4.object({
-  ...agentHints,
   results: z4.array(paperSchema).describe("Ranked citation-graph candidates."),
   poolSize: z4.number().describe("Number of candidates evaluated before ranking."),
   note: str("Note about how the candidates were produced.")
 }).describe("Ranked citation-graph candidates and the size of the evaluated pool.");
 var researchReadOutputSchema = z4.object({
-  ...agentHints,
   passages: z4.array(z4.looseObject({ text: str("Passage text.") })).describe("In-body passages relevant to the question; empty when no full text is indexed.")
 }).describe("Full-text passages from one paper.");
 var developerSearchOutputSchema = z4.object({
-  ...agentHints,
   results: z4.array(
     z4.looseObject({
       id: str("Stable result id, such as `issue:owner/repo#123` or `doc:<hash>`; its prefix gives the source type."),
@@ -2419,7 +2356,6 @@ var developerSearchOutputSchema = z4.object({
   ).describe("Ranked results, in the order the text block lists them.")
 }).describe("Ranked developer-index results with their matched passages.");
 var govSearchOutputSchema = z4.object({
-  ...agentHints,
   results: z4.array(
     z4.looseObject({
       url: str("Source URL."),
@@ -2668,7 +2604,7 @@ Returns ranked results with an ID, source type, URL, title, and the matched pass
       const client = getClient(session);
       const res = await client.http.get(`${BASE}?${params.toString()}`, originHeaders(requestOrigin(mcpClient, session)));
       const results = res.data?.results ?? [];
-      return withAgentHints(withStructured(fmtDeveloper(results), { results }), res.data, true);
+      return withStructured(fmtDeveloper(results), { results });
     }
   });
 }
@@ -2717,11 +2653,7 @@ Returns ranked results with a position, title, URL, and matched snippet. Results
         originHeaders(requestOrigin(mcpClient, session))
       );
       const results = res.data?.data?.web ?? [];
-      return withAgentHints(
-        withStructured(fmtGov(results), { results }),
-        res.data,
-        true
-      );
+      return withStructured(fmtGov(results), { results });
     }
   });
 }
@@ -2732,12 +2664,10 @@ import { z as z8 } from "zod";
 // src/core-http-error.ts
 var CoreHttpError = class extends Error {
   status;
-  agent_hints;
-  constructor(message, status, agentHints2) {
+  constructor(message, status) {
     super(message);
     this.name = "CoreHttpError";
     this.status = status;
-    if (agentHints2 !== void 0) this.agent_hints = agentHints2;
   }
 };
 
@@ -2760,7 +2690,6 @@ async function monitorRequest(api, session, origin, path2, init = {}) {
   }
   const headers = {
     ...originHeaders(origin),
-    ...AGENT_HINTS_HEADERS,
     ...extraHeaders
   };
   if (apiKey) headers.Authorization = `Bearer ${apiKey}`;
@@ -2773,13 +2702,10 @@ async function monitorRequest(api, session, origin, path2, init = {}) {
   const payload = await response.json().catch(() => ({}));
   if (!response.ok || payload?.success === false) {
     const message = payload?.error || `HTTP ${response.status}: ${response.statusText || "Request failed"}`;
-    throw new CoreHttpError(message, response.status, readAgentHints(payload));
+    throw new CoreHttpError(message, response.status);
   }
   return payload;
 }
-function monitorResult(data) {
-  return withAgentHints(structuredText(data), data);
-}
 var pageStatusSchema = z8.enum(["same", "new", "changed", "removed", "error"]);
 var checkStatusSchema = z8.enum([
   "queued",
@@ -2905,7 +2831,7 @@ In the simple form, a \`goal\` is required. If \`queries\` contains one or more
           body
         }
       );
-      return monitorResult(res);
+      return structuredText(res);
     }
   });
   server.addTool({
@@ -2938,7 +2864,7 @@ List monitors for the authenticated account with optional pagination controls. R
           query: { limit, offset }
         }
       );
-      return monitorResult(res);
+      return structuredText(res);
     }
   });
   server.addTool({
@@ -2965,7 +2891,7 @@ Retrieve one monitor by ID, including its configuration and current state. This
         requestOrigin(mcpClient, session),
         `/monitor/${encodeURIComponent(id)}`
       );
-      return monitorResult(res);
+      return structuredText(res);
     }
   });
   server.addTool({
@@ -2998,7 +2924,7 @@ Returns the updated monitor.
         `/monitor/${encodeURIComponent(id)}`,
         { method: "PATCH", body }
       );
-      return monitorResult(res);
+      return structuredText(res);
     }
   });
   server.addTool({
@@ -3027,7 +2953,7 @@ Permanently delete a monitor by ID and stop its future schedule. This operation
         `/monitor/${encodeURIComponent(id)}`,
         { method: "DELETE" }
       );
-      return monitorResult(res);
+      return structuredText(res);
     }
   });
   server.addTool({
@@ -3055,7 +2981,7 @@ Queue an immediate check for a monitor outside its normal schedule. This starts
         `/monitor/${encodeURIComponent(id)}/run`,
         { method: "POST" }
       );
-      return monitorResult(res);
+      return structuredText(res);
     }
   });
   server.addTool({
@@ -3088,7 +3014,7 @@ List historical checks for a monitor, optionally filtered by status and bounded
         `/monitor/${encodeURIComponent(id)}/checks`,
         { query: { limit, offset, status } }
       );
-      return monitorResult(res);
+      return structuredText(res);
     }
   });
   server.addTool({
@@ -3124,7 +3050,7 @@ Markdown tracking returns a unified text diff, JSON tracking returns field paths
         `/monitor/${encodeURIComponent(id)}/checks/${encodeURIComponent(checkId)}`,
         { query: { limit, skip, status: pageStatus } }
       );
-      return monitorResult(res);
+      return structuredText(res);
     }
   });
 }
@@ -3132,9 +3058,6 @@ Markdown tracking returns a unified text diff, JSON tracking returns field paths
 // src/research.ts
 import { z as z9 } from "zod";
 var BASE3 = "/v2/search/research";
-function researchHeaders(origin) {
-  return { ...originHeaders(origin), ...AGENT_HINTS_HEADERS };
-}
 function appendParam(params, key, value) {
   if (value == null) return;
   if (Array.isArray(value)) {
@@ -3279,10 +3202,10 @@ Returns ranked papers with canonical IDs, titles, authors, and abstracts.
       const client = getClient(session);
       const res = await client.http.get(
         withQuery(`${BASE3}/papers`, params),
-        researchHeaders(requestOrigin(mcpClient, session))
+        originHeaders(requestOrigin(mcpClient, session))
       );
       const results = res.data?.results ?? [];
-      return withAgentHints(withStructured(fmtHits(results), { results }), res.data, true);
+      return withStructured(fmtHits(results), { results });
     }
   });
   server.addTool({
@@ -3310,13 +3233,13 @@ Retrieve canonical metadata for one paper ID, such as an arXiv, PMC, PMID, or DO
       const client = getClient(session);
       const res = await client.http.get(
         `${BASE3}/papers/${encodeURIComponent(paperId)}`,
-        researchHeaders(requestOrigin(mcpClient, session))
+        originHeaders(requestOrigin(mcpClient, session))
       );
       const paper = res.data?.paper;
-      return withAgentHints(withStructured(
+      return withStructured(
         fmtPaperMetadata(paper),
         paper ? { paper } : {}
-      ), res.data, true);
+      );
     }
   });
   server.addTool({
@@ -3358,17 +3281,17 @@ Returns ranked candidates and the evaluated pool size.
           `${BASE3}/papers/${encodeURIComponent(primary)}/similar`,
           params
         ),
-        researchHeaders(requestOrigin(mcpClient, session))
+        originHeaders(requestOrigin(mcpClient, session))
       );
       const results = res.data?.results ?? [];
       const poolSize = res.data?.poolSize ?? 0;
       const note = res.data?.note ? `
 note: ${res.data.note}` : "";
-      return withAgentHints(withStructured(
+      return withStructured(
         `${fmtHits(results)}
 (poolSize=${poolSize})${note}`,
         { results, poolSize, ...res.data?.note ? { note: res.data.note } : {} }
-      ), res.data, true);
+      );
     }
   });
   server.addTool({
@@ -3403,13 +3326,13 @@ Returns matching passages or a notice when full text is unavailable.
       const client = getClient(session);
       const res = await client.http.get(
         withQuery(`${BASE3}/papers/${encodeURIComponent(paperId)}`, params),
-        researchHeaders(requestOrigin(mcpClient, session))
+        originHeaders(requestOrigin(mcpClient, session))
       );
       const passages = res.data?.passages ?? [];
-      return withAgentHints(withStructured(
+      return withStructured(
         passages.length ? passages.map((p) => p.text).join("\n---\n") : "(no full-text passages available for this paper)",
         { passages }
-      ), res.data, true);
+      );
     }
   });
   server.addTool({
@@ -3635,20 +3558,6 @@ async function runWithCredentialRecovery(run, requestId, session) {
     return await run();
   } catch (error2) {
     if (session?.authType !== "api-key" || !isCoreCredentialRejection(error2, session)) {
-      const hints = readErrorAgentHints(error2);
-      if (hints) {
-        const message = error2 instanceof Error ? error2.message : String(error2);
-        throw new UserError(
-          hints.length ? `${message}
-
-${agentHintsText(hints)}` : message,
-          {
-            ...error2 instanceof UserError ? error2.extras : {},
-            error: message,
-            agent_hints: hints
-          }
-        );
-      }
       throw error2;
     }
     const payload = recoveryPayload("CREDENTIAL_INVALID", requestId);
@@ -3707,8 +3616,6 @@ var searchDomainSchema = z11.string().trim().toLowerCase().min(1).max(253).regex
 var searchToolBaseFields = {
   toolDetail: z11.enum(["compact", "summary", "full"]).optional().describe("Compact by default. Compact returns only provider, capability and description; full includes contracts. Inspect selected compact tools with firecrawl_find_tools providers and capabilities."),
   query: z11.string().min(1).describe("Query for web and semantic tool discovery. Operators include quoted phrases, `-term`, `site:host`, `inurl:term`, `intitle:term`, and `related:host`; the set is non-exhaustive. Catalogue browsing is available through firecrawl_find_tools."),
-  objective: z11.string().trim().min(1).max(5e3).optional().describe("Optional broader goal for this search, if known. Avoid sensitive information."),
-  clientModel: z11.string().trim().min(1).max(128).optional().describe("Optional model identifier, if known."),
   domainTools: z11.boolean().optional().describe(
     "Include domain-matched tools for result URLs. Defaults to true when Alexandria is combined with web, news or images; semantic-only search leaves domain matching off."
   ),
@@ -3774,7 +3681,7 @@ function termsRequiredAction(body) {
     url: action.url
   };
 }
-function termsRequiredError(action, context, hints) {
+function termsRequiredError(action, context) {
   const requestId = context.requestId;
   const retryIdentity = requestId ? ` and requestId ${requestId}` : "";
   const message = `Alexandria provider terms required. An organization admin must accept the ${action.terms} provider's terms (version ${action.version}) before this request can run.`;
@@ -3789,7 +3696,6 @@ Do not retry until acceptance is confirmed.`,
       code: TERMS_REQUIRED_CODE,
       status: 403,
       message,
-      ...hints ? { agent_hints: hints } : {},
       ...requestId ? { requestId } : {},
       requiresAction: action,
       nextTool: {
@@ -3820,8 +3726,7 @@ Do not retry until acceptance is confirmed.`,
 function throwIfTermsRequired(error2, context) {
   const source = error2;
   const action = termsRequiredAction(source?.response?.data ?? source?.details);
-  if (action)
-    throw termsRequiredError(action, context, readErrorAgentHints(error2));
+  if (action) throw termsRequiredError(action, context);
 }
 async function relayTermsRequired(run, context) {
   try {
@@ -3839,7 +3744,6 @@ async function relayExchangeError(run, context) {
     const response = error2?.response;
     if (!response || response.status === 401) throw error2;
     const data = response.data;
-    const hints = readErrorAgentHints(error2);
     const message = typeof data?.error === "string" ? data.error : `Alexandria request failed (HTTP ${response.status})`;
     const disabledProvider = response.status === 403 ? context.providers?.find((provider) => message === `Access to ${provider} is disabled for this organization.`) : void 0;
     if (disabledProvider) {
@@ -3849,7 +3753,6 @@ async function relayExchangeError(run, context) {
           code: typeof data?.code === "string" ? data.code : "exchange_error",
           status: 403,
           message,
-          ...hints ? { agent_hints: hints } : {},
           nextTool: {
             name: "firecrawl_scrape",
             arguments: {
@@ -3863,7 +3766,6 @@ async function relayExchangeError(run, context) {
       code: typeof data?.code === "string" ? data.code : "exchange_error",
       status: response.status,
       message,
-      ...hints ? { agent_hints: hints } : {},
       ...typeof data?.chargeId === "string" ? { chargeId: data.chargeId } : {}
     });
   }
@@ -3910,10 +3812,6 @@ function copySession(session) {
     Object.getOwnPropertyDescriptors(session ?? {})
   );
 }
-function resultAgentHints(result) {
-  return result && typeof result === "object" ? readAgentHints(result.structuredContent) : void 0;
-}
-var warnedMissingAgentHintsInterceptor = false;
 var ConsoleLogger = class {
   constructor(shouldLog) {
     this.shouldLog = shouldLog;
@@ -4065,20 +3963,10 @@ function createFirecrawlMcpServer(options = {}) {
             requestId,
             session
           );
-          hooks.onToolResult?.({
-            ...call,
-            status: "success",
-            result,
-            agentHints: resultAgentHints(result)
-          });
+          hooks.onToolResult?.({ ...call, status: "success", result });
           return result;
         } catch (error2) {
-          hooks.onToolResult?.({
-            ...call,
-            status: "error",
-            error: error2,
-            agentHints: readErrorAgentHints(error2)
-          });
+          hooks.onToolResult?.({ ...call, status: "error", error: error2 });
           throw error2;
         }
       }
@@ -4109,44 +3997,7 @@ function createFirecrawlMcpServer(options = {}) {
     if (apiKey) {
       clientConfig.apiKey = apiKey;
     }
-    const client = new FirecrawlApp(clientConfig);
-    const axiosInstance = client.http?.instance;
-    if (axiosInstance?.interceptors?.request?.use) {
-      axiosInstance.interceptors.request.use((request) => {
-        if (typeof request.headers?.set === "function") {
-          request.headers.set("X-Firecrawl-Agent-Hints", "true");
-        } else {
-          request.headers = { ...request.headers ?? {}, ...AGENT_HINTS_HEADERS };
-        }
-        return request;
-      });
-    } else if (!warnedMissingAgentHintsInterceptor) {
-      warnedMissingAgentHintsInterceptor = true;
-      console.warn(
-        "[firecrawl-mcp] SDK request interceptor unavailable; API agent hints may be absent."
-      );
-    }
-    return client;
-  }
-  async function sdkResultWithAgentHints(client, execute) {
-    const responseInterceptors = client.http?.instance?.interceptors?.response;
-    if (!responseInterceptors?.use) return execute();
-    let hints;
-    const interceptor = responseInterceptors.use((response) => {
-      hints = readAgentHints(response?.data) ?? hints;
-      return response;
-    });
-    try {
-      const result = await execute();
-      return preserveAgentHints(result, { agent_hints: hints });
-    } catch (error2) {
-      if (hints && error2 && typeof error2 === "object" && !readErrorAgentHints(error2)) {
-        error2.agent_hints = hints;
-      }
-      throw error2;
-    } finally {
-      responseInterceptors.eject?.(interceptor);
-    }
+    return new FirecrawlApp(clientConfig);
   }
   const SAFE_MODE = config.safeMode;
   function getClient(session) {
@@ -4499,7 +4350,6 @@ function createFirecrawlMcpServer(options = {}) {
     const response = await fetch(`${resolveApiBaseUrl()}${pathName}`, {
       method: "POST",
       headers: {
-        ...AGENT_HINTS_HEADERS,
         "Content-Type": "application/json",
         ...extraHeaders,
         Authorization: `Bearer ${apiKey}`,
@@ -4517,8 +4367,7 @@ function createFirecrawlMcpServer(options = {}) {
     if (!response.ok) {
       throw new CoreHttpError(
         parsed?.error || parsed?.message || `Firecrawl request failed (HTTP ${response.status})`,
-        response.status,
-        readAgentHints(parsed)
+        response.status
       );
     }
     return parsed;
@@ -4600,7 +4449,6 @@ function createFirecrawlMcpServer(options = {}) {
         session,
         origin
       );
-      const uploadHints = readAgentHints(uploadJson);
       const upload = parseApiData(uploadJson);
       if (!upload?.uploadUrl || !upload?.uploadRef) {
         throw new Error(
@@ -4611,7 +4459,6 @@ function createFirecrawlMcpServer(options = {}) {
       const uploadForCommand = { ...upload, headers: uploadHeaders };
       return asText({
         success: true,
-        ...uploadHints ? { agent_hints: uploadHints } : {},
         mode: "hosted-upload-ref-awaiting-upload",
         message: "Hosted MCP cannot read local files. Run the local upload command, then call firecrawl_parse again with uploadRef. No Firecrawl API key is included in this command.",
         upload: {
@@ -4710,17 +4557,14 @@ Alexandria mode, on an authenticated session with Alexandria access: \`alexandri
           },
           session
         );
-        return structuredText(preserveAgentHints(json?.data ?? json, json));
+        return structuredText(json?.data ?? json);
       }
       const client = getClient(session);
       const res = await relayTermsRequired(
-        () => sdkResultWithAgentHints(
-          client,
-          () => client.scrape(String(url), {
-            ...cleaned,
-            origin
-          })
-        ),
+        () => client.scrape(String(url), {
+          ...cleaned,
+          origin
+        }),
         { tool: "firecrawl_scrape" }
       );
       return structuredText(res);
@@ -4760,13 +4604,10 @@ Returns matching URLs rather than page bodies. Retrieve one page with \`firecraw
       const client = getClient(session);
       const cleaned = removeEmptyTopLevel(options2);
       log.info("Mapping URL", { url: String(url) });
-      const res = await sdkResultWithAgentHints(
-        client,
-        () => client.map(String(url), {
-          ...cleaned,
-          origin: requestOrigin(mcpClient, session)
-        })
-      );
+      const res = await client.map(String(url), {
+        ...cleaned,
+        origin: requestOrigin(mcpClient, session)
+      });
       return structuredText(res);
     }
   });
@@ -4946,7 +4787,6 @@ For a programming question, add \`categories: ["developer"]\`; its hits return i
     const origin = originOverride ?? (typeof body.origin === "string" && body.origin.length > 0 ? body.origin : requestOrigin(void 0, session));
     await hooks.beforeKeylessRequest?.(session, origin);
     const headers = {
-      ...AGENT_HINTS_HEADERS,
       ...originHeaders(origin),
       "Content-Type": "application/json",
       ...resolveOutbound(session).headers
@@ -4964,14 +4804,11 @@ For a programming question, add \`categories: ["developer"]\`; its hits return i
           retryAfterSeconds: Number.isFinite(json?.retry_after_seconds) && json.retry_after_seconds > 0 ? json.retry_after_seconds : void 0,
           signupUrl: keylessSignupUrlFrom(json?.signup_url)
         });
-        const hints = readAgentHints(json);
-        if (hints) payload.agent_hints = hints;
         throw new UserError2(String(payload.message), payload);
       }
       throw new CoreHttpError(
         json?.error || `Firecrawl request failed (HTTP ${response.status})`,
-        response.status,
-        readAgentHints(json)
+        response.status
       );
     }
     return json;
@@ -4992,8 +4829,7 @@ For a programming question, add \`categories: ["developer"]\`; its hits return i
         creditsUsed: body.creditsUsed,
         expiresAt: body.expiresAt,
         next: body.next ?? null,
-        data: initialDocs,
-        ...readAgentHints(body) ? { agent_hints: readAgentHints(body) } : {}
+        data: initialDocs
       };
     }
     const docs = initialDocs.slice();
@@ -5017,8 +4853,7 @@ For a programming question, add \`categories: ["developer"]\`; its hits return i
       creditsUsed: body.creditsUsed,
       expiresAt: body.expiresAt,
       next: null,
-      data: docs,
-      ...readAgentHints(body) ? { agent_hints: readAgentHints(body) } : {}
+      data: docs
     };
   }
   async function waitForCrawlCompletionWithOrigin(client, jobId, origin, pollInterval = 2, timeout) {
@@ -5114,7 +4949,6 @@ Eligibility is limited to successful searches within the feedback age window. Th
         }
         if (querySuggestions) body.querySuggestions = querySuggestions;
         const headers = {
-          ...AGENT_HINTS_HEADERS,
           ...originHeaders(origin),
           "Content-Type": "application/json"
         };
@@ -5155,8 +4989,7 @@ Eligibility is limited to successful searches within the feedback age window. Th
             status: response.status,
             feedbackErrorCode: parsed?.feedbackErrorCode,
             error: parsed?.error ?? `HTTP ${response.status}`,
-            retryable: response.status >= 500,
-            ...readAgentHints(parsed) ? { agent_hints: readAgentHints(parsed) } : {}
+            retryable: response.status >= 500
           });
         }
         return structuredText(parsed);
@@ -5240,7 +5073,6 @@ Returns submission status, feedback ID, and accounting fields.
         } = args;
         const apiBase = resolveApiBaseUrl();
         const headers = {
-          ...AGENT_HINTS_HEADERS,
           ...originHeaders(origin),
           "Content-Type": "application/json"
         };
@@ -5296,8 +5128,7 @@ Returns submission status, feedback ID, and accounting fields.
             status: response.status,
             feedbackErrorCode: parsed?.feedbackErrorCode,
             error: parsed?.error ?? `HTTP ${response.status}`,
-            retryable: response.status >= 500,
-            ...readAgentHints(parsed) ? { agent_hints: readAgentHints(parsed) } : {}
+            retryable: response.status >= 500
           });
         }
         return structuredText(parsed);
@@ -5785,7 +5616,6 @@ Set \`redactPII\` to request redaction of personally identifiable information in
       form.append("file", blob, filename);
       form.append("options", JSON.stringify(optionsPayload));
       const headers = {
-        ...AGENT_HINTS_HEADERS,
         ...originHeaders(origin)
       };
       const outbound = resolveOutbound(session);
@@ -5807,15 +5637,9 @@ Set \`redactPII\` to request redaction of personally identifiable information in
       });
       const responseText = await response.text();
       if (!response.ok) {
-        let parsed;
-        try {
-          parsed = JSON.parse(responseText);
-        } catch {
-        }
         throw new CoreHttpError(
           `Parse request failed with status ${response.status}: ${responseText}`,
-          response.status,
-          readAgentHints(parsed)
+          response.status
         );
       }
       try {
@@ -5843,6 +5667,9 @@ Set \`redactPII\` to request redaction of personally identifiable information in
       builtInTool: (name2) => builtInTools.get(name2)
     }
   );
+  hooks.registerResources?.({
+    addResource: (resource) => server.addResource(resource)
+  });
   return {
     start: (args) => server.start(args),
     stop: () => server.stop()