mcp-scraper 0.21.0 → 0.21.2

package/dist/{site-extract-repository-YNPXEZCB.js → site-extract-repository-5V5EEQ72.js}

@@ -10,8 +10,8 @@ import {
   saveExtractPages,
   setExtractJobTotal,
   settleExtractJob
-} from "./chunk-TUSLATZY.js";
-import "./chunk-HXGZMMW5.js";
+} from "./chunk-X3NIXHHG.js";
+import "./chunk-2FF4GBQ4.js";
 import "./chunk-M2S27J6Z.js";
 import "./chunk-DZBGULWW.js";
 export {
@@ -27,4 +27,4 @@ export {
   setExtractJobTotal,
   settleExtractJob
 };
-//# sourceMappingURL=site-extract-repository-YNPXEZCB.js.map
+//# sourceMappingURL=site-extract-repository-5V5EEQ72.js.map

package/dist/{worker-45WEWCMQ.js → worker-GE5JMHE6.js}

@@ -15,7 +15,7 @@ import "./chunk-K443GQY5.js";
 import "./chunk-XGIPATLV.js";
 import {
   MC_COSTS
-} from "./chunk-HXGZMMW5.js";
+} from "./chunk-2FF4GBQ4.js";
 import "./chunk-M2S27J6Z.js";
 import {
   claimPendingJob,
@@ -132,4 +132,4 @@ export {
   startWorker,
   tickOnce
 };
-//# sourceMappingURL=worker-45WEWCMQ.js.map
+//# sourceMappingURL=worker-GE5JMHE6.js.map

package/docs/mcp-tool-manifest.generated.json

@@ -1,9 +1,9 @@
 {
-  "generatedAt": "2026-07-14T17:00:17.517Z",
+  "generatedAt": "2026-07-14T18:52:04.281Z",
   "generatedFrom": "dist/bin/mcp-stdio-server.js",
   "serverInfo": {
     "name": "mcp-scraper",
-    "version": "0.21.0"
+    "version": "0.21.2"
   },
   "counts": {
     "unified_stdio": 159
@@ -4917,7 +4917,7 @@
     {
       "name": "create-scheduled-action",
       "title": "Create Scheduled Action",
-      "description": "Create a Credit-metered scheduled action in agent mode (default) or connection_sync mode. Each execution has a 75-Credit base charge; agent model usage is added at 1.5 times OpenRouter's actual reported cost. Agent mode follows the description and writes a result into the target vault. connection_sync deterministically runs approved read-only tools on bound service connections and ingests their data. Cadence 'once' runs a single time then completes permanently. Requires write access to the target vault.",
+      "description": "Create a Credit-metered scheduled action for an active MCP Scraper Starter plan or higher, in agent mode (default) or connection_sync mode. Each execution has a 75-Credit base charge; agent model usage is added at 1.5 times OpenRouter's actual reported cost. Agent mode follows the description and writes a result into the target vault. connection_sync deterministically runs approved read-only tools on bound service connections and ingests their data. Cadence 'once' runs a single time then completes permanently. Requires write access to the target vault.",
       "inputSchema": {
         "type": "object",
         "properties": {
@@ -8346,7 +8346,7 @@
     {
       "name": "get-schedule-link",
       "title": "Get Schedule Link",
-      "description": "Get your durable, bookmarkable link to the hosted Scheduled Actions page — a login-free UI to create, view, edit, pause, resume, and delete scheduled actions. The embedded secret is shown only once, on first call; it cannot be re-shown, only revoked and reissued via revoke-schedule-link.",
+      "description": "Get your durable, bookmarkable link to the hosted Scheduled Actions page. Requires an active MCP Scraper Starter plan or higher. The embedded secret is shown only once, on first call; it cannot be re-shown, only revoked and reissued via revoke-schedule-link.",
       "inputSchema": {
         "type": "object",
         "properties": {},
@@ -8367,6 +8367,10 @@
             "type": "boolean",
             "description": "True when a link already exists and was NOT re-shown. Use revoke-schedule-link then call this again to get a fresh one."
           },
+          "code": {
+            "type": "string",
+            "description": "Machine-readable denial code when the link cannot be issued."
+          },
           "error": {
             "type": "string",
             "description": "Human-readable failure reason when ok is false."
@@ -8392,7 +8396,7 @@
     {
       "name": "get-schedule-status",
       "title": "Get Schedule Status",
-      "description": "Get the Credit-metered Scheduled Actions policy. Scheduling is included rather than sold as a separate subscription: each execution has a 75-Credit base charge, and agent model usage is billed at 1.5 times OpenRouter's actual reported cost.",
+      "description": "Get the Credit-metered Scheduled Actions access and billing policy. Scheduling requires an active MCP Scraper Starter plan or higher but has no separate subscription: each execution has a 75-Credit base charge, and agent model usage is billed at 1.5 times OpenRouter's actual reported cost.",
       "inputSchema": {
         "type": "object",
         "properties": {},
@@ -8426,6 +8430,17 @@
           "periodStart": {
             "type": "string"
           },
+          "defaultTimezone": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "description": "IANA timezone applied to new schedules that name a time without a zone; null means UTC."
+          },
+          "code": {
+            "type": "string",
+            "description": "Machine-readable reason scheduling is unavailable."
+          },
           "error": {
             "type": "string"
           }
@@ -16069,6 +16084,10 @@
           "nextRunAt": {
             "type": "string"
           },
+          "code": {
+            "type": "string",
+            "description": "Machine-readable denial code when the action cannot be resumed."
+          },
           "error": {
             "type": "string"
           }
@@ -16705,7 +16724,7 @@
     {
       "name": "set-schedule-entitlement",
       "title": "Set Schedule Entitlement",
-      "description": "Legacy migration and account-recovery control for old Scheduled Actions entitlements. New scheduling is Credit-metered and does not require a separate subscription. This admin-only tool may preserve a legacy API-key delegation or recover historical entitlement rows during migration.",
+      "description": "Admin-only scheduled-action credential provisioning and historical-row recovery. Rotate the encrypted delegated MCP Scraper API key without changing legacy enabled/quota fields by omitting those fields. Legacy entitlement values are not runtime access controls; paid-plan access is checked against MCP Scraper directly.",
       "inputSchema": {
         "type": "object",
         "properties": {
@@ -16716,11 +16735,11 @@
           },
           "enabled": {
             "type": "boolean",
-            "description": "True to enable scheduled actions for this identity, false on cancel/expire."
+            "description": "Historical entitlement value for migration/recovery only. Omit to preserve the stored value."
           },
           "quotaPerPeriod": {
             "type": "number",
-            "description": "Legacy monthly execution quota retained only for historical-row compatibility; it does not price new Credit-metered runs."
+            "description": "Historical monthly execution quota retained only for migration compatibility. Omit to preserve the stored value."
           },
           "mcpScraperApiKey": {
             "type": "string",
@@ -16728,8 +16747,7 @@
           }
         },
         "required": [
-          "granteeIdentity",
-          "enabled"
+          "granteeIdentity"
         ],
         "additionalProperties": false,
         "$schema": "http://json-schema.org/draft-07/schema#"

package/docs/specs/google-drive-bulk-access-and-mcp-schema-passthrough-spec.md

@@ -10,7 +10,7 @@
 - Nango production has the exact source-controlled 12-function Drive inventory: ten bounded reads plus the additive `create-drive-folder` and `copy-drive-file` actions.
 - The scheduler exposes the live-policy intersection as 10 reads and 2 actions, injects exact per-schedule grants into transient Mastra toolsets, and audits classified mutations without storing argument values.
 - The current tenant-owned Drive connection is healthy. Its explicitly authorized action switch is on; newly connected accounts still default to actions off.
-- The fixed public MCP now exposes a 157-tool provider-neutral surface. `describe_service_connection_tool` returned live 64-character schema hashes for both a Drive read and action; `get-about` and a one-item `list-drive-files` page passed through production.
+- The fixed public MCP now exposes a 159-tool provider-neutral surface. `describe_service_connection_tool` returned live 64-character schema hashes for both a Drive read and action; `get-about` and a one-item `list-drive-files` page passed through production.
 - This receipt covers interactive Phase 1 only. Deterministic `connection_sync`, background Proxy/Blob file transfer, native connection-scoped MCP `tools/list`, `upload-document`, broader mutations, and a reversible production write fixture are not shipped.
 
 ## Executive decision
@@ -868,7 +868,13 @@ Ad-hoc exports do not inherit the scheduled-occurrence billing implementation. B
 
 Known-size jobs reserve bytes up front. Unknown-size native exports reserve a floor and extend the reservation before crossing it; failure to extend pauses or ends the job with `entitlement_limit_reached`, never an overage surprise. Completion/cancellation reconciles actual files/bytes/calls, settles credits, and releases the unused reservation. Download/renew routes enforce egress allowance and rate limits.
 
-`scheduledEventUnits` is MCP Scraper product billing: one claimed schedule occurrence consumes one unit through the existing `mem_connection_sync_runs` claim path. A linked export job or continuation slice never charges another scheduled event. `googleQuotaUnits` is provider usage: one occurrence can consume many units across `files.list`, `files.get`, `files.download`, and `operations.get`. Store/report them separately and never label Google quota units as scheduled events.
+The **75-Credit scheduled-occurrence base** is MCP Scraper product billing: one
+claimed schedule occurrence charges the base exactly once through the existing
+`mem_connection_sync_runs` claim path. A linked export job or continuation slice
+never charges another occurrence base. `googleQuotaUnits` is provider usage: one
+occurrence can consume many units across `files.list`, `files.get`,
+`files.download`, and `operations.get`. Store/report them separately and never
+label Google quota units as scheduled-run Credits.
 
 ### Artifact retention and deduplication decision
 
@@ -985,7 +991,7 @@ Content transfer is an internal adapter capability checked separately; it is not
 ### Execution
 
 1. Claim the unique `(identity, scheduleId, scheduledFor)` occurrence.
-2. Consume one MCP Scraper `scheduledEventUnit` atomically through the existing occurrence claim.
+2. Charge the 75-Credit scheduled-occurrence base atomically through the existing occurrence claim.
 3. Acquire a per-connection advisory/lease lock.
 4. Load and validate the Drive checkpoint.
 5. Run a fair bounded slice within the existing 240-second sync budget and 300-second Vercel ceiling.
@@ -1022,7 +1028,10 @@ ALTER TABLE mem_scheduled_action_connections
 
 `set_scheduled_action_connections` and the dashboard binding API accept a provider-discriminated config, validate it server-side, canonicalize/hash it, and return the resolved config. A selection/profile/content-policy change that invalidates an existing Drive checkpoint requires explicit confirmation, clears or archives the old checkpoint transactionally, and starts a new inventory cycle. Unknown config fields fail closed.
 
-The UI must state that one due occurrence counts as one MCP Scraper scheduled event even when it performs many internal calls/Google quota units.
+The UI must state that one started occurrence charges one 75-Credit base even
+when it performs many internal calls/Google quota units. Deterministic
+`connection_sync` adds no model charge; separately metered scraper/browser/media
+calls retain their normal rate-card charges.
 
 ## MCP-native connection tool projection
 
@@ -1304,7 +1313,7 @@ Record by provider, plan, and safe outcome class:
 - files listed/eligible/skipped/downloaded/exported;
 - bytes read/stored, multipart uploads, Range resumes;
 - Drive/Nango status families, retry counts, rate-limit waits;
-- schedule occurrences, `scheduledEventUnits`, Google quota units, leased retries, checkpoint resumes;
+- schedule occurrences, 75-Credit occurrence-base charges, Google quota units, leased retries, checkpoint resumes;
 - artifact renewals/expiry/cleanup.
 
 ### Safe structured logs
@@ -1521,7 +1530,7 @@ Update README, integrations guide, scheduler guide, hosted skill, `llms.txt`/`ll
 - Changed-only content retrieval prevents repeated byte downloads.
 - 240-second budget exits partial with a durable checkpoint.
 - Fair connection slice prevents one Drive from starving other connections.
-- One scheduled occurrence consumes exactly one `scheduledEventUnit` while separately recording Google quota units.
+- One started scheduled occurrence charges exactly one 75-Credit base while separately recording Google quota units.
 - Lease retry of the same occurrence does not double charge.
 - Concurrent occurrence/connection lock prevents overlapping Drive crawls.
 - Run receipt totals reconcile with stored records/artifacts.
@@ -1605,7 +1614,7 @@ Using a dedicated test Drive/account:
 - Drive deterministic `connection_sync` adapter enabled.
 - UI exposes Drive schedule configuration.
 - Initial and incremental runs produce receipts.
-- One occurrence/one `scheduledEventUnit` invariant is proven; Google quota units are separately reconciled.
+- One occurrence/one 75-Credit base invariant is proven; Google quota units are separately reconciled.
 
 ### Gate 6 — writes