scrapeloop-mcp 0.8.0 → 0.9.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "scrapeloop-mcp",
-  "version": "0.8.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, \u2026).",
+  "version": "0.9.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",

package/src/index.js

@@ -548,8 +548,8 @@ const TOOLS = {
   },
   create_scrape_plan: {
     def: {
-      description: 'Create and start an approved scrape plan into an existing writable Table. This 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' } }, [...PLAN_REQUIRED, 'target_list_id']),
+      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']),
     },
     run: ({ idempotency_key: _key, ...body }) => api('POST', '/plans', body),
   },
@@ -565,6 +565,10 @@ const TOOLS = {
     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`),
   },
+  start_scrape_plan: {
+    def: { description: 'Start a saved draft after reviewing its scope, destination and cost limits with the user. This can spend credits or vendor money. Requires approval for the exact plan and budget. Pass expected_updated_at from the reviewed get_scrape_plan response. Changed drafts must be reviewed again. After a lost reply inspect get_scrape_plan; never retry blindly.', inputSchema: obj({ plan_id: { ...S, format: 'uuid' }, expected_updated_at: { ...S, format: 'date-time' } }, ['plan_id', 'expected_updated_at']) },
+    run: (a) => api('POST', `/plans/${enc(a.plan_id)}/start`, { expected_updated_at: a.expected_updated_at }),
+  },
   list_jobs: {
     def: { description: 'List recent scrape/enrich jobs in the workspace.', inputSchema: obj({}) },
     run: () => api('GET', '/jobs'),
@@ -2942,7 +2946,7 @@ async function serve() {
   }
 
   const server = new Server(
-    { name: 'scrapeloop-mcp', version: '0.8.0' },
+    { name: 'scrapeloop-mcp', version: '0.9.0' },
     { capabilities: { tools: {} } }
   );
 

package/src/mutation-policies.js

@@ -44,6 +44,7 @@ export const MUTATION_POLICIES = Object.freeze({
   preview_scrape_plan: read(),
   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']),
   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']),