scrapeloop-mcp 0.12.0 → 0.14.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "scrapeloop-mcp",
-  "version": "0.12.0",
+  "version": "0.14.0",
   "description": "Scrapeloop MCP server  -  set up and run Scrapeloop end-to-end (integrations, scraping, lead database, verification, cleaners, enrichment, strategies, Instantly campaigns) from any MCP client (Claude Desktop, Cursor, ChatGPT, …).",
   "type": "module",
   "scripts": {

package/src/index.js

@@ -361,6 +361,7 @@ const PLAN_FIELDS = {
   granularity: { ...S, enum: ['country', 'state', 'city', 'postal_code'] },
   locations: ARR(S), location_items: ARR(O), categories: ARR(S),
   min_population: { type: 'integer', minimum: 0 }, scrape_config: O,
+  coverage_mode: { ...S, enum: ['standard', 'complete'] },
   run_mode: { ...S, enum: ['all_now', 'over_time'] }, spread_evenly: B,
   monthly_max_leads: { type: 'integer', minimum: 1 },
   monthly_lead_ceiling: { type: 'integer', minimum: 1 },
@@ -543,15 +544,15 @@ const TOOLS = {
   },
   preview_scrape_plan: {
     def: {
-      description: 'Preview all-now or over-time scraping with the same limits as the app. No scrape or credential is created. Read the Playbook and scraper capabilities first. Set a lead or credit cap for credit-priced work, or a dollar cap for dollar-priced work. all_now limits apply once; over_time limits reset each month. Show costs and coverage warnings before creating.',
+      description: 'Preview all-now or over-time scraping with the same limits as the app. Native coverage_mode complete previews up to 100000 frozen searches as a draft with no raw-row caps; output and cost remain unknown until measured. No scrape or credential is created. Read the Playbook and scraper capabilities first. Set a lead or credit cap for credit-priced work, or a dollar cap for dollar-priced work. all_now limits apply once; over_time limits reset each month. Show costs and coverage warnings before creating.',
       inputSchema: obj(PLAN_FIELDS, PLAN_REQUIRED),
     },
     run: (a) => api('POST', '/plans/preview', a),
   },
   create_scrape_plan: {
     def: {
-      description: 'Save a scrape plan into an existing writable Table. Set start_mode to draft to save without starting searches or spending. The default active mode starts approved work and can spend credits or vendor money. Preview the exact choices first and stay within the approved limit and time period. Pass explicit territory values and matching billing limits. Reuse the same idempotency_key after a lost reply, inspect list_scrape_plans and never create a second plan to escape an uncertain result. Over-time limits reset monthly; a total one-time approval does not authorize recurring spend.',
-      inputSchema: obj({ ...PLAN_FIELDS, target_list_id: { ...S, format: 'uuid' }, start_mode: { ...S, enum: ['active', 'draft'] } }, [...PLAN_REQUIRED, 'target_list_id']),
+      description: 'Save a scrape plan into an existing writable Table. Native coverage_mode complete requires start_mode draft, a stable scope_operation_id and no monthly raw-row caps or repeats. It saves the whole scope in restartable batches and cannot Start until complete-search pacing and shared budgets are ready. Set start_mode to draft to save without starting searches or spending. The default active mode starts approved work and can spend credits or vendor money. Preview the exact choices first and stay within the approved limit and time period. Pass explicit territory values and matching billing limits. Reuse the same idempotency_key after a lost reply, inspect list_scrape_plans and never create a second plan to escape an uncertain result. Over-time limits reset monthly; a total one-time approval does not authorize recurring spend.',
+      inputSchema: obj({ ...PLAN_FIELDS, scope_operation_id: { ...S, format: 'uuid' }, target_list_id: { ...S, format: 'uuid' }, start_mode: { ...S, enum: ['active', 'draft'] } }, [...PLAN_REQUIRED, 'target_list_id']),
     },
     run: ({ idempotency_key: _key, ...body }) => api('POST', '/plans', body),
   },
@@ -581,6 +582,24 @@ const TOOLS = {
     }, ['plan_id', 'expected_updated_at', 'goal']) },
     run: ({ plan_id, ...body }) => api('PUT', `/plans/${enc(plan_id)}/ready`, body),
   },
+  get_scrape_plan_budget: {
+    def: { description: 'Read shared monthly and lifetime lead/verify credit limits, reserved work and remaining allowance. Open holds stay counted across month changes. This makes no provider calls.', inputSchema: obj({ plan_id: { ...S, format: 'uuid' } }, ['plan_id']) },
+    run: (a) => api('GET', `/plans/${enc(a.plan_id)}/budget`),
+  },
+  set_scrape_plan_budget: {
+    def: { description: 'Save reviewed credit limits and Table ownership for a paused complete-search plan with a ready-email goal. Include Raw, Email ready and every check Table. One Table belongs to one budget. Preserve expected_revision from the current budget; omit it only for the first save. A lost reply requires readback before retry. This starts no work and does not enable checks. BYOK paid vendors are not supported by these limits. Launch remains gated until complete-search pacing and reviewed Start are ready.', inputSchema: obj({
+      plan_id: { ...S, format: 'uuid' }, expected_revision: { ...S, format: 'uuid' },
+      limits: obj({
+        monthly_lead_credits: { type: 'integer', minimum: 0, maximum: 1000000000 },
+        lifetime_lead_credits: { type: 'integer', minimum: 0, maximum: 1000000000 },
+        monthly_verify_credits: { type: 'integer', minimum: 0, maximum: 1000000000 },
+        lifetime_verify_credits: { type: 'integer', minimum: 0, maximum: 1000000000 },
+        allowed_checks: { type: 'array', items: { ...S, enum: ['verify_email', 'verify_catchall', 'verify_phone'] }, maxItems: 3 },
+      }, ['monthly_lead_credits', 'lifetime_lead_credits', 'monthly_verify_credits', 'lifetime_verify_credits', 'allowed_checks']),
+      list_ids: { type: 'array', items: { ...S, format: 'uuid' }, minItems: 1, maxItems: 20 },
+    }, ['plan_id', 'limits', 'list_ids']) },
+    run: ({ plan_id, ...body }) => api('PUT', `/plans/${enc(plan_id)}/budget`, body),
+  },
   pause_scrape_plan: {
     def: { description: 'Pause new work from a scrape plan. A job already running may still finish. Inspect the plan and its jobs after pausing.', inputSchema: obj({ plan_id: { ...S, format: 'uuid' } }, ['plan_id']) },
     run: (a) => api('POST', `/plans/${enc(a.plan_id)}/pause`),

package/src/mutation-policies.js

@@ -46,6 +46,7 @@ export const MUTATION_POLICIES = Object.freeze({
   pause_scrape_plan: never('POST', ['get_scrape_plan'], ['plan_id']),
   start_scrape_plan: never('POST', ['get_scrape_plan'], ['plan_id']),
   set_scrape_plan_ready_goal: reconcile('PUT', ['get_scrape_plan_ready_goal'], ['plan_id', 'goal']),
+  set_scrape_plan_budget: reconcile('PUT', ['get_scrape_plan_budget'], ['plan_id', 'limits', 'list_ids']),
   estimate_scrape: read(),
   submit_scrape: keyed('POST', ['list_jobs'], ['kind', 'integration_id', 'credential_id', 'table_id']),
   cancel_job: never('POST', ['get_job'], ['job_id', 'status']),