scrapeloop-mcp 0.3.0 → 0.4.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "scrapeloop-mcp",
-  "version": "0.3.0",
+  "version": "0.4.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",
   "bin": {

package/src/index.js

@@ -183,7 +183,10 @@ const TOOLS = {
       description: "List an integration's stored credentials (masked — keys are never returned).",
       inputSchema: obj({ integration_id: S }, ['integration_id']),
     },
-    run: (a) => api('GET', `/integrations/${enc(a.integration_id)}/credentials`),
+    run: (a) =>
+      a.integration_id
+        ? api('GET', `/integrations/${enc(a.integration_id)}/credentials`)
+        : { ok: false, status: 400, error: { detail: 'integration_id is required. Use list_integrations to find it.' } },
   },
   add_credential: {
     def: {
@@ -546,6 +549,52 @@ const TOOLS = {
     def: { description: 'Add lead-database people to a list by global_person_id (acquires them, dedup-aware).', inputSchema: obj({ list_id: S, global_person_ids: ARR(S) }, ['list_id', 'global_person_ids']) },
     run: (a) => api('POST', `/lists/${enc(a.list_id)}/members`, { global_person_ids: a.global_person_ids }),
   },
+  import_leads: {
+    def: {
+      description:
+        'Bring your own leads: import externally-sourced lead records into a campaign-bindable Scrapeloop list. For leads you already have (a CSV/export with emails — optionally pre-verified, with a generated first line) — no scraping, no lead credits, and NO re-verification (your verification_status is preserved). Idempotent: dedupe within the workspace by email (default) or external_id — re-running the same batch UPDATES existing leads (merges custom_fields, unions strategy tags), never duplicates. custom_fields flow through to Instantly as custom variables (usable as {{first_line}} etc.). Target an existing list_id OR a list_name (create-or-get). Batch up to 1000 records. Each record: {email (required), first_name, last_name, business_name, phone, website, address, city, state_region, country, niche, rating, reviews_count, verification_status ("verified"|"catchall_verified"|"unverified"|"risky"|"invalid"), strategy_tags:[], custom_fields:{}, external_id}. Returns {list_id, inserted, updated, deduped, invalid, invalid_reasons}. Then bind list_id with create_campaign(source_list_id=...).',
+      inputSchema: obj(
+        {
+          list_id: S,
+          list_name: S,
+          records: ARR(O),
+          dedupe_by: { ...S, description: '"email" (default) or "external_id"' },
+          default_verification_status: S,
+        },
+        ['records'],
+      ),
+    },
+    run: (a) =>
+      api('POST', '/leads/import', {
+        ...(a.list_id ? { list_id: a.list_id } : {}),
+        ...(a.list_name ? { list_name: a.list_name } : {}),
+        records: a.records || [],
+        ...(a.dedupe_by ? { dedupe_by: a.dedupe_by } : {}),
+        ...(a.default_verification_status ? { default_verification_status: a.default_verification_status } : {}),
+      }),
+  },
+  delete_list: {
+    def: {
+      description:
+        'Delete a list (the list + its membership; the underlying leads stay in the workspace). Works for any Scrapeloop list. Irreversible — confirm with the user first.',
+      inputSchema: obj({ list_id: S }, ['list_id']),
+    },
+    run: (a) =>
+      a.list_id
+        ? api('DELETE', `/lists/${enc(a.list_id)}`)
+        : { ok: false, status: 400, error: { detail: 'list_id is required.' } },
+  },
+  delete_campaign: {
+    def: {
+      description:
+        'Delete a campaign (the Scrapeloop campaign + its ledger; the Instantly campaign itself is not deleted). Irreversible — if you only want to stop sending, pause_campaign instead. Confirm with the user first.',
+      inputSchema: obj({ campaign_id: S }, ['campaign_id']),
+    },
+    run: (a) =>
+      a.campaign_id
+        ? api('DELETE', `/campaigns/${enc(a.campaign_id)}`)
+        : { ok: false, status: 400, error: { detail: 'campaign_id is required.' } },
+  },
 };
 
 async function serve() {
@@ -560,7 +609,7 @@ async function serve() {
   }
 
   const server = new Server(
-    { name: 'scrapeloop-mcp', version: '0.3.0' },
+    { name: 'scrapeloop-mcp', version: '0.4.0' },
     { capabilities: { tools: {} } }
   );