firecrawl-mcp 3.28.0 → 3.28.2

package/README.md

@@ -593,7 +593,7 @@ and small metadata objects. Do not include raw scrape/parse outputs.
 
 **Returns:**
 
-- `{ success, feedbackId, creditsRefunded, creditsRefundedToday?, dailyRefundCap?, dailyCapReached?, alreadySubmitted?, warning? }` JSON.
+- `{ success, feedbackId, creditsRefunded, creditsRefundedToday?, dailyRefundCap?, dailyCapReached?, websiteCapReached?, alreadySubmitted?, warning? }` JSON.
 
 ### 4. Crawl Tool (`firecrawl_crawl`)
 
@@ -1317,6 +1317,6 @@ The existing `firecrawl_feedback` tool accepts `endpoint: "alexandria"`:
 
 The optional `objective` is the underlying goal of the session: what the agent or its user was ultimately trying to accomplish, beyond the single website in `requestedWebsite`.
 
-This uses authenticated `POST /v2/feedback`, without a job ID, job-age deadline, or credit refund. Optional `providerFeedback` and `capabilityFeedback` arrays describe coverage gaps and execution issues; the tool schema lists supported issue values. A `new_capability_request` requires `requestedFunctionality`; `missing_capability` (the provider exists but lacks the capability) does not. Existing feedback opt-out and authentication controls apply.
+This uses authenticated `POST /v2/feedback`, without a job ID. It must arrive within 20 minutes of the team's most recent Alexandria search, discovery, or execution; later feedback is rejected with `FEEDBACK_WINDOW_EXPIRED`. Eligible feedback can refund 1 credit, subject to daily caps of 10 credits per website and 100 credits per team (UTC day). Past either cap, feedback is still recorded with no refund, and the response sets `websiteCapReached` or `dailyCapReached`. Optional `providerFeedback` and `capabilityFeedback` arrays describe coverage gaps and execution issues; the tool schema lists supported issue values. A `new_capability_request` requires `requestedFunctionality`; `missing_capability` (the provider exists but lacks the capability) does not. Existing feedback opt-out and authentication controls apply.
 
 Eligible Alexandria execution and discovery results include a `feedbackTool` pointer with the tool name and a skeleton of the arguments. The pointer is omitted for Firecrawl-internal calls such as `bash` and when `firecrawl_feedback` is not registered (`FIRECRAWL_NO_ENDPOINT_FEEDBACK` or keyless startup).

package/dist/index.js

@@ -48,7 +48,7 @@ var alexandriaFeedbackFields = {
 };
 var ALEXANDRIA_FEEDBACK_HINT = {
   name: "firecrawl_feedback",
-  when: "Optional after task completion; at most once per website, including uncovered sites. Free; no job ID or deadline.",
+  when: "After task completion, within 20 minutes of your last Alexandria call. Free, optional, refunds 1 credit, No job ID needed.",
   arguments: {
     endpoint: "alexandria",
     rating: "<good | partial | bad>",
@@ -2233,6 +2233,7 @@ var feedbackOutputSchema = z4.object({
   creditsRefundedToday: num("Credits refunded to the team so far this UTC day."),
   dailyRefundCap: num("The team's daily refund cap in credits."),
   dailyCapReached: bool("Whether the daily refund cap is reached; further feedback today still records but refunds nothing."),
+  websiteCapReached: bool("Alexandria only: whether this website's daily refund cap is reached; feedback about other websites can still refund."),
   alreadySubmitted: bool("Whether feedback for this job was already recorded."),
   warning,
   data: unknown("Payload returned with the accepted feedback."),
@@ -6024,12 +6025,12 @@ if (alexandriaFeedbackAvailable()) {
       openWorldHint: true,
       // Feedback is tied to jobs that processed open-web URLs.
       destructiveHint: false
-      // Additive only; submits ratings and notes, does not delete jobs or external content.
+      // Additive only; submits ratings and notes and may refund credits, does not delete jobs or external content.
     },
     description: `
 Submit concise quality feedback for a completed search, scrape, parse, or map job. Provide the endpoint, job ID, rating, and relevant issue codes or small contextual fields; omit large page contents and raw outputs.
 
-For an Alexandria session, set endpoint to \`alexandria\`, omit jobId, and provide requestedWebsite (url and requestedFunctionality), objective, rationale, and rating. objective is the underlying goal behind the session: what you or your user were ultimately trying to accomplish (for example, "shortlist federal IT contracts to bid on this quarter"), not only what was needed from this website. Optional providerFeedback and capabilityFeedback describe gaps or errors. Capability issues: new_capability_request (requires requestedFunctionality), missing_capability, insufficient_functionality, incorrect_result, execution_error, other. Alexandria feedback has no job-age deadline and no credit refund.
+For an Alexandria session, set endpoint to \`alexandria\`, omit jobId, and provide requestedWebsite (url and requestedFunctionality), objective, rationale, and rating. objective is the underlying goal behind the session: what you or your user were ultimately trying to accomplish (for example, "shortlist federal IT contracts to bid on this quarter"), not only what was needed from this website. Optional providerFeedback and capabilityFeedback describe gaps or errors. Capability issues: new_capability_request (requires requestedFunctionality), missing_capability, insufficient_functionality, incorrect_result, execution_error, other. Alexandria feedback must arrive within 20 minutes of the team's latest Alexandria search, discovery, or execution; later feedback is rejected. Eligible feedback can refund 1 credit; refunds are subject to daily caps per website and per team.
 
 Returns submission status, feedback ID, and accounting fields.
 `,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "firecrawl-mcp",
-  "version": "3.28.0",
+  "version": "3.28.2",
   "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",