@coldiq/mcp 0.3.39 → 0.3.41

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

@@ -24,6 +24,7 @@ export const findPhoneBulkSchema = {
     .max(5000)
     .describe('People to find phone numbers for (1–5000). Each needs a linkedin_url, or name + company_domain/name.'),
   webhook_url: z.string().optional().describe('Optional URL POSTed when the whole job completes.'),
+  max_credits: z.number().positive().optional().describe('Per-row spend cap: a provider that would return a number but costs more than this is skipped (the row comes back not_found rather than overspending). Phone lookups can be 10+ credits — this bounds them.'),
 }
 
 export async function findPhoneBulkHandler(input: Record<string, unknown>) {

package/src/tools/find-phone.ts

@@ -14,6 +14,7 @@ export const findPhoneSchema = {
   company_domain: z.string().optional().describe('Company domain, e.g. coldiq.com'),
   company_name: z.string().optional().describe('Company name (alternative to company_domain)'),
   use_providers: z.array(z.string()).optional().describe(`Optional ordered list of providers to use. Leave empty to let ColdIQ automatically pick the best tool for your inputs — recommended for most use cases. Available providers: ${getProvidersForCapability('find_phone').join(', ')}. Provider names are matched fuzzily, so minor typos are tolerated.`),
+  max_credits: z.number().positive().optional().describe('Per-record spend cap: a provider that would return a number but costs more than this is skipped, so you never pay more than N credits for one phone (returns not_found if nothing answers in budget). Phone lookups can be 10+ credits — this bounds them.'),
 }
 
 export async function findPhoneHandler(input: Record<string, unknown>) {

package/src/tools/verify-email.ts

@@ -5,7 +5,7 @@ import { getProvidersForCapability } from '../utils/provider-resolver.js'
 export const verifyEmailName = 'verify_email'
 
 export const verifyEmailDescription =
-  'Check whether an email address is valid and deliverable. Returns a normalized `status` field — one of "valid", "invalid", "catch_all", "risky", "disposable", "unknown" — alongside the raw provider response. Findymail (the default) only distinguishes valid vs invalid; richer status values come from providers like icypeas, instantly, or linkupapi. Use before cold outreach to protect sender reputation. ColdIQ automatically picks the best provider — pass use_providers only if you need a specific tool.'
+  'Check whether an email address is valid and deliverable. Returns a normalized `status` field — one of "valid", "invalid", "catch_all", "risky", "disposable", "unknown" — alongside the raw provider response. BounceBan leads the waterfall: it resolves catch-all and risky addresses without sending (the gap most verifiers leave as "unknown"); if it cannot conclude, the chain falls through to leadmagic, findymail, icypeas, instantly, and linkupapi. Findymail only distinguishes valid vs invalid. Use before cold outreach to protect sender reputation. ColdIQ automatically runs the waterfall — pass use_providers only if you need a specific tool.'
 
 export const verifyEmailSchema = {
   email: z.string().email().describe('Email address to verify'),

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

@@ -12,10 +12,12 @@ export const verifyEmailsBulkDescription =
   'means the address was SKIPPED (rate-limited / never checked) and is safe to re-submit — do not discard those contacts; ' +
   'only `provider_indeterminate` (or no reason) is a real "couldn\'t determine". ' +
   'The 202 response includes `credits_reserved` (worst-case hold, settled to actual on completion) and a `low_balance_warning` when low. ' +
+  'PROVIDER: runs on BounceBan by default — it resolves catch-all/risky addresses without sending (~0.2 credits per conclusively-verified email). If the BounceBan submit fails, the job AUTOMATICALLY falls back to Icypeas (0.1 credits/verified, no catch-all resolution) — bulk verify survives a single-provider outage. Pinning use_providers:["bounceban"] or ["icypeas"] is STRICT: a pinned backend\'s failure returns an error instead of switching. Any other verifier returns a clear error (never silently ignored). ' +
   'For a single email use verify_email instead.'
 
 export const verifyEmailsBulkSchema = {
   emails: z.array(z.string()).min(1).max(5000).describe('Emails to verify (1–5000). Invalid/duplicate entries are dropped server-side.'),
+  use_providers: z.array(z.string()).optional().describe('Provider pin. Omit for the default: BounceBan (catch-all/risky resolution, ~0.2 cr/verified) with automatic Icypeas failover (0.1 cr/verified). An explicit "bounceban" or "icypeas" pin is strict — its backend\'s failure returns an error, never a silent switch. Any other verifier returns a clear error.'),
   webhook_url: z.string().optional().describe('Optional URL POSTed when the whole job completes.'),
 }
 

package/src/verb-client.ts

@@ -42,7 +42,7 @@ export async function callVerb(
     }
   }
 
-  const { use_providers, fields, reveal, resolve_current_employer, ...rest } = work
+  const { use_providers, fields, reveal, resolve_current_employer, max_credits, ...rest } = work
 
   // 2. Resolve the provider pin: explicit use_providers wins; otherwise a
   //    tool-specific provider field (e.g. search_places `provider`).
@@ -68,6 +68,8 @@ export async function callVerb(
   if (fields !== undefined) envelope.fields = fields
   if (reveal !== undefined) envelope.reveal = reveal
   if (resolve_current_employer !== undefined) envelope.resolve_current_employer = resolve_current_employer
+  // Top-level (never inside `input`) so it applies to the single OR bulk envelope.
+  if (max_credits !== undefined) envelope.max_credits = max_credits
 
   const res = await callApi('POST', verbPath, envelope)
 

package/tests/gtm/README.md

@@ -8,8 +8,8 @@ End-to-end scenarios that verify the MCP server routes plain-English prompts to
 |---|---|
 | `COLDIQ_API_KEY` | ColdIQ API key (live provider calls) |
 | `COLDIQ_API_URL` | API base URL (default: `http://localhost:8787`) |
-| `ANTHROPIC_API_KEY` | Anthropic API key (Claude agent loop) |
-| `AGENT_MODEL` | Override Claude model (default: `claude-sonnet-4-6`) |
+| `ANTHROPIC_API_KEY` | Anthropic API key for this standalone evaluation driver |
+| `GTM_EVAL_MODEL` | Optional evaluation override; defaults to the primary model in `src/agent/model-policy.ts` |
 
 ## Run commands
 

package/tests/gtm/harness.ts

@@ -4,6 +4,7 @@ import * as fs from 'node:fs'
 import * as path from 'node:path'
 import * as url from 'node:url'
 
+import { MODEL_PROFILES } from '../../../src/agent/model-policy.js'
 import { MCP_TOOLS } from './tools-bridge.js'
 
 export interface ToolCall {
@@ -40,7 +41,7 @@ export async function runAgent(options: RunAgentOptions): Promise<AgentResult> {
   const {
     prompt,
     maxToolCalls = 8,
-    model = process.env.AGENT_MODEL ?? 'claude-sonnet-4-6',
+    model = process.env.GTM_EVAL_MODEL ?? MODEL_PROFILES.agent.models[0].model,
   } = options
 
   const client = new Anthropic({ apiKey: process.env.ANTHROPIC_API_KEY })

package/tests/registry-linkupapi.test.ts

@@ -181,9 +181,9 @@ describe('linkupapi provider — verify_email', () => {
   const providers = getProviders('verify_email')
   const lv = providers.find((p) => p.id === 'linkupapi-validate')!
 
-  it('is registered at priority 5 (leadmagic joined at 1)', () => {
+  it('is registered at priority 6 (bounceban joined at 1)', () => {
     expect(lv).toBeDefined()
-    expect(lv.priority).toBe(5)
+    expect(lv.priority).toBe(6)
   })
 
   it('maps email', () => {

package/tests/registry.test.ts

@@ -780,8 +780,8 @@ describe('registry', () => {
   })
 
   describe('verify_email', () => {
-    it('providers are ordered leadmagic → findymail → icypeas → instantly → linkupapi-validate', () => {
-      expect(getProviders('verify_email').map((p) => p.id)).toEqual(['leadmagic', 'findymail', 'icypeas', 'instantly', 'linkupapi-validate'])
+    it('providers are ordered bounceban → leadmagic → findymail → icypeas → instantly → linkupapi-validate', () => {
+      expect(getProviders('verify_email').map((p) => p.id)).toEqual(['bounceban', 'leadmagic', 'findymail', 'icypeas', 'instantly', 'linkupapi-validate'])
     })
 
     it('FindyMail hasResult accepts verified field', () => {