@coldiq/mcp 0.4.3 → 0.4.5

package/src/tools/enrich-company-bulk.ts

@@ -7,7 +7,8 @@ export const enrichCompanyBulkDescription =
   'Enrich up to 5,000 companies (size, industry, funding, technologies, social profiles) in one ASYNC job. Returns a job_id immediately — this does NOT return firmographics inline. ' +
   'Poll get_bulk_job(job_id) until status is "done" (drains over a few minutes), then page through rows. ' +
   'Each row runs the same managed waterfall as enrich_company; provide at least one of domain, linkedin_url, or name per company. ' +
-  'Charged only per row a provider enriches (misses are free). For a single company, use enrich_company instead.'
+  'Charged only per row a provider enriches (misses are free). For a single company, use enrich_company instead. ' +
+  'Call cancel_bulk_job to stop a running job early — already-processed rows stay charged, un-started rows are never billed.'
 
 export const enrichCompanyBulkSchema = {
   inputs: z

package/src/tools/enrich-person-bulk.ts

@@ -7,7 +7,8 @@ export const enrichPersonBulkDescription =
   'Enrich up to 5,000 people (LinkedIn profile + professional details) in one ASYNC job. Returns a job_id immediately — this does NOT return profiles inline. ' +
   'Poll get_bulk_job(job_id) until status is "done" (drains over a few minutes), then page through rows. ' +
   'Each row runs the same managed waterfall as enrich_person; provide an email, a linkedin_url, or name + company/domain per person. ' +
-  'Charged only per row a provider enriches (misses are free). For a single person, use enrich_person instead.'
+  'Charged only per row a provider enriches (misses are free). For a single person, use enrich_person instead. ' +
+  'Call cancel_bulk_job to stop a running job early — already-processed rows stay charged, un-started rows are never billed.'
 
 export const enrichPersonBulkSchema = {
   inputs: z

package/src/tools/find-emails-bulk.ts

@@ -13,7 +13,8 @@ export const findEmailsBulkDescription =
   'result carries a `confidence` (high/medium/unknown) — treat medium/unknown as unverified and run ' +
   'verify_emails_bulk before sending, or you risk bounces. A located email the provider itself flags as a low-confidence ' +
   'pattern guess comes back as verdict `guessed` instead of `found` and is FREE — never send a `guessed` email unverified. ' +
-  'For 50 or fewer people that you want back inline, use find_emails instead.'
+  'For 50 or fewer people that you want back inline, use find_emails instead. ' +
+  'Started a job that is too big or wrong? Call cancel_bulk_job to stop it — already-processed rows stay charged, un-started rows are never billed.'
 
 export const findEmailsBulkSchema = {
   people: z

package/src/tools/find-phone-bulk.ts

@@ -7,7 +7,8 @@ export const findPhoneBulkDescription =
   'Find direct/mobile phone numbers for up to 5,000 people in one ASYNC job. Returns a job_id immediately — this does NOT return numbers inline. ' +
   'Poll get_bulk_job(job_id) until status is "done" (drains over a few minutes), then page through rows. ' +
   'Each row runs the same managed waterfall as find_phone; provide a linkedin_url, or first+last name with company_domain/company_name. ' +
-  'Charged only per row a provider returns a number (misses are free). Phone lookups are relatively expensive — scope the list deliberately. For a single person, use find_phone instead.'
+  'Charged only per row a provider returns a number (misses are free). Phone lookups are relatively expensive — scope the list deliberately. For a single person, use find_phone instead. ' +
+  'Overshot the list? Call cancel_bulk_job to stop it immediately — already-processed rows stay charged, un-started rows are never billed.'
 
 export const findPhoneBulkSchema = {
   inputs: z

package/src/tools/get-bulk-job.ts

@@ -5,14 +5,15 @@ export const getBulkJobName = 'get_bulk_job'
 
 export const getBulkJobDescription =
   'Poll any async bulk job (verify_emails_bulk, find_emails_bulk, enrich_person_bulk, enrich_company_bulk, find_phone_bulk). ' +
-  'Returns { status, items_total, items_processed, summary, coverage, credits_reserved, credits_charged, page }. Poll until status is "done" (or "timed_out"). ' +
+  'Returns { status, items_total, items_processed, summary, coverage, credits_reserved, credits_charged, page }. Poll until status is TERMINAL — one of "done", "timed_out", "failed", or "cancelled" (a job someone stopped with cancel_bulk_job); stop polling on any of these. ' +
   'Use the `summary` per-verdict counts for totals — do NOT expect all rows inline: rows come one page at a time (default 100). ' +
   'For find jobs, verdict `guessed` means an email was located but the provider marked it a low-confidence pattern guess — it is NOT billed; verify it before sending. ' +
   'The `coverage` block {conclusive, skipped, unverifiable, failed, pending} tells you how much was truly resolved: `skipped` rows (per-row ' +
   '`result.reason` chunk_failed/not_returned/timed_out) were never conclusively checked and are safe to re-submit; `failed` is a hard error (retry unlikely to help). ' +
   '`credits_charged` (null until settled) is the actual spend; `credits_reserved` is the worst-case hold. Each row echoes its submitted `input`, ' +
   'so you can map verdicts back to your submissions without tracking order. To page, OMIT cursor for the first page, then call again with ' +
-  'cursor = page.next_cursor until next_cursor is null.'
+  'cursor = page.next_cursor until next_cursor is null. ' +
+  'To STOP a running find/enrich/phone job early (before it spends more credits), call cancel_bulk_job — already-processed rows stay charged, un-started rows are never billed.'
 
 export const getBulkJobSchema = {
   job_id: z.number().int().describe('The job_id returned by a *_bulk submit tool.'),

package/src/utils/provider-resolver.ts

@@ -8,16 +8,12 @@ import { fuzzyMatch } from './fuzzy.js'
 // Order = auto-route execution order: bulk providers first (Steps 1-3), then
 // the single-find_email fallback providers used for stragglers (Step 4).
 export const CONFIGURED_FIND_EMAILS_PROVIDERS = [
-  'limadata-work-email',
+  'findymail',
   'leadmagic',
   'prospeo',
-  'blitzapi',
-  'limadata-work-email-linkedin',
+  'wiza',
   'apollo-people-match',
-  'findymail',
-  'fullenrich',
-  'pdl-person-enrich',
-  'linkupapi',
+  'limadata-work-email',
   'icypeas',
 ]
 
@@ -223,10 +219,8 @@ const GATED_DESCRIPTIONS: Partial<Record<Capability, Partial<Record<string, Gate
   find_email: {
     findymail:                   { kind: 'requires',    fields: 'first_name and (domain or company_name)' },
     'limadata-work-email':       { kind: 'requires',    fields: 'first_name, last_name, and domain' },
-    blitzapi:                    { kind: 'requires',    fields: 'linkedin_url' },
-    'limadata-work-email-linkedin': { kind: 'requires', fields: 'linkedin_url' },
+    wiza:                        { kind: 'requires',    fields: 'linkedin_url or (first_name, last_name, and domain/company_name)' },
     'apollo-people-match':       { kind: 'requires',    fields: 'linkedin_url or (first_name, last_name, and domain/company_name)' },
-    'pdl-person-enrich':         { kind: 'requires',    fields: 'linkedin_url or (first_name, last_name, and domain/company_name)' },
   },
   // -------------------------------------------------------------------------
   verify_email: {},

package/src/utils/selection-insight.ts

@@ -73,23 +73,21 @@ const STRENGTHS: Partial<Record<InsightCapability, Record<string, string>>> = {
   },
   find_email: {
     prospeo: 'strong work-email coverage',
-    fullenrich: 'strong international email coverage, especially across Europe',
     findymail: 'high-accuracy verified work emails',
+    wiza: 'live SMTP-verified email reveals (premium)',
     icypeas: 'broad email-finding coverage',
     'limadata-work-email': 'name-and-domain work-email lookup',
-    blitzapi: 'LinkedIn-URL–based email finding',
-    'limadata-work-email-linkedin': 'LinkedIn-URL–based work-email lookup',
-    linkupapi: 'LinkedIn-sourced email finding',
+    leadmagic: 'pay-per-result email finding with employment verification',
+    'apollo-people-match': 'person-matched current-employer emails (recovers job movers)',
   },
   find_emails: {
     prospeo: 'strong work-email coverage',
-    fullenrich: 'strong international email coverage, especially across Europe',
     findymail: 'high-accuracy verified work emails',
+    wiza: 'live SMTP-verified email reveals (premium)',
     icypeas: 'broad email-finding coverage',
     'limadata-work-email': 'name-and-domain work-email lookup',
-    blitzapi: 'LinkedIn-URL–based email finding',
-    'limadata-work-email-linkedin': 'LinkedIn-URL–based work-email lookup',
-    linkupapi: 'LinkedIn-sourced email finding',
+    leadmagic: 'pay-per-result email finding with employment verification',
+    'apollo-people-match': 'person-matched current-employer emails (recovers job movers)',
   },
   verify_email: {
     findymail: 'reliable deliverability verification',

package/tests/bulk-tools.test.ts

@@ -8,6 +8,7 @@ vi.mock('../src/client.js', () => ({
 import { verifyEmailsBulkHandler } from '../src/tools/verify-emails-bulk.js'
 import { findEmailsBulkHandler } from '../src/tools/find-emails-bulk.js'
 import { getBulkJobHandler } from '../src/tools/get-bulk-job.js'
+import { cancelBulkJobHandler } from '../src/tools/cancel-bulk-job.js'
 
 beforeEach(() => {
   callApiMock.mockReset()
@@ -45,4 +46,20 @@ describe('bulk MCP tools', () => {
     const res = await verifyEmailsBulkHandler({ emails: ['a@x.com'] })
     expect(res.isError).toBe(true)
   })
+
+  it('cancel_bulk_job POSTs job_id in the path (empty body) to the cancel endpoint', async () => {
+    callApiMock.mockResolvedValue({ ok: true, status: 200, data: { job_id: 42, status: 'cancelled', items_total: 50, items_processed: 12 }, headers: {} })
+    const res = await cancelBulkJobHandler({ job_id: 42 })
+    const [method, path, body] = callApiMock.mock.calls[0]
+    expect(method).toBe('POST')
+    expect(path).toBe('/jobs/42/cancel')
+    expect(body).toEqual({})
+    expect(JSON.parse(res.content[0].text)).toMatchObject({ status: 'cancelled' })
+  })
+
+  it('cancel_bulk_job surfaces isError on a 400 (not cancellable)', async () => {
+    callApiMock.mockResolvedValue({ ok: false, status: 400, data: { error: "can't be cancelled" }, headers: {} })
+    const res = await cancelBulkJobHandler({ job_id: 42 })
+    expect(res.isError).toBe(true)
+  })
 })

package/tests/provider-availability.test.ts

@@ -8,7 +8,6 @@ import { findEmailsBulkSchema } from '../src/tools/find-emails-bulk.js'
 import { getEndpointDetailsSchema } from '../src/tools/get-endpoint-details.js'
 import { listDataSourcesHandler } from '../src/tools/list-data-sources.js'
 import {
-  CONFIGURED_FIND_EMAILS_PROVIDERS,
   FIND_EMAILS_PROVIDERS,
   getProvidersForCapability,
   resolvePreferredProviders,
@@ -44,14 +43,15 @@ describe('standalone MCP provider availability', () => {
   })
 
   it('keeps dormant definitions testable but removes them from every active waterfall', () => {
-    expect(getConfiguredProviders('find_email').some((provider) => provider.id === 'pdl-person-enrich')).toBe(true)
-    expect(CONFIGURED_FIND_EMAILS_PROVIDERS).toContain('pdl-person-enrich')
+    // pdl-person-enrich left find_email entirely (2026-07-24 reorder); the dormant
+    // PDL definition still lives in find_people for when the account is re-enabled.
+    expect(getConfiguredProviders('find_people').some((provider) => provider.id === 'pdl')).toBe(true)
 
     for (const capability of CAPABILITIES) {
       expect(getProviders(capability).every((provider) => isProviderEnabled(provider.id))).toBe(true)
     }
     expect(FIND_EMAILS_PROVIDERS.every(isProviderEnabled)).toBe(true)
-    expect(getProvidersForCapability('find_emails')).not.toContain('pdl-person-enrich')
+    expect(getProvidersForCapability('find_people')).not.toContain('pdl')
   })
 
   it('rejects an explicit disabled-provider pin without advertising it as available', () => {

package/tests/registry-polling.test.ts

@@ -30,11 +30,11 @@ describe('MCP polling interval schedules', () => {
     expect(evalPollSchedule(fn, 300_000).length).toBeGreaterThanOrEqual(10)
   })
 
-  it('FullEnrich find-email: 2.5s interval fits inside 60s timeout', () => {
+  it('Wiza find-email: 2.5s interval fits inside 60s timeout', () => {
     const providers = getProviders('find_email')
-    const fe = providers.find((p) => p.id === 'fullenrich')!
-    expect(fe?.async).toBeDefined()
-    expect(fe.async!.pollIntervalMs).toBe(2500)
+    const wiza = providers.find((p) => p.id === 'wiza')!
+    expect(wiza?.async).toBeDefined()
+    expect(wiza.async!.pollIntervalMs).toBe(2500)
     // timeoutMs = 60_000 → at least 24 polls
     expect(60_000 / 2500).toBeGreaterThanOrEqual(24)
   })

package/tests/registry.test.ts

@@ -651,59 +651,51 @@ describe('registry', () => {
       expect(prospeo.hasResult({ email: null })).toBe(false)
     })
 
-    it('FullEnrich maps to batch-of-1 with contact.emails field', () => {
+    it('Wiza maps a linkedin_url to a partial (email-only) individual reveal', () => {
       const providers = getProviders('find_email')
-      const fe = providers.find((p) => p.id === 'fullenrich')!
-      const result = fe.mapParams({
-        first_name: 'Michel',
-        last_name: 'Lieben',
-        domain: 'coldiq.com',
-        linkedin_url: 'https://linkedin.com/in/michel-lieben',
-      })
+      const wiza = providers.find((p) => p.id === 'wiza')!
+      const result = wiza.mapParams({ linkedin_url: 'https://linkedin.com/in/michel-lieben' })
       expect(result.body).toEqual({
-        name: 'mcp-enrich',
-        data: [{
-          first_name: 'Michel',
-          last_name: 'Lieben',
-          domain: 'coldiq.com',
-          linkedin_url: 'https://linkedin.com/in/michel-lieben',
-          enrich_fields: ['contact.emails'],
-        }],
+        individual_reveal: { profile_url: 'https://linkedin.com/in/michel-lieben' },
+        enrichment_level: 'partial',
+        email_options: { accept_work: true, accept_personal: false },
       })
     })
 
-    it('FullEnrich hasResult detects email in data[0].emails array', () => {
+    it('Wiza maps name+domain when no linkedin_url is supplied', () => {
       const providers = getProviders('find_email')
-      const fe = providers.find((p) => p.id === 'fullenrich')!
-      expect(fe.hasResult({ status: 'DONE', data: [{ emails: ['michel@coldiq.com'] }] })).toBe(true)
-      expect(fe.hasResult({ status: 'DONE', data: [{ emails: [] }] })).toBe(false)
-      expect(fe.hasResult({ status: 'DONE', data: [] })).toBe(false)
-      expect(fe.hasResult({ status: 'FAILED', data: [] })).toBe(false)
+      const wiza = providers.find((p) => p.id === 'wiza')!
+      const result = wiza.mapParams({ first_name: 'Michel', last_name: 'Lieben', domain: 'coldiq.com' })
+      expect((result.body as Record<string, unknown>).individual_reveal).toEqual({
+        full_name: 'Michel Lieben', domain: 'coldiq.com',
+      })
     })
 
-    it('FullEnrich has async config with correct poll endpoint', () => {
+    it('Wiza hasResult reads the reveal envelope; async polls the reveal id', () => {
       const providers = getProviders('find_email')
-      const fe = providers.find((p) => p.id === 'fullenrich')!
-      expect(fe.async).toBeDefined()
-      expect(fe.async!.pollEndpoint('abc-123')).toBe('/fullenrich/contact/enrich/bulk/abc-123')
-      expect(fe.async!.isComplete({ status: 'DONE' })).toBe(true)
-      expect(fe.async!.isComplete({ status: 'FAILED' })).toBe(true)
-      expect(fe.async!.isComplete({ status: 'IN_PROGRESS' })).toBe(false)
-      expect(fe.async!.extractId({ enrichment_id: 'abc-123' })).toBe('abc-123')
-    })
-
-    it('FullEnrich is priority 8 and LinkupAPI is priority 10 in the server-mirrored chain', () => {
+      const wiza = providers.find((p) => p.id === 'wiza')!
+      expect(wiza.hasResult({ data: { is_complete: true, email: 'michel@coldiq.com' } })).toBe(true)
+      expect(wiza.hasResult({ data: { is_complete: true, email: null } })).toBe(false)
+      expect(wiza.async).toBeDefined()
+      expect(wiza.async!.extractId({ data: { id: 12345 } })).toBe('12345')
+      expect(wiza.async!.pollEndpoint('12345')).toBe('/wiza/individual-reveals/12345')
+      expect(wiza.async!.isComplete({ data: { is_complete: true } })).toBe(true)
+      expect(wiza.async!.isComplete({ data: { status: 'failed' } })).toBe(true)
+      expect(wiza.async!.isComplete({ data: { is_complete: false } })).toBe(false)
+    })
+
+    it('Wiza is priority 4 (premium slot after the verifying trio)', () => {
       const providers = getProviders('find_email')
-      const fe = providers.find((p) => p.id === 'fullenrich')!
-      const lu = providers.find((p) => p.id === 'linkupapi')!
-      expect(fe.priority).toBe(8)
-      expect(lu.priority).toBe(10)
+      const wiza = providers.find((p) => p.id === 'wiza')!
+      expect(wiza.priority).toBe(4)
     })
 
-    it('leads with limadata-work-email, then leadmagic (mirrors the server order)', () => {
+    it('mirrors the server order: findymail → leadmagic → prospeo → wiza → apollo → limadata → icypeas', () => {
       const ids = getProviders('find_email').map((p) => p.id)
-      expect(ids[0]).toBe('limadata-work-email')
-      expect(ids[1]).toBe('leadmagic')
+      expect(ids).toEqual([
+        'findymail', 'leadmagic', 'prospeo', 'wiza',
+        'apollo-people-match', 'limadata-work-email', 'icypeas',
+      ])
     })
 
     it('Lima Data work-email maps full_name + company_domain', () => {
@@ -727,47 +719,6 @@ describe('registry', () => {
       expect(ld.hasResult({})).toBe(false)
     })
 
-    it('BlitzAPI maps person_linkedin_url from linkedin_url input', () => {
-      const providers = getProviders('find_email')
-      const blitz = providers.find((p) => p.id === 'blitzapi')!
-      const result = blitz.mapParams({
-        linkedin_url: 'https://linkedin.com/in/michel-lieben',
-      })
-      expect(result.body).toEqual({ person_linkedin_url: 'https://linkedin.com/in/michel-lieben' })
-    })
-
-    it('BlitzAPI isApplicable requires linkedin_url', () => {
-      const providers = getProviders('find_email')
-      const blitz = providers.find((p) => p.id === 'blitzapi')!
-      expect(blitz.isApplicable!({})).toBe(false)
-      expect(blitz.isApplicable!({ first_name: 'Michel', domain: 'coldiq.com' })).toBe(false)
-      expect(blitz.isApplicable!({ linkedin_url: 'https://...' })).toBe(true)
-    })
-
-    it('BlitzAPI hasResult checks top-level email', () => {
-      const providers = getProviders('find_email')
-      const blitz = providers.find((p) => p.id === 'blitzapi')!
-      expect(blitz.hasResult({ email: 'michel@coldiq.com' })).toBe(true)
-      expect(blitz.hasResult({ email: null })).toBe(false)
-    })
-
-    it('Lima Data work-email-linkedin maps linkedin_url passthrough', () => {
-      const providers = getProviders('find_email')
-      const ld = providers.find((p) => p.id === 'limadata-work-email-linkedin')!
-      const result = ld.mapParams({
-        linkedin_url: 'https://linkedin.com/in/michel-lieben',
-      })
-      expect(result.body).toEqual({ linkedin_url: 'https://linkedin.com/in/michel-lieben' })
-    })
-
-    it('Lima Data work-email-linkedin isApplicable requires linkedin_url', () => {
-      const providers = getProviders('find_email')
-      const ld = providers.find((p) => p.id === 'limadata-work-email-linkedin')!
-      expect(ld.isApplicable!({})).toBe(false)
-      expect(ld.isApplicable!({ first_name: 'Michel', domain: 'coldiq.com' })).toBe(false)
-      expect(ld.isApplicable!({ linkedin_url: 'https://...' })).toBe(true)
-    })
-
     it('Lima Data work-email isApplicable requires first_name + last_name + domain', () => {
       const providers = getProviders('find_email')
       const ld = providers.find((p) => p.id === 'limadata-work-email')!

package/tests/tools/list-data-sources.test.ts

@@ -25,7 +25,7 @@ describe('list_data_sources handler', () => {
     expect(names).toContain('TheirStack')
 
     const emails = rowFor(caps, 'find_email')!
-    expect(emails.sources.map((s) => s.name)).toContain('FullEnrich')
+    expect(emails.sources.map((s) => s.name)).toContain('Wiza')
   })
 
   it('never emits a raw slug or "Apify" in any source name', async () => {

package/tests/utils/provider-resolver.test.ts

@@ -79,11 +79,11 @@ describe('resolvePreferredProviders', () => {
 
   describe('Scenario C — gated provider', () => {
     it('requires gate: message says "requires X, which wasn\'t provided"', () => {
-      // blitzapi for find_email requires linkedin_url
-      const r = resolvePreferredProviders('find_email', { first_name: 'Michel', domain: 'coldiq.com' }, ['blitzapi'])
+      // wiza for find_email requires linkedin_url or full name + company signal
+      const r = resolvePreferredProviders('find_email', { first_name: 'Michel', domain: 'coldiq.com' }, ['wiza'])
       expect(r.ok).toBe(false)
       if (!r.ok) {
-        expect(r.error.error).toContain("'blitzapi' requires linkedin_url, which wasn't provided")
+        expect(r.error.error).toContain("'wiza' requires linkedin_url or (first_name, last_name, and domain/company_name), which wasn't provided")
         expect(r.error.error).toContain('ColdIQ will automatically pick the best tool')
       }
     })
@@ -104,14 +104,14 @@ describe('resolvePreferredProviders', () => {
     })
 
     it('succeeds when gated provider inputs are satisfied', () => {
-      // blitzapi requires linkedin_url
+      // wiza accepts a linkedin_url alone
       const r = resolvePreferredProviders(
         'find_email',
         { linkedin_url: 'https://www.linkedin.com/in/michel-lieben' },
-        ['blitzapi'],
+        ['wiza'],
       )
       expect(r.ok).toBe(true)
-      if (r.ok) expect(r.providers).toEqual(['blitzapi'])
+      if (r.ok) expect(r.providers).toEqual(['wiza'])
     })
   })
 
@@ -138,7 +138,7 @@ describe('resolvePreferredProviders', () => {
     })
 
     it('errors for provider not in find_emails', () => {
-      const r = resolvePreferredProviders('find_emails', {}, ['wiza'])
+      const r = resolvePreferredProviders('find_emails', {}, ['fullenrich'])
       expect(r.ok).toBe(false)
     })
   })

package/tests/utils/selection-insight.test.ts

@@ -35,11 +35,11 @@ describe('buildSelectionInsight', () => {
     it('states coverage without claiming it was the upfront best fit', () => {
       const r = buildSelectionInsight(
         'find_email',
-        'fullenrich',
+        'limadata-work-email',
         { domain: 'coldiq.com', first_name: 'Michel' },
         { wasFallback: true, pinnedByUser: false },
       )
-      expect(r!.insight).toContain('FullEnrich')
+      expect(r!.insight).toContain('Lima Data')
       expect(r!.insight).toContain('returned the match here')
       // never the confident "Routed to" framing on a fallthrough
       expect(r!.insight.startsWith('Routed to')).toBe(false)