@coldiq/mcp 0.1.7 → 0.1.8

package/dist/tools/find-emails.js

@@ -2,8 +2,8 @@ import { z } from 'zod';
 import { callApi } from '../client.js';
 export const findEmailsName = 'find_emails';
 export const findEmailsDescription = 'Find professional emails for multiple people in one batch. ' +
-    'Uses bulk enrichment first, then a secondary provider for misses, then ' +
-    'two additional providers in parallel for any remaining misses. ' +
+    'Uses Prospeo bulk first; for any misses, runs FullEnrich and FindyMail/IcyPeas in parallel — ' +
+    'whichever provider returns an email first wins. ' +
     'Much faster than calling find_email one-by-one. Max 50 people per call. ' +
     'Each person needs a unique id to match results back. ' +
     'Always pass first_name, last_name, and domain — they are the primary enrichment signal. ' +
@@ -27,88 +27,69 @@ function sleep(ms) {
 function missesOf(people, results) {
     return people.filter((p) => !results.find((r) => r.id === p.id)?.email);
 }
-export async function findEmailsHandler(input) {
-    const people = input.people;
-    const results = people.map((p) => ({ id: p.id, email: null, provider: null }));
-    // Step 1: Prospeo bulk — 1 call for all people
-    const bulkBody = {
-        data: people.map((p) => p.linkedin_url
-            ? { identifier: p.id, linkedin_url: p.linkedin_url }
-            : { identifier: p.id, first_name: p.first_name, last_name: p.last_name, company_name: p.domain }),
+async function fullEnrichStep(misses, results) {
+    const feBody = {
+        name: 'mcp-enrich-batch',
+        data: misses.map((p) => ({
+            custom_id: p.id,
+            first_name: p.first_name,
+            last_name: p.last_name,
+            domain: p.domain,
+            ...(p.linkedin_url ? { linkedin_url: p.linkedin_url } : {}),
+            enrich_fields: ['contact.emails'],
+        })),
     };
-    const bulkRes = await callApi('POST', '/prospeo/bulk-enrich-person', bulkBody);
-    if (bulkRes.ok) {
-        const data = bulkRes.data;
-        for (const item of data.results ?? []) {
-            const email = item.person?.email?.email;
-            if (typeof email === 'string' && email.includes('@')) {
-                const hit = results.find((r) => r.id === item.identifier);
-                if (hit) {
-                    hit.email = email;
-                    hit.provider = 'prospeo';
-                }
-            }
-        }
-    }
-    // Step 2: FullEnrich batch for Prospeo misses (async, better European coverage)
-    const afterProspeo = missesOf(people, results);
-    if (afterProspeo.length > 0) {
-        const feBody = {
-            name: 'mcp-enrich-batch',
-            data: afterProspeo.map((p) => ({
-                custom_id: p.id,
-                first_name: p.first_name,
-                last_name: p.last_name,
-                domain: p.domain,
-                ...(p.linkedin_url ? { linkedin_url: p.linkedin_url } : {}),
-                enrich_fields: ['contact.emails'],
-            })),
-        };
-        const feCreateRes = await callApi('POST', '/fullenrich/contact/enrich/bulk', feBody);
-        if (feCreateRes.ok) {
-            const enrichmentId = feCreateRes.data.enrichment_id;
-            if (enrichmentId) {
-                const deadline = Date.now() + 90_000;
-                while (Date.now() < deadline) {
-                    await sleep(5000);
-                    const pollRes = await callApi('GET', `/fullenrich/contact/enrich/bulk/${enrichmentId}`);
-                    if (!pollRes.ok)
+    const feCreateRes = await callApi('POST', '/fullenrich/contact/enrich/bulk', feBody);
+    if (!feCreateRes.ok)
+        return;
+    const enrichmentId = feCreateRes.data.enrichment_id;
+    if (!enrichmentId)
+        return;
+    // Tightened from 90s → 45s: Step 3 runs in parallel and typically fills misses
+    // faster, so FullEnrich's marginal value decays past this point.
+    const deadline = Date.now() + 45_000;
+    while (Date.now() < deadline) {
+        await sleep(5000);
+        const pollRes = await callApi('GET', `/fullenrich/contact/enrich/bulk/${enrichmentId}`);
+        if (!pollRes.ok)
+            continue;
+        const pd = pollRes.data;
+        const status = pd.status;
+        if (status !== 'DONE' && status !== 'FAILED')
+            continue;
+        if (status === 'DONE') {
+            const feItems = pd.data;
+            if (Array.isArray(feItems)) {
+                for (const item of feItems) {
+                    const personId = item.custom_id;
+                    const hit = personId ? results.find((r) => r.id === personId) : undefined;
+                    if (!hit || hit.email)
                         continue;
-                    const pd = pollRes.data;
-                    const status = pd.status;
-                    if (status === 'DONE' || status === 'FAILED') {
-                        if (status === 'DONE') {
-                            const feItems = pd.data;
-                            if (Array.isArray(feItems)) {
-                                feItems.forEach((item) => {
-                                    const personId = item.custom_id;
-                                    const hit = personId ? results.find((r) => r.id === personId) : undefined;
-                                    if (!hit || hit.email)
-                                        return;
-                                    const emails = item.emails;
-                                    if (Array.isArray(emails) && emails.length > 0 && typeof emails[0] === 'string' && emails[0].includes('@')) {
-                                        hit.email = emails[0];
-                                        hit.provider = 'fullenrich';
-                                    }
-                                });
-                            }
-                        }
-                        break;
+                    const emails = item.emails;
+                    if (Array.isArray(emails) && emails.length > 0 && typeof emails[0] === 'string' && emails[0].includes('@')) {
+                        hit.email = emails[0];
+                        hit.provider = 'fullenrich';
                     }
                 }
             }
         }
+        return;
     }
-    // Step 3: parallel fallback for remaining misses — FindyMail then IcyPeas per person
-    const afterFullEnrich = missesOf(people, results);
-    await Promise.all(afterFullEnrich.map(async (person) => {
+}
+async function findymailIcypeasStep(misses, results) {
+    await Promise.all(misses.map(async (person) => {
         const hit = results.find((r) => r.id === person.id);
+        if (!hit)
+            return;
+        // Skip if the parallel FullEnrich branch already filled this person.
+        if (hit.email)
+            return;
         const fullName = [person.first_name, person.last_name].filter(Boolean).join(' ');
         const fmRes = await callApi('POST', '/findymail/search/name', {
             name: fullName,
             domain: person.domain,
         });
-        if (fmRes.ok) {
+        if (!hit.email && fmRes.ok) {
             const d = fmRes.data;
             if (typeof d.email === 'string' && d.email.includes('@')) {
                 hit.email = d.email;
@@ -116,12 +97,14 @@ export async function findEmailsHandler(input) {
                 return;
             }
         }
+        if (hit.email)
+            return;
         const icyRes = await callApi('POST', '/icypeas/email-search', {
             firstname: person.first_name,
             lastname: person.last_name,
             domainOrCompany: person.domain,
         });
-        if (icyRes.ok) {
+        if (!hit.email && icyRes.ok) {
             const d = icyRes.data;
             const email = typeof d.email === 'string' && d.email.includes('@')
                 ? d.email
@@ -134,6 +117,40 @@ export async function findEmailsHandler(input) {
             }
         }
     }));
+}
+export async function findEmailsHandler(input) {
+    const people = input.people;
+    const results = people.map((p) => ({ id: p.id, email: null, provider: null }));
+    // Step 1: Prospeo bulk — 1 call for all people
+    const bulkBody = {
+        data: people.map((p) => p.linkedin_url
+            ? { identifier: p.id, linkedin_url: p.linkedin_url }
+            : { identifier: p.id, first_name: p.first_name, last_name: p.last_name, company_name: p.domain }),
+    };
+    const bulkRes = await callApi('POST', '/prospeo/bulk-enrich-person', bulkBody);
+    if (bulkRes.ok) {
+        const data = bulkRes.data;
+        for (const item of data.results ?? []) {
+            const email = item.person?.email?.email;
+            if (typeof email === 'string' && email.includes('@')) {
+                const hit = results.find((r) => r.id === item.identifier);
+                if (hit) {
+                    hit.email = email;
+                    hit.provider = 'prospeo';
+                }
+            }
+        }
+    }
+    // Steps 2 & 3 run concurrently for Prospeo misses.
+    //   Step 2: FullEnrich bulk async (slow tail, better European coverage)
+    //   Step 3: per-person FindyMail → IcyPeas waterfall
+    // Both branches write to the shared `results` array; every write site checks
+    // `if (hit.email)` first so whichever provider arrives first wins and the
+    // other does not overwrite.
+    const misses = missesOf(people, results);
+    if (misses.length > 0) {
+        await Promise.all([fullEnrichStep(misses, results), findymailIcypeasStep(misses, results)]);
+    }
     const found = results.filter((r) => r.email !== null).length;
     return {
         content: [

package/dist/tools/find-emails.js.map

@@ -1 +1 @@
-{"version":3,"file":"find-emails.js","sourceRoot":"","sources":["../../src/tools/find-emails.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"find-emails.js","sourceRoot":"","sources":["../../src/tools/find-emails.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coldiq/mcp",
-  "version": "0.1.7",
+  "version": "0.1.8",
   "type": "module",
   "main": "dist/index.js",
   "bin": {

package/src/executor.ts

@@ -13,6 +13,10 @@ export interface ExecutionResult {
 export interface ExecutionError {
   error: string
   providers_tried: Array<{ provider: string; status: number; error: string }>
+  /** Set when at least one provider returned 402 — points the user at the top-up page. */
+  billingUrl?: string
+  /** True when every attempted provider failed with 402 (the user is fully blocked on credits). */
+  insufficientCredits?: boolean
 }
 
 function isExecutionError(result: ExecutionResult | ExecutionError): result is ExecutionError {
@@ -69,7 +73,11 @@ async function executeAsync(
   const deadline = Date.now() + asyncCfg.timeoutMs
   let pollCount = 0
   while (Date.now() < deadline) {
-    await sleep(asyncCfg.pollIntervalMs)
+    const interval =
+      typeof asyncCfg.pollIntervalMs === 'function'
+        ? asyncCfg.pollIntervalMs(pollCount + 1)
+        : asyncCfg.pollIntervalMs
+    await sleep(interval)
     pollCount++
 
     const pollRes = await callApi('GET', asyncCfg.pollEndpoint(jobId))
@@ -140,6 +148,7 @@ export async function executeWithFallback(
       : getProviders(capability)
 
   const errors: Array<{ id: string; status: number; error: string }> = []
+  let billingUrl: string | undefined
 
   for (const provider of providers) {
     if (provider.isApplicable) {
@@ -189,16 +198,33 @@ export async function executeWithFallback(
       : `Status ${result.status}, no results`
     log(`${capability} → ${provider.id} ✗ ${errMsg}`)
     errors.push({ id: provider.id, status: result.status, error: errMsg })
+
+    // Capture the billing URL the API surfaces in 402 responses so the
+    // top-level error can include a clickable link for the user.
+    if (result.status === 402 && !billingUrl
+        && result.data && typeof result.data === 'object'
+        && typeof (result.data as Record<string, unknown>).billingUrl === 'string') {
+      billingUrl = (result.data as Record<string, string>).billingUrl
+    }
   }
 
   debug(`${capability}: all ${errors.length} providers failed — ${JSON.stringify(errors)}`)
   const sanitized = errors.map((e, i) => ({
     provider: `provider_${i + 1}`,
     status: e.status,
-    error: e.error.slice(0, 120),
+    error: e.error.slice(0, 200),
   }))
-  return {
-    error: `All ${errors.length} providers failed for ${capability}`,
+
+  const allOutOfCredits = errors.length > 0 && errors.every((e) => e.status === 402)
+  const topLevelError = allOutOfCredits && billingUrl
+    ? `Insufficient credits — every provider for ${capability} returned 402. Top up at ${billingUrl} to continue.`
+    : `All ${errors.length} providers failed for ${capability}`
+
+  const out: ExecutionError = {
+    error: topLevelError,
     providers_tried: sanitized,
   }
+  if (billingUrl) out.billingUrl = billingUrl
+  if (allOutOfCredits) out.insufficientCredits = true
+  return out
 }

package/src/registry.ts

@@ -5,8 +5,12 @@
 export interface AsyncConfig {
   /** Build the poll endpoint path from the ID returned by the create call */
   pollEndpoint: (id: string) => string
-  /** Milliseconds between poll attempts */
-  pollIntervalMs: number
+  /**
+   * Milliseconds between poll attempts. Either a constant or a function of the
+   * 1-indexed attempt number (1 = first poll). Use the function form to apply
+   * a fast-then-backoff schedule.
+   */
+  pollIntervalMs: number | ((attempt: number) => number)
   /** Max milliseconds before giving up */
   timeoutMs: number
   /** Check if the async job is done */
@@ -963,7 +967,11 @@ const findPeopleProviders: ProviderEntry[] = [
     },
     async: {
       pollEndpoint: (id: string) => `/leadsfactory/contact-finder/searches/${id}`,
-      pollIntervalMs: 15000,
+      // Continuously growing backoff: fast first probe (3s), then ramp up indefinitely
+      // — never plateaus, but the cumulative delay is bounded by timeoutMs.
+      // Schedule: 3s, 7s, 15s, 25s, 35s, 45s, 55s, 65s, +10s per attempt thereafter.
+      pollIntervalMs: (attempt) =>
+        attempt === 1 ? 3000 : attempt === 2 ? 7000 : 15000 + (attempt - 3) * 10000,
       timeoutMs: 300_000, // 5 minutes
       isComplete: (data) => {
         const d = data as Record<string, unknown>

package/src/tools/find-email.ts

@@ -4,7 +4,10 @@ import { executeWithFallback, isExecutionError } from '../executor.js'
 export const findEmailName = 'find_email'
 
 export const findEmailDescription =
-  "Find a person's professional email given their name and company. Tries multiple providers in sequence until an email is found (waterfall). Returns the email and which provider found it."
+  "Find a person's professional email given their name and company. " +
+  'For more than one person, ALWAYS use find_emails instead — never loop this tool. ' +
+  'Looping find_email runs the full provider waterfall sequentially per person and is dramatically slower than the batched find_emails path. ' +
+  'Tries multiple providers in sequence until an email is found (waterfall). Returns the email and which provider found it.'
 
 export const findEmailSchema = {
   first_name: z.string().optional().describe('First name of the person'),

package/src/tools/find-emails.ts

@@ -5,8 +5,8 @@ export const findEmailsName = 'find_emails'
 
 export const findEmailsDescription =
   'Find professional emails for multiple people in one batch. ' +
-  'Uses bulk enrichment first, then a secondary provider for misses, then ' +
-  'two additional providers in parallel for any remaining misses. ' +
+  'Uses Prospeo bulk first; for any misses, runs FullEnrich and FindyMail/IcyPeas in parallel — ' +
+  'whichever provider returns an email first wins. ' +
   'Much faster than calling find_email one-by-one. Max 50 people per call. ' +
   'Each person needs a unique id to match results back. ' +
   'Always pass first_name, last_name, and domain — they are the primary enrichment signal. ' +
@@ -50,106 +50,72 @@ function missesOf(people: PersonInput[], results: EmailResult[]): PersonInput[]
   return people.filter((p) => !results.find((r) => r.id === p.id)?.email)
 }
 
-export async function findEmailsHandler(input: Record<string, unknown>) {
-  const people = input.people as PersonInput[]
-  const results: EmailResult[] = people.map((p) => ({ id: p.id, email: null, provider: null }))
-
-  // Step 1: Prospeo bulk — 1 call for all people
-  const bulkBody = {
-    data: people.map((p) =>
-      p.linkedin_url
-        ? { identifier: p.id, linkedin_url: p.linkedin_url }
-        : { identifier: p.id, first_name: p.first_name, last_name: p.last_name, company_name: p.domain },
-    ),
+async function fullEnrichStep(misses: PersonInput[], results: EmailResult[]): Promise<void> {
+  const feBody = {
+    name: 'mcp-enrich-batch',
+    data: misses.map((p) => ({
+      custom_id: p.id,
+      first_name: p.first_name,
+      last_name: p.last_name,
+      domain: p.domain,
+      ...(p.linkedin_url ? { linkedin_url: p.linkedin_url } : {}),
+      enrich_fields: ['contact.emails'],
+    })),
   }
 
-  const bulkRes = await callApi('POST', '/prospeo/bulk-enrich-person', bulkBody)
-
-  if (bulkRes.ok) {
-    const data = bulkRes.data as {
-      results?: Array<{
-        identifier: string
-        person?: { email?: { email?: string } }
-      }>
-    }
-    for (const item of data.results ?? []) {
-      const email = item.person?.email?.email
-      if (typeof email === 'string' && email.includes('@')) {
-        const hit = results.find((r) => r.id === item.identifier)
-        if (hit) {
-          hit.email = email
-          hit.provider = 'prospeo'
-        }
-      }
-    }
-  }
-
-  // Step 2: FullEnrich batch for Prospeo misses (async, better European coverage)
-  const afterProspeo = missesOf(people, results)
-
-  if (afterProspeo.length > 0) {
-    const feBody = {
-      name: 'mcp-enrich-batch',
-      data: afterProspeo.map((p) => ({
-        custom_id: p.id,
-        first_name: p.first_name,
-        last_name: p.last_name,
-        domain: p.domain,
-        ...(p.linkedin_url ? { linkedin_url: p.linkedin_url } : {}),
-        enrich_fields: ['contact.emails'],
-      })),
-    }
-
-    const feCreateRes = await callApi('POST', '/fullenrich/contact/enrich/bulk', feBody)
-
-    if (feCreateRes.ok) {
-      const enrichmentId = (feCreateRes.data as Record<string, unknown>).enrichment_id as string | undefined
-
-      if (enrichmentId) {
-        const deadline = Date.now() + 90_000
-        while (Date.now() < deadline) {
-          await sleep(5000)
-          const pollRes = await callApi('GET', `/fullenrich/contact/enrich/bulk/${enrichmentId}`)
-          if (!pollRes.ok) continue
-
-          const pd = pollRes.data as Record<string, unknown>
-          const status = pd.status as string | undefined
-          if (status === 'DONE' || status === 'FAILED') {
-            if (status === 'DONE') {
-              const feItems = pd.data as Array<Record<string, unknown>> | undefined
-              if (Array.isArray(feItems)) {
-                feItems.forEach((item) => {
-                  const personId = item.custom_id as string | undefined
-                  const hit = personId ? results.find((r) => r.id === personId) : undefined
-                  if (!hit || hit.email) return
-                  const emails = item.emails as string[] | undefined
-                  if (Array.isArray(emails) && emails.length > 0 && typeof emails[0] === 'string' && emails[0].includes('@')) {
-                    hit.email = emails[0]
-                    hit.provider = 'fullenrich'
-                  }
-                })
-              }
-            }
-            break
+  const feCreateRes = await callApi('POST', '/fullenrich/contact/enrich/bulk', feBody)
+  if (!feCreateRes.ok) return
+
+  const enrichmentId = (feCreateRes.data as Record<string, unknown>).enrichment_id as string | undefined
+  if (!enrichmentId) return
+
+  // Tightened from 90s → 45s: Step 3 runs in parallel and typically fills misses
+  // faster, so FullEnrich's marginal value decays past this point.
+  const deadline = Date.now() + 45_000
+  while (Date.now() < deadline) {
+    await sleep(5000)
+    const pollRes = await callApi('GET', `/fullenrich/contact/enrich/bulk/${enrichmentId}`)
+    if (!pollRes.ok) continue
+
+    const pd = pollRes.data as Record<string, unknown>
+    const status = pd.status as string | undefined
+    if (status !== 'DONE' && status !== 'FAILED') continue
+
+    if (status === 'DONE') {
+      const feItems = pd.data as Array<Record<string, unknown>> | undefined
+      if (Array.isArray(feItems)) {
+        for (const item of feItems) {
+          const personId = item.custom_id as string | undefined
+          const hit = personId ? results.find((r) => r.id === personId) : undefined
+          if (!hit || hit.email) continue
+          const emails = item.emails as string[] | undefined
+          if (Array.isArray(emails) && emails.length > 0 && typeof emails[0] === 'string' && emails[0].includes('@')) {
+            hit.email = emails[0]
+            hit.provider = 'fullenrich'
           }
         }
       }
     }
+    return
   }
+}
 
-  // Step 3: parallel fallback for remaining misses — FindyMail then IcyPeas per person
-  const afterFullEnrich = missesOf(people, results)
-
+async function findymailIcypeasStep(misses: PersonInput[], results: EmailResult[]): Promise<void> {
   await Promise.all(
-    afterFullEnrich.map(async (person) => {
-      const hit = results.find((r) => r.id === person.id)!
+    misses.map(async (person) => {
+      const hit = results.find((r) => r.id === person.id)
+      if (!hit) return
+
+      // Skip if the parallel FullEnrich branch already filled this person.
+      if (hit.email) return
+
       const fullName = [person.first_name, person.last_name].filter(Boolean).join(' ')
 
       const fmRes = await callApi('POST', '/findymail/search/name', {
         name: fullName,
         domain: person.domain,
       })
-      if (fmRes.ok) {
+      if (!hit.email && fmRes.ok) {
         const d = fmRes.data as Record<string, unknown>
         if (typeof d.email === 'string' && d.email.includes('@')) {
           hit.email = d.email
@@ -158,12 +124,14 @@ export async function findEmailsHandler(input: Record<string, unknown>) {
         }
       }
 
+      if (hit.email) return
+
       const icyRes = await callApi('POST', '/icypeas/email-search', {
         firstname: person.first_name,
         lastname: person.last_name,
         domainOrCompany: person.domain,
       })
-      if (icyRes.ok) {
+      if (!hit.email && icyRes.ok) {
         const d = icyRes.data as Record<string, unknown>
         const email =
           typeof d.email === 'string' && d.email.includes('@')
@@ -178,6 +146,53 @@ export async function findEmailsHandler(input: Record<string, unknown>) {
       }
     }),
   )
+}
+
+export async function findEmailsHandler(input: Record<string, unknown>) {
+  const people = input.people as PersonInput[]
+  const results: EmailResult[] = people.map((p) => ({ id: p.id, email: null, provider: null }))
+
+  // Step 1: Prospeo bulk — 1 call for all people
+  const bulkBody = {
+    data: people.map((p) =>
+      p.linkedin_url
+        ? { identifier: p.id, linkedin_url: p.linkedin_url }
+        : { identifier: p.id, first_name: p.first_name, last_name: p.last_name, company_name: p.domain },
+    ),
+  }
+
+  const bulkRes = await callApi('POST', '/prospeo/bulk-enrich-person', bulkBody)
+
+  if (bulkRes.ok) {
+    const data = bulkRes.data as {
+      results?: Array<{
+        identifier: string
+        person?: { email?: { email?: string } }
+      }>
+    }
+    for (const item of data.results ?? []) {
+      const email = item.person?.email?.email
+      if (typeof email === 'string' && email.includes('@')) {
+        const hit = results.find((r) => r.id === item.identifier)
+        if (hit) {
+          hit.email = email
+          hit.provider = 'prospeo'
+        }
+      }
+    }
+  }
+
+  // Steps 2 & 3 run concurrently for Prospeo misses.
+  //   Step 2: FullEnrich bulk async (slow tail, better European coverage)
+  //   Step 3: per-person FindyMail → IcyPeas waterfall
+  // Both branches write to the shared `results` array; every write site checks
+  // `if (hit.email)` first so whichever provider arrives first wins and the
+  // other does not overwrite.
+  const misses = missesOf(people, results)
+
+  if (misses.length > 0) {
+    await Promise.all([fullEnrichStep(misses, results), findymailIcypeasStep(misses, results)])
+  }
 
   const found = results.filter((r) => r.email !== null).length
   return {