@coldiq/mcp 0.1.0

package/tests/tools/fetch-page-content.test.ts

@@ -0,0 +1,108 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest'
+import { initClient } from '../../src/client.js'
+import { fetchPageContentHandler } from '../../src/tools/fetch-page-content.js'
+
+describe('fetch_page_content handler', () => {
+  const originalFetch = globalThis.fetch
+
+  beforeEach(() => {
+    initClient('http://test-api.local', 'test-key')
+  })
+
+  afterEach(() => {
+    globalThis.fetch = originalFetch
+  })
+
+  it('single URL — exa-contents returns results', async () => {
+    globalThis.fetch = vi.fn(async (url: string | URL | Request) => {
+      const u = url.toString()
+      if (u.includes('/exa/contents')) {
+        return new Response(JSON.stringify({
+          results: [{ url: 'https://coldiq.com', text: 'ColdIQ page text' }],
+        }), { status: 200 })
+      }
+      return new Response(JSON.stringify({ error: 'unexpected' }), { status: 500 })
+    }) as typeof fetch
+
+    const result = await fetchPageContentHandler({ urls: ['https://coldiq.com'] })
+
+    expect(result.isError).toBeFalsy()
+    const parsed = JSON.parse(result.content[0].text)
+    expect(parsed._meta.provider).toBe('exa-contents')
+    expect(parsed.data.results).toHaveLength(1)
+    expect(parsed.data.results[0].text).toBe('ColdIQ page text')
+  })
+
+  it('batch URLs — all returned in one call', async () => {
+    globalThis.fetch = vi.fn(async (url: string | URL | Request, opts?: RequestInit) => {
+      const u = url.toString()
+      if (u.includes('/exa/contents')) {
+        const body = JSON.parse((opts?.body as string) ?? '{}')
+        return new Response(JSON.stringify({
+          results: body.urls.map((pageUrl: string) => ({ url: pageUrl, text: `text for ${pageUrl}` })),
+        }), { status: 200 })
+      }
+      return new Response(JSON.stringify({ error: 'unexpected' }), { status: 500 })
+    }) as typeof fetch
+
+    const urls = ['https://coldiq.com', 'https://hubspot.com', 'https://salesforce.com']
+    const result = await fetchPageContentHandler({ urls })
+
+    expect(result.isError).toBeFalsy()
+    const parsed = JSON.parse(result.content[0].text)
+    expect(parsed._meta.provider).toBe('exa-contents')
+    expect(parsed.data.results).toHaveLength(3)
+  })
+
+  it('include_summary=true — summary flag forwarded to exa', async () => {
+    let capturedBody: Record<string, unknown> | null = null
+
+    globalThis.fetch = vi.fn(async (url: string | URL | Request, opts?: RequestInit) => {
+      const u = url.toString()
+      if (u.includes('/exa/contents')) {
+        capturedBody = JSON.parse((opts?.body as string) ?? '{}')
+        return new Response(JSON.stringify({
+          results: [{ url: 'https://coldiq.com', text: 'text', summary: 'summary text' }],
+        }), { status: 200 })
+      }
+      return new Response(JSON.stringify({ error: 'unexpected' }), { status: 500 })
+    }) as typeof fetch
+
+    await fetchPageContentHandler({ urls: ['https://coldiq.com'], include_summary: true })
+
+    expect(capturedBody).not.toBeNull()
+    expect(capturedBody!.summary).toEqual({})
+  })
+
+  it('include_summary=false (default) — no summary field in request', async () => {
+    let capturedBody: Record<string, unknown> | null = null
+
+    globalThis.fetch = vi.fn(async (url: string | URL | Request, opts?: RequestInit) => {
+      const u = url.toString()
+      if (u.includes('/exa/contents')) {
+        capturedBody = JSON.parse((opts?.body as string) ?? '{}')
+        return new Response(JSON.stringify({
+          results: [{ url: 'https://coldiq.com', text: 'text' }],
+        }), { status: 200 })
+      }
+      return new Response(JSON.stringify({ error: 'unexpected' }), { status: 500 })
+    }) as typeof fetch
+
+    await fetchPageContentHandler({ urls: ['https://coldiq.com'] })
+
+    expect(capturedBody).not.toBeNull()
+    expect(capturedBody!.summary).toBeUndefined()
+  })
+
+  it('provider fails — returns isError', async () => {
+    globalThis.fetch = vi.fn(async () => {
+      return new Response(JSON.stringify({ error: 'upstream error' }), { status: 502 })
+    }) as typeof fetch
+
+    const result = await fetchPageContentHandler({ urls: ['https://coldiq.com'] })
+
+    expect(result.isError).toBe(true)
+    const parsed = JSON.parse(result.content[0].text)
+    expect(parsed.error).toBeTruthy()
+  })
+})

package/tests/tools/find-influencers.test.ts

@@ -0,0 +1,91 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest'
+import { initClient } from '../../src/client.js'
+import { findInfluencersHandler } from '../../src/tools/find-influencers.js'
+
+describe('find_influencers handler', () => {
+  const originalFetch = globalThis.fetch
+
+  beforeEach(() => {
+    initClient('http://test-api.local', 'test-key')
+  })
+
+  afterEach(() => {
+    globalThis.fetch = originalFetch
+  })
+
+  it('handle set — influencers_similar fires first (lookalike route)', async () => {
+    let discoveryCalled = false
+
+    globalThis.fetch = vi.fn(async (url: string | URL | Request) => {
+      const u = url.toString()
+      if (u.includes('/influencers-club/discovery') && !u.includes('/creators/similar')) {
+        discoveryCalled = true
+      }
+      if (u.includes('/influencers-club/discovery/creators/similar')) {
+        return new Response(JSON.stringify({
+          creators: [{ handle: 'garyvee', platform: 'instagram', followers: 8_500_000 }],
+        }), { status: 200 })
+      }
+      return new Response(JSON.stringify({ error: 'unexpected' }), { status: 500 })
+    }) as typeof fetch
+
+    const result = await findInfluencersHandler({ platform: 'instagram', handle: 'hubspot', limit: 5 })
+
+    expect(result.isError).toBeFalsy()
+    const parsed = JSON.parse(result.content[0].text)
+    expect(parsed._meta.provider).toBe('influencers_similar')
+    expect(parsed.data.creators).toHaveLength(1)
+    expect(discoveryCalled).toBe(false)
+  })
+
+  it('no handle — influencers_similar skipped, influencers_discovery fires', async () => {
+    globalThis.fetch = vi.fn(async (url: string | URL | Request) => {
+      const u = url.toString()
+      if (u.includes('/influencers-club/discovery') && !u.includes('/creators/similar')) {
+        return new Response(JSON.stringify({
+          accounts: [{ handle: 'salesforce', platform: 'linkedin', followers: 1_200_000 }],
+        }), { status: 200 })
+      }
+      return new Response(JSON.stringify({ error: 'unexpected' }), { status: 500 })
+    }) as typeof fetch
+
+    const result = await findInfluencersHandler({ platform: 'linkedin', ai_search: 'B2B SaaS founders', limit: 5 })
+
+    expect(result.isError).toBeFalsy()
+    const parsed = JSON.parse(result.content[0].text)
+    expect(parsed._meta.provider).toBe('influencers_discovery')
+    expect(parsed.data.accounts).toHaveLength(1)
+  })
+
+  it('handle set but similar returns empty — falls back to influencers_discovery', async () => {
+    globalThis.fetch = vi.fn(async (url: string | URL | Request) => {
+      const u = url.toString()
+      if (u.includes('/influencers-club/discovery/creators/similar')) {
+        // hasResult fails: no creators/accounts array
+        return new Response(JSON.stringify({ creators: [] }), { status: 200 })
+      }
+      if (u.includes('/influencers-club/discovery') && !u.includes('/creators/similar')) {
+        return new Response(JSON.stringify({ accounts: [{ handle: 'techinfluencer' }] }), { status: 200 })
+      }
+      return new Response(JSON.stringify({ error: 'unexpected' }), { status: 500 })
+    }) as typeof fetch
+
+    const result = await findInfluencersHandler({ platform: 'instagram', handle: 'unknown_handle', limit: 5 })
+
+    expect(result.isError).toBeFalsy()
+    const parsed = JSON.parse(result.content[0].text)
+    expect(parsed._meta.provider).toBe('influencers_discovery')
+  })
+
+  it('all providers fail — returns isError', async () => {
+    globalThis.fetch = vi.fn(async () => {
+      return new Response(JSON.stringify({ error: 'down' }), { status: 503 })
+    }) as typeof fetch
+
+    const result = await findInfluencersHandler({ platform: 'instagram', limit: 5 })
+
+    expect(result.isError).toBe(true)
+    const parsed = JSON.parse(result.content[0].text)
+    expect(parsed.error).toBeTruthy()
+  })
+})

package/tests/tools/find-people.test.ts

@@ -0,0 +1,344 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest'
+import { initClient } from '../../src/client.js'
+import { findPeopleHandler } from '../../src/tools/find-people.js'
+
+describe('find_people handler', () => {
+  const originalFetch = globalThis.fetch
+
+  beforeEach(() => {
+    initClient('http://test-api.local', 'test-key')
+  })
+
+  afterEach(() => {
+    globalThis.fetch = originalFetch
+  })
+
+  it('falls back to Apollo when LeadsFactory async times out', async () => {
+    let callCount = 0
+    globalThis.fetch = vi.fn(async (url: string | URL | Request) => {
+      callCount++
+      const urlStr = url.toString()
+
+      // LeadsFactory create search — returns an ID
+      if (urlStr.includes('/leadsfactory/contact-finder/searches') && callCount === 1) {
+        return new Response(JSON.stringify({ _id: 'abc123', search_id: 'abc', nb_jobs_total: 1, progress_percentage: 0 }), { status: 201 })
+      }
+
+      // LeadsFactory poll — always RUNNING (will timeout)
+      if (urlStr.includes('/leadsfactory/contact-finder/searches/abc123')) {
+        return new Response(JSON.stringify({ id: 'abc123', search_id: 'abc', status: 'RUNNING', nb_jobs_total: 1, progress_percentage: 50 }), { status: 200 })
+      }
+
+      // Apollo — succeeds
+      if (urlStr.includes('/apollo/people/search')) {
+        return new Response(JSON.stringify({ people: [{ name: 'Michel Lieben', title: 'CEO' }] }), { status: 200 })
+      }
+
+      return new Response(JSON.stringify({ error: 'Not found' }), { status: 404 })
+    }) as typeof fetch
+
+    // Override timeout to 100ms so test runs fast
+    const { getProviders } = await import('../../src/registry.js')
+    const providers = getProviders('find_people')
+    const lf = providers.find((p) => p.id === 'leadsfactory')!
+    const originalTimeout = lf.async!.timeoutMs
+    const originalInterval = lf.async!.pollIntervalMs
+    lf.async!.timeoutMs = 100
+    lf.async!.pollIntervalMs = 20
+
+    try {
+      const result = await findPeopleHandler({
+        company_domains: ['coldiq.com'],
+        job_titles: ['CEO'],
+        limit: 5,
+      })
+
+      const parsed = JSON.parse(result.content[0].text)
+      // Should fall back to Apollo since LeadsFactory times out
+      expect(parsed._meta.provider).toBe('apollo')
+    } finally {
+      lf.async!.timeoutMs = originalTimeout
+      lf.async!.pollIntervalMs = originalInterval
+    }
+  })
+
+  it('returns LeadsFactory results when poll completes with companies_personas', async () => {
+    let callCount = 0
+    globalThis.fetch = vi.fn(async (url: string | URL | Request) => {
+      callCount++
+      const urlStr = url.toString()
+
+      // LeadsFactory create search
+      if (urlStr.includes('/leadsfactory/contact-finder/searches') && !urlStr.includes('abc123')) {
+        return new Response(JSON.stringify({ _id: 'abc123', search_id: 'abc', nb_jobs_total: 1, progress_percentage: 0 }), { status: 201 })
+      }
+
+      // LeadsFactory poll — first RUNNING, then SUCCESSFUL with contacts
+      if (urlStr.includes('/leadsfactory/contact-finder/searches/abc123')) {
+        if (callCount <= 3) {
+          return new Response(JSON.stringify({ id: 'abc123', search_id: 'abc', status: 'RUNNING', nb_jobs_total: 1, progress_percentage: 50 }), { status: 200 })
+        }
+        return new Response(JSON.stringify({
+          id: 'abc123',
+          search_id: 'abc',
+          status: 'SUCCESSFUL',
+          nb_jobs_total: 1,
+          nb_jobs_complete: 1,
+          companies_personas: [{ company: 'ColdIQ', contacts: [{ first_name: 'Michel', last_name: 'Lieben', title: 'CEO' }] }],
+        }), { status: 200 })
+      }
+
+      return new Response(JSON.stringify({ error: 'Not found' }), { status: 404 })
+    }) as typeof fetch
+
+    const { getProviders } = await import('../../src/registry.js')
+    const providers = getProviders('find_people')
+    const lf = providers.find((p) => p.id === 'leadsfactory')!
+    const originalTimeout = lf.async!.timeoutMs
+    const originalInterval = lf.async!.pollIntervalMs
+    lf.async!.timeoutMs = 500
+    lf.async!.pollIntervalMs = 20
+
+    try {
+      const result = await findPeopleHandler({
+        company_domains: ['coldiq.com'],
+        job_titles: ['CEO'],
+        limit: 5,
+      })
+
+      const parsed = JSON.parse(result.content[0].text)
+      expect(parsed._meta.provider).toBe('leadsfactory')
+      expect(parsed.data.companies_personas).toHaveLength(1)
+    } finally {
+      lf.async!.timeoutMs = originalTimeout
+      lf.async!.pollIntervalMs = originalInterval
+    }
+  })
+
+  it('gap-fills with Apollo for domains LeadsFactory missed (no_results_domains)', async () => {
+    globalThis.fetch = vi.fn(async (url: string | URL | Request, opts?: RequestInit) => {
+      const urlStr = url.toString()
+
+      // LeadsFactory create
+      if (urlStr.includes('/leadsfactory/contact-finder/searches') && !urlStr.includes('abc123')) {
+        return new Response(JSON.stringify({ _id: 'abc123', search_id: 'abc', nb_jobs_total: 2, progress_percentage: 0 }), { status: 201 })
+      }
+
+      // LeadsFactory poll — SUCCESSFUL with one miss
+      if (urlStr.includes('/leadsfactory/contact-finder/searches/abc123')) {
+        return new Response(JSON.stringify({
+          id: 'abc123', search_id: 'abc', status: 'SUCCESSFUL',
+          nb_jobs_total: 2, nb_jobs_complete: 2,
+          companies_personas: [{ company: 'ColdIQ', contacts: [{ first_name: 'Michel', last_name: 'Lieben' }] }],
+          no_results_domains: ['folk.app'],
+        }), { status: 200 })
+      }
+
+      // Apollo gap-fill for folk.app
+      if (urlStr.includes('/apollo/people/search')) {
+        const body = JSON.parse((opts?.body as string) ?? '{}')
+        if (body.q_organization_domains?.includes('folk.app')) {
+          return new Response(JSON.stringify({ people: [{ name: 'Thibaud Elziere', title: 'CEO' }] }), { status: 200 })
+        }
+      }
+
+      return new Response(JSON.stringify({ error: 'Not found' }), { status: 404 })
+    }) as typeof fetch
+
+    const { getProviders } = await import('../../src/registry.js')
+    const providers = getProviders('find_people')
+    const lf = providers.find((p) => p.id === 'leadsfactory')!
+    const originalTimeout = lf.async!.timeoutMs
+    const originalInterval = lf.async!.pollIntervalMs
+    lf.async!.timeoutMs = 500
+    lf.async!.pollIntervalMs = 20
+
+    try {
+      const result = await findPeopleHandler({
+        company_domains: ['coldiq.com', 'folk.app'],
+        job_titles: ['CEO'],
+        limit: 2,
+      })
+
+      const parsed = JSON.parse(result.content[0].text)
+      expect(parsed._meta.provider).toBe('leadsfactory')
+      expect(parsed.data.companies_personas).toHaveLength(1)
+      expect(parsed.data.gap_fill.provider).toBe('apollo')
+      expect(parsed.data.gap_fill.domains).toEqual(['folk.app'])
+      expect(parsed.data.gap_fill.people).toHaveLength(1)
+    } finally {
+      lf.async!.timeoutMs = originalTimeout
+      lf.async!.pollIntervalMs = originalInterval
+    }
+  })
+
+  it('skips gap-fill when input used LinkedIn URLs (no trusted domains to pass Apollo)', async () => {
+    let apolloCalled = false
+
+    globalThis.fetch = vi.fn(async (url: string | URL | Request) => {
+      const urlStr = url.toString()
+
+      if (urlStr.includes('/leadsfactory/contact-finder/searches') && !urlStr.includes('abc123')) {
+        return new Response(JSON.stringify({ _id: 'abc123', nb_jobs_total: 2, progress_percentage: 0 }), { status: 201 })
+      }
+
+      if (urlStr.includes('/leadsfactory/contact-finder/searches/abc123')) {
+        return new Response(JSON.stringify({
+          id: 'abc123', status: 'SUCCESSFUL', nb_jobs_total: 2, nb_jobs_complete: 2,
+          companies_personas: [{ company: 'ColdIQ', contacts: [{ first_name: 'Michel' }] }],
+          no_results_domains: ['folk.app'],
+        }), { status: 200 })
+      }
+
+      if (urlStr.includes('/apollo/people/search')) {
+        apolloCalled = true
+        return new Response(JSON.stringify({ people: [{ name: 'Thibaud Elziere' }] }), { status: 200 })
+      }
+
+      return new Response(JSON.stringify({ error: 'Not found' }), { status: 404 })
+    }) as typeof fetch
+
+    const { getProviders } = await import('../../src/registry.js')
+    const providers = getProviders('find_people')
+    const lf = providers.find((p) => p.id === 'leadsfactory')!
+    const originalTimeout = lf.async!.timeoutMs
+    const originalInterval = lf.async!.pollIntervalMs
+    lf.async!.timeoutMs = 500
+    lf.async!.pollIntervalMs = 20
+
+    try {
+      const result = await findPeopleHandler({
+        company_linkedin_urls: ['https://linkedin.com/company/coldiq', 'https://linkedin.com/company/folk'],
+        job_titles: ['CEO'],
+        limit: 2,
+      })
+
+      const parsed = JSON.parse(result.content[0].text)
+      expect(parsed._meta.provider).toBe('leadsfactory')
+      expect(parsed.data.gap_fill).toBeUndefined()
+      expect(apolloCalled).toBe(false)
+    } finally {
+      lf.async!.timeoutMs = originalTimeout
+      lf.async!.pollIntervalMs = originalInterval
+    }
+  })
+
+  it('does not pass company_domains to LeadsFactory when LinkedIn URLs are provided', async () => {
+    let capturedBody: Record<string, unknown> | null = null
+
+    globalThis.fetch = vi.fn(async (url: string | URL | Request, opts?: RequestInit) => {
+      const urlStr = url.toString()
+
+      if (urlStr.includes('/leadsfactory/contact-finder/searches') && !urlStr.includes('abc123')) {
+        capturedBody = JSON.parse((opts?.body as string) ?? '{}')
+        return new Response(JSON.stringify({ _id: 'abc123', nb_jobs_total: 2, progress_percentage: 0 }), { status: 201 })
+      }
+
+      if (urlStr.includes('/leadsfactory/contact-finder/searches/abc123')) {
+        return new Response(JSON.stringify({
+          id: 'abc123', status: 'SUCCESSFUL', nb_jobs_total: 2, nb_jobs_complete: 2,
+          companies_personas: [{ company: 'ColdIQ', contacts: [{ first_name: 'Michel' }] }],
+        }), { status: 200 })
+      }
+
+      return new Response(JSON.stringify({ error: 'Not found' }), { status: 404 })
+    }) as typeof fetch
+
+    const { getProviders } = await import('../../src/registry.js')
+    const providers = getProviders('find_people')
+    const lf = providers.find((p) => p.id === 'leadsfactory')!
+    const originalTimeout = lf.async!.timeoutMs
+    const originalInterval = lf.async!.pollIntervalMs
+    lf.async!.timeoutMs = 500
+    lf.async!.pollIntervalMs = 20
+
+    try {
+      await findPeopleHandler({
+        company_linkedin_urls: ['https://linkedin.com/company/coldiq', 'https://linkedin.com/company/folk'],
+        company_domains: ['coldiq.com', 'folk.app'],
+        job_titles: ['CEO'],
+        limit: 2,
+      })
+
+      expect(capturedBody).not.toBeNull()
+      expect(capturedBody!.company_linkedin_urls).toBeDefined()
+      expect(capturedBody!.company_domains).toBeUndefined()
+    } finally {
+      lf.async!.timeoutMs = originalTimeout
+      lf.async!.pollIntervalMs = originalInterval
+    }
+  })
+
+  it('sends each job title as a separate persona to LeadsFactory', async () => {
+    let capturedBody: Record<string, unknown> | null = null
+
+    globalThis.fetch = vi.fn(async (url: string | URL | Request, opts?: RequestInit) => {
+      const urlStr = url.toString()
+
+      if (urlStr.includes('/leadsfactory/contact-finder/searches') && !urlStr.includes('abc123')) {
+        capturedBody = JSON.parse((opts?.body as string) ?? '{}')
+        return new Response(JSON.stringify({ _id: 'abc123', nb_jobs_total: 1, progress_percentage: 0 }), { status: 201 })
+      }
+
+      if (urlStr.includes('/leadsfactory/contact-finder/searches/abc123')) {
+        return new Response(JSON.stringify({
+          id: 'abc123', status: 'SUCCESSFUL', nb_jobs_total: 1, nb_jobs_complete: 1,
+          companies_personas: [{ company: 'ColdIQ', contacts: [{ first_name: 'Michel' }] }],
+        }), { status: 200 })
+      }
+
+      return new Response(JSON.stringify({ error: 'Not found' }), { status: 404 })
+    }) as typeof fetch
+
+    const { getProviders } = await import('../../src/registry.js')
+    const providers = getProviders('find_people')
+    const lf = providers.find((p) => p.id === 'leadsfactory')!
+    const originalTimeout = lf.async!.timeoutMs
+    const originalInterval = lf.async!.pollIntervalMs
+    lf.async!.timeoutMs = 500
+    lf.async!.pollIntervalMs = 20
+
+    try {
+      await findPeopleHandler({
+        company_domains: ['coldiq.com'],
+        job_titles: ['CEO', 'VP of Sales'],
+        limit: 10,
+      })
+
+      expect(capturedBody).not.toBeNull()
+      expect(capturedBody!.search).toMatchObject({
+        max_persona_results: 10,
+        personas: [{ job_title: 'CEO' }, { job_title: 'VP of Sales' }],
+      })
+    } finally {
+      lf.async!.timeoutMs = originalTimeout
+      lf.async!.pollIntervalMs = originalInterval
+    }
+  })
+
+  it('falls back to Apollo when LeadsFactory fails', async () => {
+    globalThis.fetch = vi.fn(async (url: string | URL | Request) => {
+      const urlStr = url.toString()
+
+      if (urlStr.includes('/leadsfactory/')) {
+        return new Response(JSON.stringify({ error: 'Provider error' }), { status: 502 })
+      }
+
+      if (urlStr.includes('/apollo/people/search')) {
+        return new Response(JSON.stringify({ people: [{ name: 'Michel Lieben' }] }), { status: 200 })
+      }
+
+      return new Response(JSON.stringify({ error: 'Not found' }), { status: 404 })
+    }) as typeof fetch
+
+    const result = await findPeopleHandler({
+      company_domains: ['coldiq.com'],
+      job_titles: ['CEO'],
+      limit: 5,
+    })
+
+    const parsed = JSON.parse(result.content[0].text)
+    expect(parsed._meta.provider).toBe('apollo')
+    expect(parsed.data.people).toHaveLength(1)
+  })
+})

package/tests/tools/find-phone.test.ts

@@ -0,0 +1,100 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest'
+import { initClient } from '../../src/client.js'
+import { findPhoneHandler } from '../../src/tools/find-phone.js'
+
+describe('find_phone handler', () => {
+  const originalFetch = globalThis.fetch
+
+  beforeEach(() => {
+    initClient('http://test-api.local', 'test-key')
+  })
+
+  afterEach(() => {
+    globalThis.fetch = originalFetch
+  })
+
+  it('returns phone from FindyMail', async () => {
+    globalThis.fetch = vi.fn(async () =>
+      new Response(JSON.stringify({ phone: '+33612345678' }), { status: 200 })
+    ) as typeof fetch
+
+    const result = await findPhoneHandler({ linkedin_url: 'https://linkedin.com/in/michel-lieben' })
+
+    const parsed = JSON.parse(result.content[0].text)
+    expect(parsed._meta.provider).toBe('findymail')
+    expect(parsed.data.phone).toBe('+33612345678')
+  })
+
+  it('falls through to LimaData when Findymail misses', async () => {
+    let callCount = 0
+    globalThis.fetch = vi.fn(async (url: string | URL | Request) => {
+      callCount++
+      const urlStr = typeof url === 'string' ? url : url instanceof URL ? url.href : url.url
+      if (urlStr.includes('findymail')) return new Response(JSON.stringify({}), { status: 200 })
+      if (urlStr.includes('coldiq/find/phone')) return new Response(JSON.stringify({ phone: '+33698765432' }), { status: 200 })
+      return new Response(JSON.stringify({}), { status: 200 })
+    }) as typeof fetch
+
+    const result = await findPhoneHandler({ linkedin_url: 'https://linkedin.com/in/michel-lieben' })
+
+    const parsed = JSON.parse(result.content[0].text)
+    expect(result.isError).toBeFalsy()
+    expect(parsed._meta.provider).toBe('limadata')
+    expect(parsed.data.phone).toBe('+33698765432')
+  })
+
+  it('uses AI Ark when Findymail and LimaData both miss', async () => {
+    globalThis.fetch = vi.fn(async (url: string | URL | Request) => {
+      const urlStr = typeof url === 'string' ? url : url instanceof URL ? url.href : url.url
+      if (urlStr.includes('findymail')) return new Response(JSON.stringify({}), { status: 200 })
+      if (urlStr.includes('coldiq/find/phone')) return new Response(JSON.stringify({}), { status: 200 })
+      if (urlStr.includes('mobile-phone-finder')) return new Response(JSON.stringify({ data: [['+33611223344']] }), { status: 200 })
+      return new Response(JSON.stringify({}), { status: 200 })
+    }) as typeof fetch
+
+    const result = await findPhoneHandler({ linkedin_url: 'https://linkedin.com/in/michel-lieben' })
+
+    const parsed = JSON.parse(result.content[0].text)
+    expect(result.isError).toBeFalsy()
+    expect(parsed._meta.provider).toBe('ai-ark')
+    expect(parsed.data.data).toEqual([['+33611223344']])
+  })
+
+  it('uses LimaData and AI Ark when linkedin_url absent (name+domain path)', async () => {
+    globalThis.fetch = vi.fn(async (url: string | URL | Request) => {
+      const urlStr = typeof url === 'string' ? url : url instanceof URL ? url.href : url.url
+      if (urlStr.includes('coldiq/find/phone')) return new Response(JSON.stringify({}), { status: 200 })
+      if (urlStr.includes('mobile-phone-finder')) return new Response(JSON.stringify({ data: [['+33611223344']] }), { status: 200 })
+      return new Response(JSON.stringify({}), { status: 200 })
+    }) as typeof fetch
+
+    const result = await findPhoneHandler({
+      first_name: 'Michel',
+      last_name: 'Lieben',
+      company_domain: 'coldiq.com',
+    })
+
+    const parsed = JSON.parse(result.content[0].text)
+    expect(result.isError).toBeFalsy()
+    expect(parsed._meta.provider).toBe('ai-ark')
+  })
+
+  it('returns error with clear message when no valid input combo provided', async () => {
+    const result = await findPhoneHandler({ company_name: 'ColdIQ' })
+
+    expect(result.isError).toBe(true)
+    const parsed = JSON.parse(result.content[0].text)
+    expect(parsed.error).toContain('linkedin_url')
+    expect(parsed.error).toContain('first_name')
+  })
+
+  it('returns error when no provider finds a phone', async () => {
+    globalThis.fetch = vi.fn(async () =>
+      new Response(JSON.stringify({ error: 'Not found' }), { status: 404 })
+    ) as typeof fetch
+
+    const result = await findPhoneHandler({ linkedin_url: 'https://linkedin.com/in/unknown' })
+
+    expect(result.isError).toBe(true)
+  })
+})