scrapeloop-mcp 0.30.0 → 0.31.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "scrapeloop-mcp",
-  "version": "0.30.0",
+  "version": "0.31.1",
   "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

@@ -573,10 +573,11 @@ const TOOLS = {
     run: (a) => api('GET', `/plans/${enc(a.plan_id)}/yield`),
   },
   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({
+    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, optional hard-maximum mode, 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 },
+        limit_mode: { ...S, enum: ['target', 'maximum'] },
         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,
@@ -1116,6 +1117,7 @@ const TOOLS = {
           sender_options: { ...O, description: "GoHighLevel SMS choices: workflow_id, tags, require_verified_mobile, voip_counts_as_mobile, missing_fields (ask, create, never)." },
           icon: { type: ["string", "null"], description: "One or two emoji, or null to clear." },
           source_list_id: S,
+          eligibility_rule: { type: ["object", "null"], additionalProperties: false, required: ["source_list_id", "filter"], properties: { source_list_id: S, filter: O }, description: "Optional Current qualification: an open static evidence Table and nonempty current lead/column conditions. The API binds reviewed columns. Null turns this check off." },
           segment_id: S,
           sender_credential_id: S,
           external_list_id: S,
@@ -1142,7 +1144,7 @@ const TOOLS = {
     run: (a) => {
       const body = { name: a.name, sender_credential_id: a.sender_credential_id, external_list_id: a.external_list_id };
       for (const k of [
-        'source_list_id', 'segment_id', 'instantly_campaign_name', 'feed_mode', 'drip_strategy',
+        'source_list_id', 'segment_id', 'instantly_campaign_name', 'feed_mode', 'drip_strategy', 'eligibility_rule',
         'allow_risky_emails', 'offload_enabled', 'offload_no_reply_days', 'offload_to_instantly',
         'offload_to_scrapeloop', 'offload_scrapeloop_list_id',
         'drip_daily_count', 'target_active_count', 'cooldown_days', 'resting_period_days',
@@ -1158,7 +1160,7 @@ const TOOLS = {
     run: (a) => api('GET', `/campaigns/${enc(a.campaign_id)}/qualification`),
   },
   update_campaign: {
-    def: { description: 'Patch a campaign (feed_mode, target_active_count, cooldown_days, external_list_id, …). Switching feed_mode on for an already active campaign runs the same check as campaign_readiness_check: any fail answers 422 with the report under detail.readiness.', inputSchema: obj({ campaign_id: S, patch: { ...O, description: "Campaign settings to change. qualification: {} disables the gate; {rule: be_dutch, evidence_column_id: UUID, max_age_days: 90} requires current Dutch website evidence outside Wallonia. This changes future uploads only; it does not remove sender leads or start checks.", properties: { sender_options: { ...O, description: "GoHighLevel SMS settings. Only supplied keys change." }, icon: { type: ["string", "null"], description: "One or two emoji, or null to clear." } }, additionalProperties: true } }, ['campaign_id', 'patch']) },
+    def: { description: 'Patch a campaign (feed_mode, target_active_count, cooldown_days, external_list_id, …). Switching feed_mode on for an already active campaign runs the same check as campaign_readiness_check: any fail answers 422 with the report under detail.readiness.', inputSchema: obj({ campaign_id: S, patch: { ...O, description: "Campaign settings to change. eligibility_rule uses {source_list_id, filter} for Current qualification, or null to turn it off. qualification: {} disables the Belgium website language gate; {rule: be_dutch, evidence_column_id: UUID, max_age_days: 90} enables it. Read back after saving. These settings do not start checks or remove sender leads.", properties: { eligibility_rule: { type: ["object", "null"], additionalProperties: false, required: ["source_list_id", "filter"], properties: { source_list_id: S, filter: O } }, qualification: { ...O, description: "Belgium website language rule, or {} to disable." }, sender_options: { ...O, description: "GoHighLevel SMS settings. Only supplied keys change." }, icon: { type: ["string", "null"], description: "One or two emoji, or null to clear." } }, additionalProperties: true } }, ['campaign_id', 'patch']) },
     run: (a) => api('PATCH', `/campaigns/${enc(a.campaign_id)}`, a.patch || {}),
   },
   duplicate_campaign: {
@@ -2489,7 +2491,7 @@ const TOOLS = {
           limit: N,
           sort: S,
           q: S,
-          filter: { ...O, description: 'FilterExpr JSON (object): server-side row filter; adds total_filtered. lead.email_domain derives the exact lowercase domain from the current email, separate from website lead.domain. Use eq/any_of/none_of for exact lists; add not_empty to hold malformed or blank addresses under exclusions. No DNS or provider lookup.' },
+          filter: { ...O, description: 'FilterExpr JSON (object): server-side row filter; adds total_filtered. lead.email_domain derives the exact lowercase domain from the current email, separate from website lead.domain. lead.gcid reads an exact Google category ID from current source data; it does not prove business fit. Use eq/any_of/none_of for exact lists; add not_empty to hold missing or malformed values. No DNS or provider lookup.' },
           view_id: { ...S, description: 'A saved custom view uuid or a system key (errored_rows/fully_enriched/data_only) from list_table_views. An ad-hoc filter/sort replaces the view\'s.' },
         },
         ['list_id'],