firecrawl-mcp 3.30.0 → 3.30.1

package/README.md

@@ -1112,14 +1112,16 @@ Start with no arguments for categories, then progressively narrow the catalogue:
 | --- | --- |
 | `{}` | Categories and short descriptions |
 | `{"categories":["podcasts"]}` | Providers in that category |
-| `{"categories":["podcasts"],"providers":["particle"]}` | Compact tool names, descriptions, and prices |
+| `{"categories":["podcasts"],"providers":["particle"]}` | Compact tool names and descriptions |
 | `{"providers":["particle"],"capabilities":["podcasts/episodes/search"]}` | Complete selected inputs, constraints, response, and examples |
 
 No group hop is required. Explicit `level` supports `categories`, `providers`,
 `groups`, or `tools`; explicit `expand` selects contract sections. `expand: []`
 keeps results compact even when selecting a capability. For broad full contracts,
 explicitly request `level: "tools"` and `expand: ["options", "response", "examples"]`.
-URLs provide contextual discovery without fetching the page.
+URLs provide contextual discovery without fetching the page. Tool results omit
+per-capability credit prices unless `includeCosts: true` is set; follow-up
+`nextTool` arguments keep it.
 
 Results are in `data.alexandria[0].data`. Follow an item's `nextTool` by calling
 its `name` with its `arguments`; the page's `nextTool` advances pagination.
@@ -1146,7 +1148,7 @@ These controls require the matching Alexandria API deployment.
 }
 ```
 
-**Returns:** `{ success, scrape_id, requestId, data: { alexandria: [...], creditsCost } }`. Each item is either a result (`provider`, `capability`, `creditsCost`, `data`, `records`, `upstreamStatus`) or an `error` with a `code`; the batch never fails as a whole for a provider error and `data.creditsCost` sums the successful items. Alexandria error bodies (403 without Alexandria access, and 402/409 billing statuses) are relayed in-band with their `code`.
+**Returns:** `{ success, scrape_id, requestId, data: { alexandria: [...], creditsCost } }`. Each item is either a result (`provider`, `capability`, `data`, `records`, `upstreamStatus`) or an `error` with a `code`; the batch never fails as a whole for a provider error and `data.creditsCost` is the total charged for the request. Alexandria error bodies (403 without Alexandria access, and 402/409 billing statuses) are relayed in-band with their `code`.
 
 Execution generates one `x-request-id` and returns it on success or failure. Retry
 the identical payload with that `requestId`; do not create a new ID after an

package/dist/index.js

@@ -2422,7 +2422,8 @@ var findToolsSchema = z5.object({
   level: z5.enum(["categories", "providers", "groups", "tools"]).optional(),
   expand: z5.array(z5.enum(["options", "response", "examples"])).optional().describe('Use ["options", "response"] for inputs and output shape without example payloads; [] keeps results compact. Omit for full contracts on selected capabilities.'),
   limit: z5.number().int().min(1).max(100).optional(),
-  offset: z5.number().int().nonnegative().optional()
+  offset: z5.number().int().nonnegative().optional(),
+  includeCosts: z5.boolean().optional().describe("Include per-capability credit prices (creditsCost, perRecord) in tool results.")
 }).strict();
 var ALEXANDRIA_CATALOGUE_VERTICALS = "companies, people, jobs, finance and filings, public records and government spending, real estate, places and restaurants, retail and prices, package registries and developer data, news, research, and more";
 var ALEXANDRIA_CATALOGUE_SENTENCE = "Alexandria is Firecrawl's catalogue of data providers and workflows across " + ALEXANDRIA_CATALOGUE_VERTICALS + "; providers return typed, sourced records through published contracts.";
@@ -2434,7 +2435,7 @@ function findToolsOptions(args2) {
   if (level === "categories" && (args2.query || args2.providers?.length || args2.categories?.length || args2.groups?.length || args2.capabilities?.length || args2.urls?.length || args2.expand !== void 0)) {
     throw new Error("Category index accepts only level, limit and offset. Select a category to browse providers.");
   }
-  const { expand, ...selectors } = args2;
+  const { expand, includeCosts, ...selectors } = args2;
   return {
     ...selectors,
     ...expand !== void 0 ? { expand } : {},
@@ -2443,10 +2444,10 @@ function findToolsOptions(args2) {
     ...args2.expand === void 0 && level === "tools" && args2.capabilities?.length ? { expand: ["options", "response", "examples"] } : {}
   };
 }
-function withFindToolsNavigation(envelope) {
+function withFindToolsNavigation(envelope, carry = {}) {
   const page = envelope?.data?.alexandria?.[0]?.data;
   if (!page || !Array.isArray(page.items)) return envelope;
-  const link = (next) => next?.provider === "firecrawl" && next?.capability === "find-tools" && next.options ? { name: "firecrawl_find_tools", arguments: next.options } : void 0;
+  const link = (next) => next?.provider === "firecrawl" && next?.capability === "find-tools" && next.options ? { name: "firecrawl_find_tools", arguments: { ...next.options, ...carry } } : void 0;
   for (const item of page.items) {
     if (page.level === "providers" && link(item.next)) {
       const selectors = { ...item.next.options };
@@ -2460,6 +2461,49 @@ function withFindToolsNavigation(envelope) {
   return envelope;
 }
 var ALEXANDRIA_SEARCH_INSTRUCTIONS = 'Authenticated search combines web results, semantic tool summaries and domain matches. Use sources: ["alexandria"] for semantic tools only. ' + ALEXANDRIA_SOURCES_OPT_OUT + ' Tool matches describe available structured-data capabilities, not executed data. toolDetail: "compact" (default) returns only provider, capability and description; "summary" adds metadata; "full" includes their input and output contracts. firecrawl_scrape with an alexandria body executes a selected capability; firecrawl_find_tools provides catalogue browsing and full contracts.';
+var TOOL_PRICE_KEYS = ["creditsCost", "perRecord", "billing", "recordsPerUnit", "zeroDataRetentionCreditsCost"];
+function withoutToolPrice(tool) {
+  if (!tool || typeof tool !== "object" || Array.isArray(tool)) return tool;
+  const copy = { ...tool };
+  for (const key of TOOL_PRICE_KEYS) delete copy[key];
+  return copy;
+}
+function withoutDiscoveredToolPrices(body) {
+  const tools = body?.data?.tools ?? body?.tools;
+  if (!Array.isArray(tools)) return body;
+  return body?.data?.tools ? { ...body, data: { ...body.data, tools: tools.map(withoutToolPrice) } } : { ...body, tools: tools.map(withoutToolPrice) };
+}
+function withoutPagePrices(page) {
+  if (!page || typeof page !== "object") return page;
+  return {
+    ...page,
+    ...Array.isArray(page.items) ? { items: page.items.map(withoutToolPrice) } : {},
+    ...Array.isArray(page.relatedTools) ? {
+      relatedTools: page.relatedTools.map((group) => Array.isArray(group?.tools) ? { ...group, tools: group.tools.map((entry) => entry?.tool ? { ...entry, tool: withoutToolPrice(entry.tool) } : withoutToolPrice(entry)) } : group)
+    } : {}
+  };
+}
+function withoutResultPrices(body) {
+  const results = body?.data?.alexandria;
+  if (!Array.isArray(results)) return body;
+  return {
+    ...body,
+    data: {
+      ...body.data,
+      alexandria: results.map((entry) => {
+        const stripped = withoutToolPrice(entry);
+        return entry?.provider === "firecrawl" && entry?.capability === "find-tools" && stripped && typeof stripped === "object" ? { ...stripped, data: withoutPagePrices(entry.data) } : stripped;
+      })
+    }
+  };
+}
+function withoutFindToolsPrices(envelope) {
+  const stripped = withoutResultPrices(envelope);
+  if (!stripped?.data || typeof stripped.data !== "object") return stripped;
+  const data = { ...stripped.data };
+  delete data.creditsCost;
+  return { ...stripped, data };
+}
 
 // src/alexandria-output.ts
 var INLINE_TOKEN_BUDGET = 2e4;
@@ -4562,7 +4606,7 @@ Alexandria mode, on an authenticated session with Alexandria access: \`alexandri
           },
           session
         );
-        return structuredText(json?.data ?? json);
+        return structuredText(withoutDiscoveredToolPrices(json?.data ?? json));
       }
       const client = getClient(session);
       const res = await relayTermsRequired(
@@ -4572,7 +4616,7 @@ Alexandria mode, on an authenticated session with Alexandria access: \`alexandri
         }),
         { tool: "firecrawl_scrape" }
       );
-      return structuredText(res);
+      return structuredText(withoutDiscoveredToolPrices(res));
     }
   };
   server.addTool({
@@ -4675,7 +4719,7 @@ For a programming question, add \`categories: ["developer"]\`; its hits return i
         const json = await keylessPost("/v2/search", searchBody, session);
         const keylessResponse = { ...json ?? {} };
         delete keylessResponse.id;
-        return structuredCompact(keylessResponse);
+        return structuredCompact(withoutDiscoveredToolPrices(keylessResponse));
       }
       const client = getClient(session);
       const postSearch = () => postSearchWithFallback(
@@ -4685,10 +4729,10 @@ For a programming question, add \`categories: ["developer"]\`; its hits return i
       );
       const context = { tool: "firecrawl_search" };
       const httpRes = exchangeSource ? await relayExchangeError(postSearch, context) : await relayTermsRequired(postSearch, context);
-      return structuredCompact(httpRes?.data ?? {});
+      return structuredCompact(withoutDiscoveredToolPrices(httpRes?.data ?? {}));
     }
   });
-  async function executeExchangeCalls(session, alexandria, suppliedRequestId, timeout, origin = requestOrigin(void 0, session)) {
+  async function executeExchangeCalls(session, alexandria, suppliedRequestId, timeout, origin = requestOrigin(void 0, session), includeCosts = false) {
     assertExchangeCredential2(session);
     const client = getClient(session);
     const requestId = suppliedRequestId ?? randomUUID2();
@@ -4710,7 +4754,7 @@ For a programming question, add \`categories: ["developer"]\`; its hits return i
       );
       const calls = Array.isArray(alexandria) ? alexandria : [alexandria];
       return alexandriaOutput(
-        { ...response?.data ?? {}, requestId },
+        { ...includeCosts ? response?.data ?? {} : withoutResultPrices(response?.data ?? {}), requestId },
         calls,
         async (body, id) => {
           const result = await client.http.post(
@@ -4751,6 +4795,7 @@ For a programming question, add \`categories: ["developer"]\`; its hits return i
       } catch (error2) {
         throw new UserError2(error2 instanceof Error ? error2.message : String(error2));
       }
+      const carry = args2.includeCosts ? { includeCosts: true } : {};
       if (options3.level === "categories") {
         assertExchangeCredential2(session);
         const response = await relayExchangeError(
@@ -4768,11 +4813,12 @@ For a programming question, add \`categories: ["developer"]\`; its hits return i
           next: { provider: "firecrawl", capability: "find-tools", options: { categories: [row.cohort], level: "providers", limit: options3.limit } }
         }));
         const page = { level: "categories", items, total: rows.length };
-        if (offset + options3.limit < rows.length) page.nextTool = { name: "firecrawl_find_tools", arguments: { level: "categories", limit: options3.limit, offset: offset + options3.limit } };
-        return structuredCompact(withAlexandriaFeedbackHint(withFindToolsNavigation({ success: true, data: { creditsCost: 0, alexandria: [{ provider: "firecrawl", capability: "find-tools", creditsCost: 0, data: page }] } }), alexandriaFeedbackAvailable()));
+        if (offset + options3.limit < rows.length) page.nextTool = { name: "firecrawl_find_tools", arguments: { level: "categories", limit: options3.limit, offset: offset + options3.limit, ...carry } };
+        return structuredCompact(withAlexandriaFeedbackHint(withFindToolsNavigation({ success: true, data: { alexandria: [{ provider: "firecrawl", capability: "find-tools", data: page }] } }, carry), alexandriaFeedbackAvailable()));
       }
-      const result = await executeExchangeCalls(session, { provider: "firecrawl", capability: "find-tools", options: options3 }, void 0, void 0, origin);
-      return structuredCompact(withFindToolsNavigation(JSON.parse(result)));
+      const result = await executeExchangeCalls(session, { provider: "firecrawl", capability: "find-tools", options: options3 }, void 0, void 0, origin, carry.includeCosts);
+      const envelope = JSON.parse(result);
+      return structuredCompact(withFindToolsNavigation(carry.includeCosts ? envelope : withoutFindToolsPrices(envelope), carry));
     }
   };
   server.addTool(findToolsTool);
@@ -5832,7 +5878,7 @@ function getOAuthIssuer() {
     normalizeHeader(process.env.FIRECRAWL_OAUTH_ISSUER) ?? DEFAULT_OAUTH_ISSUER
   );
 }
-var SEARCH_PROFILE_INSTRUCTIONS = ALEXANDRIA_SEARCH_INSTRUCTIONS + ` Firecrawl provides web, developer, government, and research search, and executes catalogued Alexandria data providers. Use firecrawl_search to find relevant results across the web and specialized indexes; authenticated searches also return matching Alexandria providers in data.tools. firecrawl_find_tools provides catalogue browsing and provider contracts; firecrawl_scrape with an alexandria body executes a selected capability; firecrawl_scrape with a url retrieves one supplied page. For a programming question, firecrawl_developer_search searches indexed public repositories, GitHub issues, merged pull requests, READMEs, and code documentation and returns the matched passages, and skills: "only" narrows it to agent-skill files; firecrawl_search with categories: ["developer"] reaches the same index beside ordinary web results, returning the hits in the web group rather than as passages and offering no skills filter. For a legal or regulatory question, firecrawl_gov_search searches primary law and regulatory material from US federal, state, and local government sources: statutes, regulations, codes, court opinions, and other government publications; firecrawl_search with categories: ["gov"] reaches the same sources in the web group and cannot be combined with other categories. For a biomedical, life-science, clinical, or arXiv literature question, the firecrawl_research_* tools search the paper index, while categories: ["research"] on firecrawl_search filters ordinary web results to research-affiliated websites. Use the firecrawl_research_* tools to search academic and research literature, expand from anchor papers via the citation graph, and read full-text passages from a specific paper. Search and discovery tools are read-only and return ranked results. Billing: web, developer, and research search are billed per request; government search is free; Alexandria discovery (firecrawl_search with sources ["alexandria"] alone, and firecrawl_find_tools) is free; firecrawl_scrape is billed, as a page retrieval in url mode or at each executed capability's listed price in alexandria mode.`;
+var SEARCH_PROFILE_INSTRUCTIONS = ALEXANDRIA_SEARCH_INSTRUCTIONS + ` Firecrawl provides web, developer, government, and research search, and executes catalogued Alexandria data providers. Use firecrawl_search to find relevant results across the web and specialized indexes; authenticated searches also return matching Alexandria providers in data.tools. firecrawl_find_tools provides catalogue browsing and provider contracts; firecrawl_scrape with an alexandria body executes a selected capability; firecrawl_scrape with a url retrieves one supplied page. For a programming question, firecrawl_developer_search searches indexed public repositories, GitHub issues, merged pull requests, READMEs, and code documentation and returns the matched passages, and skills: "only" narrows it to agent-skill files; firecrawl_search with categories: ["developer"] reaches the same index beside ordinary web results, returning the hits in the web group rather than as passages and offering no skills filter. For a legal or regulatory question, firecrawl_gov_search searches primary law and regulatory material from US federal, state, and local government sources: statutes, regulations, codes, court opinions, and other government publications; firecrawl_search with categories: ["gov"] reaches the same sources in the web group and cannot be combined with other categories. For a biomedical, life-science, clinical, or arXiv literature question, the firecrawl_research_* tools search the paper index, while categories: ["research"] on firecrawl_search filters ordinary web results to research-affiliated websites. Use the firecrawl_research_* tools to search academic and research literature, expand from anchor papers via the citation graph, and read full-text passages from a specific paper. Search and discovery tools are read-only and return ranked results. Billing: web, developer, and research search are billed per request; government search is free; Alexandria discovery (firecrawl_search with sources ["alexandria"] alone, and firecrawl_find_tools) is free; firecrawl_scrape is billed, as a page retrieval in url mode or per executed capability in alexandria mode (pass includeCosts to firecrawl_find_tools to see prices).`;
 var SEARCH_PROFILE_TOOLS = /* @__PURE__ */ new Set([
   "firecrawl_search",
   "firecrawl_developer_search",
@@ -6341,7 +6387,7 @@ Scrape one URL and return its content, or execute catalogued Alexandria capabili
 
 \`firecrawl_search\` with \`sources\` unset and \`firecrawl_find_tools\` can discover providers for the same fields across several pages; a matching Alexandria provider returns typed records in one call.
 
-Alexandria mode: \`alexandria\` selects catalogued capability execution and is mutually exclusive with \`url\`. Alexandria execution is billed at the capability's listed price and needs a team with Alexandria enabled.
+Alexandria mode: \`alexandria\` selects catalogued capability execution and is mutually exclusive with \`url\`. Alexandria execution is billed per capability (pass includeCosts to firecrawl_find_tools to see prices if you need) and needs a team with Alexandria enabled.
 `;
 }
 var SEARCH_SURFACE_FIND_TOOLS_DESCRIPTION = "Browse Alexandria data providers and workflows or read a selected contract. Alexandria covers " + ALEXANDRIA_CATALOGUE_VERTICALS + ": typed, sourced records through published contracts. Prefer normal firecrawl_search for a data task; it already returns matching providers. Use this tool when the contract you need was not returned in full, to browse a category when search found nothing, or before scraping the same fields from several pages. Discovery is free. Use query for semantic discovery or urls to find providers for a website. With no arguments, browse categories, then providers and tools. Contracts describe the inputs and outputs for execution through firecrawl_scrape. nextTool identifies further discovery or pagination. Discovery does not execute providers. Use firecrawl_search when you also need web results.";

package/dist/server.js

@@ -2417,7 +2417,8 @@ var findToolsSchema = z5.object({
   level: z5.enum(["categories", "providers", "groups", "tools"]).optional(),
   expand: z5.array(z5.enum(["options", "response", "examples"])).optional().describe('Use ["options", "response"] for inputs and output shape without example payloads; [] keeps results compact. Omit for full contracts on selected capabilities.'),
   limit: z5.number().int().min(1).max(100).optional(),
-  offset: z5.number().int().nonnegative().optional()
+  offset: z5.number().int().nonnegative().optional(),
+  includeCosts: z5.boolean().optional().describe("Include per-capability credit prices (creditsCost, perRecord) in tool results.")
 }).strict();
 var ALEXANDRIA_CATALOGUE_VERTICALS = "companies, people, jobs, finance and filings, public records and government spending, real estate, places and restaurants, retail and prices, package registries and developer data, news, research, and more";
 var ALEXANDRIA_CATALOGUE_SENTENCE = "Alexandria is Firecrawl's catalogue of data providers and workflows across " + ALEXANDRIA_CATALOGUE_VERTICALS + "; providers return typed, sourced records through published contracts.";
@@ -2429,7 +2430,7 @@ function findToolsOptions(args) {
   if (level === "categories" && (args.query || args.providers?.length || args.categories?.length || args.groups?.length || args.capabilities?.length || args.urls?.length || args.expand !== void 0)) {
     throw new Error("Category index accepts only level, limit and offset. Select a category to browse providers.");
   }
-  const { expand, ...selectors } = args;
+  const { expand, includeCosts, ...selectors } = args;
   return {
     ...selectors,
     ...expand !== void 0 ? { expand } : {},
@@ -2438,10 +2439,10 @@ function findToolsOptions(args) {
     ...args.expand === void 0 && level === "tools" && args.capabilities?.length ? { expand: ["options", "response", "examples"] } : {}
   };
 }
-function withFindToolsNavigation(envelope) {
+function withFindToolsNavigation(envelope, carry = {}) {
   const page = envelope?.data?.alexandria?.[0]?.data;
   if (!page || !Array.isArray(page.items)) return envelope;
-  const link = (next) => next?.provider === "firecrawl" && next?.capability === "find-tools" && next.options ? { name: "firecrawl_find_tools", arguments: next.options } : void 0;
+  const link = (next) => next?.provider === "firecrawl" && next?.capability === "find-tools" && next.options ? { name: "firecrawl_find_tools", arguments: { ...next.options, ...carry } } : void 0;
   for (const item of page.items) {
     if (page.level === "providers" && link(item.next)) {
       const selectors = { ...item.next.options };
@@ -2455,6 +2456,49 @@ function withFindToolsNavigation(envelope) {
   return envelope;
 }
 var ALEXANDRIA_SEARCH_INSTRUCTIONS = 'Authenticated search combines web results, semantic tool summaries and domain matches. Use sources: ["alexandria"] for semantic tools only. ' + ALEXANDRIA_SOURCES_OPT_OUT + ' Tool matches describe available structured-data capabilities, not executed data. toolDetail: "compact" (default) returns only provider, capability and description; "summary" adds metadata; "full" includes their input and output contracts. firecrawl_scrape with an alexandria body executes a selected capability; firecrawl_find_tools provides catalogue browsing and full contracts.';
+var TOOL_PRICE_KEYS = ["creditsCost", "perRecord", "billing", "recordsPerUnit", "zeroDataRetentionCreditsCost"];
+function withoutToolPrice(tool) {
+  if (!tool || typeof tool !== "object" || Array.isArray(tool)) return tool;
+  const copy = { ...tool };
+  for (const key of TOOL_PRICE_KEYS) delete copy[key];
+  return copy;
+}
+function withoutDiscoveredToolPrices(body) {
+  const tools = body?.data?.tools ?? body?.tools;
+  if (!Array.isArray(tools)) return body;
+  return body?.data?.tools ? { ...body, data: { ...body.data, tools: tools.map(withoutToolPrice) } } : { ...body, tools: tools.map(withoutToolPrice) };
+}
+function withoutPagePrices(page) {
+  if (!page || typeof page !== "object") return page;
+  return {
+    ...page,
+    ...Array.isArray(page.items) ? { items: page.items.map(withoutToolPrice) } : {},
+    ...Array.isArray(page.relatedTools) ? {
+      relatedTools: page.relatedTools.map((group) => Array.isArray(group?.tools) ? { ...group, tools: group.tools.map((entry) => entry?.tool ? { ...entry, tool: withoutToolPrice(entry.tool) } : withoutToolPrice(entry)) } : group)
+    } : {}
+  };
+}
+function withoutResultPrices(body) {
+  const results = body?.data?.alexandria;
+  if (!Array.isArray(results)) return body;
+  return {
+    ...body,
+    data: {
+      ...body.data,
+      alexandria: results.map((entry) => {
+        const stripped = withoutToolPrice(entry);
+        return entry?.provider === "firecrawl" && entry?.capability === "find-tools" && stripped && typeof stripped === "object" ? { ...stripped, data: withoutPagePrices(entry.data) } : stripped;
+      })
+    }
+  };
+}
+function withoutFindToolsPrices(envelope) {
+  const stripped = withoutResultPrices(envelope);
+  if (!stripped?.data || typeof stripped.data !== "object") return stripped;
+  const data = { ...stripped.data };
+  delete data.creditsCost;
+  return { ...stripped, data };
+}
 
 // src/alexandria-output.ts
 var INLINE_TOKEN_BUDGET = 2e4;
@@ -4557,7 +4601,7 @@ Alexandria mode, on an authenticated session with Alexandria access: \`alexandri
           },
           session
         );
-        return structuredText(json?.data ?? json);
+        return structuredText(withoutDiscoveredToolPrices(json?.data ?? json));
       }
       const client = getClient(session);
       const res = await relayTermsRequired(
@@ -4567,7 +4611,7 @@ Alexandria mode, on an authenticated session with Alexandria access: \`alexandri
         }),
         { tool: "firecrawl_scrape" }
       );
-      return structuredText(res);
+      return structuredText(withoutDiscoveredToolPrices(res));
     }
   };
   server.addTool({
@@ -4670,7 +4714,7 @@ For a programming question, add \`categories: ["developer"]\`; its hits return i
         const json = await keylessPost("/v2/search", searchBody, session);
         const keylessResponse = { ...json ?? {} };
         delete keylessResponse.id;
-        return structuredCompact(keylessResponse);
+        return structuredCompact(withoutDiscoveredToolPrices(keylessResponse));
       }
       const client = getClient(session);
       const postSearch = () => postSearchWithFallback(
@@ -4680,10 +4724,10 @@ For a programming question, add \`categories: ["developer"]\`; its hits return i
       );
       const context = { tool: "firecrawl_search" };
       const httpRes = exchangeSource ? await relayExchangeError(postSearch, context) : await relayTermsRequired(postSearch, context);
-      return structuredCompact(httpRes?.data ?? {});
+      return structuredCompact(withoutDiscoveredToolPrices(httpRes?.data ?? {}));
     }
   });
-  async function executeExchangeCalls(session, alexandria, suppliedRequestId, timeout, origin = requestOrigin(void 0, session)) {
+  async function executeExchangeCalls(session, alexandria, suppliedRequestId, timeout, origin = requestOrigin(void 0, session), includeCosts = false) {
     assertExchangeCredential2(session);
     const client = getClient(session);
     const requestId = suppliedRequestId ?? randomUUID2();
@@ -4705,7 +4749,7 @@ For a programming question, add \`categories: ["developer"]\`; its hits return i
       );
       const calls = Array.isArray(alexandria) ? alexandria : [alexandria];
       return alexandriaOutput(
-        { ...response?.data ?? {}, requestId },
+        { ...includeCosts ? response?.data ?? {} : withoutResultPrices(response?.data ?? {}), requestId },
         calls,
         async (body, id) => {
           const result = await client.http.post(
@@ -4746,6 +4790,7 @@ For a programming question, add \`categories: ["developer"]\`; its hits return i
       } catch (error2) {
         throw new UserError2(error2 instanceof Error ? error2.message : String(error2));
       }
+      const carry = args.includeCosts ? { includeCosts: true } : {};
       if (options2.level === "categories") {
         assertExchangeCredential2(session);
         const response = await relayExchangeError(
@@ -4763,11 +4808,12 @@ For a programming question, add \`categories: ["developer"]\`; its hits return i
           next: { provider: "firecrawl", capability: "find-tools", options: { categories: [row.cohort], level: "providers", limit: options2.limit } }
         }));
         const page = { level: "categories", items, total: rows.length };
-        if (offset + options2.limit < rows.length) page.nextTool = { name: "firecrawl_find_tools", arguments: { level: "categories", limit: options2.limit, offset: offset + options2.limit } };
-        return structuredCompact(withAlexandriaFeedbackHint(withFindToolsNavigation({ success: true, data: { creditsCost: 0, alexandria: [{ provider: "firecrawl", capability: "find-tools", creditsCost: 0, data: page }] } }), alexandriaFeedbackAvailable()));
+        if (offset + options2.limit < rows.length) page.nextTool = { name: "firecrawl_find_tools", arguments: { level: "categories", limit: options2.limit, offset: offset + options2.limit, ...carry } };
+        return structuredCompact(withAlexandriaFeedbackHint(withFindToolsNavigation({ success: true, data: { alexandria: [{ provider: "firecrawl", capability: "find-tools", data: page }] } }, carry), alexandriaFeedbackAvailable()));
       }
-      const result = await executeExchangeCalls(session, { provider: "firecrawl", capability: "find-tools", options: options2 }, void 0, void 0, origin);
-      return structuredCompact(withFindToolsNavigation(JSON.parse(result)));
+      const result = await executeExchangeCalls(session, { provider: "firecrawl", capability: "find-tools", options: options2 }, void 0, void 0, origin, carry.includeCosts);
+      const envelope = JSON.parse(result);
+      return structuredCompact(withFindToolsNavigation(carry.includeCosts ? envelope : withoutFindToolsPrices(envelope), carry));
     }
   };
   server.addTool(findToolsTool);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "firecrawl-mcp",
-  "version": "3.30.0",
+  "version": "3.30.1",
   "description": "MCP server for Firecrawl — search, scrape, and interact with the web, and search scientific papers. Supports both cloud and self-hosted instances. Features include web search, scraping, page interaction, batch processing, LLM-powered content analysis, and research paper search over biomedical and arXiv literature (PubMed, bioRxiv, medRxiv, arXiv) with citation-graph expansion and full-text reading.",
   "type": "module",
   "mcpName": "io.github.firecrawl/firecrawl-mcp-server",