scrapeloop-mcp 0.11.1 → 0.12.0

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "scrapeloop-mcp",
-  "version": "0.11.1",
+  "version": "0.12.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": {
-    "test": "node --check src/index.js && node test/mcp_table_tools.mjs && node test/mcp_playbook_plans.mjs && node test/mcp_community_intent.mjs && node test/mcp_api_key_preflight.mjs && node test/mutation_retry_contract.mjs && node test/release_readiness.mjs",
+    "test": "node --check src/index.js && node test/mcp_table_tools.mjs && node test/mcp_playbook_plans.mjs && node test/mcp_community_intent.mjs && node test/mcp_api_key_preflight.mjs && node test/mutation_retry_contract.mjs && node test/release_readiness.mjs && node test/mcp_server_version.mjs",
     "release:preflight": "node scripts/release-preflight.mjs",
     "release:verify": "node scripts/release-installed-verify.mjs"
   },

package/src/index.js

@@ -17,6 +17,7 @@
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { randomUUID } from 'node:crypto';
+import { readFileSync } from 'node:fs';
 import { AsyncLocalStorage } from 'node:async_hooks';
 import {
   CallToolRequestSchema,
@@ -24,6 +25,7 @@ import {
 } from '@modelcontextprotocol/sdk/types.js';
 import { MUTATION_POLICIES, RETRY_CONTRACT_COPY } from './mutation-policies.js';
 
+const PACKAGE_VERSION = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8')).version;
 const API_KEY = process.env.SCRAPELOOP_API_KEY;
 const BASE = (process.env.SCRAPELOOP_API_URL || 'https://api.scrapeloop.com').replace(/\/$/, '');
 const TIMEOUT_MS = Number(process.env.SCRAPELOOP_TIMEOUT_MS) || 30000;
@@ -561,6 +563,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`),
@@ -2952,7 +2972,7 @@ async function serve() {
   }
 
   const server = new Server(
-    { name: 'scrapeloop-mcp', version: '0.11.1' },
+    { name: 'scrapeloop-mcp', version: PACKAGE_VERSION },
     { capabilities: { tools: {} } }
   );
 

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']),