scrapeloop-mcp 0.11.2 → 0.13.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "scrapeloop-mcp",
-  "version": "0.11.2",
+  "version": "0.13.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),
   },
@@ -563,6 +564,24 @@ const TOOLS = {
     def: { description: 'Read one scrape plan, its saved scope, limits, progress and spending.', inputSchema: obj({ plan_id: { ...S, format: 'uuid' } }, ['plan_id']) },
     run: (a) => api('GET', `/plans/${enc(a.plan_id)}`),
   },
+  get_scrape_plan_ready_goal: {
+    def: { description: 'Read a scrape plan verified-email goal and its dated ready count. Newly ready, unused stock, consumption and corrections are separate. Stale or incomplete checks never imply usable stock. This read does not run paid checks or start anything.', inputSchema: obj({ plan_id: { ...S, format: 'uuid' } }, ['plan_id']) },
+    run: (a) => api('GET', `/plans/${enc(a.plan_id)}/ready`),
+  },
+  set_scrape_plan_ready_goal: {
+    def: { description: 'Save a verified-email goal on a native Maps draft without repeat searches. Choose the ready Table and its email campaign, monthly goal/minimum, unused-stock ceiling and evidence rules. Pass the reviewed expected_updated_at from get_scrape_plan. Counts require current input-bound verification, qualification, campaign fields and sender-history checks. This does not start scraping, verification or campaigns. Complete-search pacing must be available before Start.', inputSchema: obj({
+      plan_id: { ...S, format: 'uuid' }, expected_updated_at: { ...S, format: 'date-time' },
+      goal: obj({ kind: { ...S, enum: ['verified_email'] }, ready_list_id: { ...S, format: 'uuid' },
+        campaign_id: { ...S, format: 'uuid' }, monthly_goal: { type: 'integer', minimum: 1, maximum: 1000000 },
+        monthly_minimum: { type: 'integer', minimum: 0, maximum: 1000000 },
+        stock_ceiling: { type: 'integer', minimum: 1, maximum: 1000000 }, timezone: S,
+        evidence_max_age_days: { type: 'integer', minimum: 1, maximum: 90 }, allow_resolved_catchall: B,
+        required_fields: ARR({ ...S, enum: ['name', 'organization_name', 'first_name', 'last_name', 'industry', 'city', 'state', 'postal_code', 'domain', 'language'] }),
+        languages: ARR({ ...S, pattern: '^[a-z]{2}$' }),
+      }, ['ready_list_id', 'campaign_id', 'monthly_goal', 'monthly_minimum', 'stock_ceiling', 'timezone']),
+    }, ['plan_id', 'expected_updated_at', 'goal']) },
+    run: ({ plan_id, ...body }) => api('PUT', `/plans/${enc(plan_id)}/ready`, 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

@@ -45,6 +45,7 @@ export const MUTATION_POLICIES = Object.freeze({
   create_scrape_plan: keyed('POST', ['list_scrape_plans'], ['name', 'target_list_id', 'kind']),
   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']),
   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']),