@coldiq/mcp 0.3.33 → 0.3.34

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -7,18 +7,21 @@ export declare const findEmailsBulkSchema: {
7
7
  first_name: z.ZodOptional<z.ZodString>;
8
8
  last_name: z.ZodOptional<z.ZodString>;
9
9
  domain: z.ZodOptional<z.ZodString>;
10
+ company_name: z.ZodOptional<z.ZodString>;
10
11
  linkedin_url: z.ZodOptional<z.ZodString>;
11
12
  }, "strip", z.ZodTypeAny, {
12
13
  domain?: string | undefined;
13
14
  id?: string | undefined;
14
15
  linkedin_url?: string | undefined;
15
16
  first_name?: string | undefined;
17
+ company_name?: string | undefined;
16
18
  last_name?: string | undefined;
17
19
  }, {
18
20
  domain?: string | undefined;
19
21
  id?: string | undefined;
20
22
  linkedin_url?: string | undefined;
21
23
  first_name?: string | undefined;
24
+ company_name?: string | undefined;
22
25
  last_name?: string | undefined;
23
26
  }>, "many">;
24
27
  webhook_url: z.ZodOptional<z.ZodString>;
@@ -1 +1 @@
1
- {"version":3,"file":"find-emails-bulk.d.ts","sourceRoot":"","sources":["../../src/tools/find-emails-bulk.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,eAAO,MAAM,kBAAkB,qBAAqB,CAAA;AAEpD,eAAO,MAAM,yBAAyB,QAUY,CAAA;AAElD,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;CAehC,CAAA;AAED,wBAAsB,qBAAqB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;GAGzE"}
1
+ {"version":3,"file":"find-emails-bulk.d.ts","sourceRoot":"","sources":["../../src/tools/find-emails-bulk.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,eAAO,MAAM,kBAAkB,qBAAqB,CAAA;AAEpD,eAAO,MAAM,yBAAyB,QAUwC,CAAA;AAE9E,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;CAgBhC,CAAA;AAED,wBAAsB,qBAAqB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;GAGzE"}
@@ -1,16 +1,16 @@
1
1
  import { z } from 'zod';
2
2
  import { callApi } from '../client.js';
3
3
  export const findEmailsBulkName = 'find_emails_bulk';
4
- export const findEmailsBulkDescription = 'Find professional emails for up to 5,000 people in one ASYNC job. Returns a job_id immediately this does NOT return emails inline. ' +
5
- 'Poll get_bulk_job(job_id) until status is "done" (usually minutes), then read the found/not_found summary and page through rows. ' +
6
- 'Each person should have first_name + last_name + domain (people missing those come back as not_found and are not charged). ' +
7
- 'Charged only per found email. A "found" row means an email was LOCATED, not verified deliverable: each row\'s ' +
4
+ export const findEmailsBulkDescription = 'Find professional emails for up to 5,000 people in one ASYNC job. Each row runs the SAME managed multi-provider ' +
5
+ 'waterfall as find_email a LinkedIn URL is searched directly, so pass it whenever you have it. Returns a job_id ' +
6
+ 'immediately this does NOT return emails inline. ' +
7
+ 'Poll get_bulk_job(job_id) until status is "done" (minutes for small jobs, up to a couple of hours for thousands of rows), then read the found/not_found summary and page through rows. ' +
8
+ 'A row is searchable with a linkedin_url alone, OR first_name + last_name + (domain or company_name); unsearchable rows come back as not_found and are not charged. ' +
9
+ 'Billing is per row, charge-on-success (no upfront reservation; misses are free). A "found" row means an email was LOCATED, not verified deliverable: each row\'s ' +
8
10
  'result carries a `confidence` (high/medium/unknown) — treat medium/unknown as unverified and run ' +
9
11
  'verify_emails_bulk before sending, or you risk bounces. A located email the provider itself flags as a low-confidence ' +
10
12
  'pattern guess comes back as verdict `guessed` instead of `found` and is FREE — never send a `guessed` email unverified. ' +
11
- 'The 202 response includes `credits_reserved` (worst-case hold, ' +
12
- 'settled to actual on completion) and a `low_balance_warning` when your balance is running low. For 50 or fewer people that ' +
13
- 'you want back inline, use find_emails instead.';
13
+ 'For 50 or fewer people that you want back inline, use find_emails instead.';
14
14
  export const findEmailsBulkSchema = {
15
15
  people: z
16
16
  .array(z.object({
@@ -18,11 +18,12 @@ export const findEmailsBulkSchema = {
18
18
  first_name: z.string().optional().describe('First name'),
19
19
  last_name: z.string().optional().describe('Last name'),
20
20
  domain: z.string().optional().describe('Company domain (e.g. "stripe.com")'),
21
- linkedin_url: z.string().optional().describe('LinkedIn profile URL (optional)'),
21
+ company_name: z.string().optional().describe('Company name company signal when the domain is unknown.'),
22
+ linkedin_url: z.string().optional().describe('LinkedIn profile URL — searchable on its own; pass it whenever you have it.'),
22
23
  }))
23
24
  .min(1)
24
25
  .max(5000)
25
- .describe('People to find emails for (1–5000). Each needs first_name + last_name + domain to be searched.'),
26
+ .describe('People to find emails for (1–5000). Searchable = linkedin_url alone, OR first_name + last_name + (domain or company_name).'),
26
27
  webhook_url: z.string().optional().describe('Optional URL POSTed when the whole job completes.'),
27
28
  };
28
29
  export async function findEmailsBulkHandler(input) {
@@ -1 +1 @@
1
- {"version":3,"file":"find-emails-bulk.js","sourceRoot":"","sources":["../../src/tools/find-emails-bulk.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAEtC,MAAM,CAAC,MAAM,kBAAkB,GAAG,kBAAkB,CAAA;AAEpD,MAAM,CAAC,MAAM,yBAAyB,GACpC,uIAAuI;IACvI,mIAAmI;IACnI,6HAA6H;IAC7H,gHAAgH;IAChH,mGAAmG;IACnG,wHAAwH;IACxH,0HAA0H;IAC1H,iEAAiE;IACjE,6HAA6H;IAC7H,gDAAgD,CAAA;AAElD,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,MAAM,EAAE,CAAC;SACN,KAAK,CACJ,CAAC,CAAC,MAAM,CAAC;QACP,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yFAAyF,CAAC;QAC7H,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC;QACxD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC;QACtD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;QAC5E,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;KAChF,CAAC,CACH;SACA,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,IAAI,CAAC;SACT,QAAQ,CAAC,gGAAgG,CAAC;IAC7G,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mDAAmD,CAAC;CACjG,CAAA;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,KAA8B;IACxE,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,MAAM,EAAE,yBAAyB,EAAE,KAAK,CAAC,CAAA;IACnE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,CAAA;AACnG,CAAC"}
1
+ {"version":3,"file":"find-emails-bulk.js","sourceRoot":"","sources":["../../src/tools/find-emails-bulk.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAEtC,MAAM,CAAC,MAAM,kBAAkB,GAAG,kBAAkB,CAAA;AAEpD,MAAM,CAAC,MAAM,yBAAyB,GACpC,kHAAkH;IAClH,mHAAmH;IACnH,oDAAoD;IACpD,yLAAyL;IACzL,qKAAqK;IACrK,mKAAmK;IACnK,mGAAmG;IACnG,wHAAwH;IACxH,0HAA0H;IAC1H,4EAA4E,CAAA;AAE9E,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,MAAM,EAAE,CAAC;SACN,KAAK,CACJ,CAAC,CAAC,MAAM,CAAC;QACP,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yFAAyF,CAAC;QAC7H,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC;QACxD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC;QACtD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;QAC5E,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2DAA2D,CAAC;QACzG,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6EAA6E,CAAC;KAC5H,CAAC,CACH;SACA,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,IAAI,CAAC;SACT,QAAQ,CAAC,4HAA4H,CAAC;IACzI,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mDAAmD,CAAC;CACjG,CAAA;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,KAA8B;IACxE,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,MAAM,EAAE,yBAAyB,EAAE,KAAK,CAAC,CAAA;IACnE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,CAAA;AACnG,CAAC"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@coldiq/mcp",
3
- "version": "0.3.33",
3
+ "version": "0.3.34",
4
4
  "type": "module",
5
5
  "main": "dist/index.js",
6
6
  "bin": {
@@ -4,16 +4,16 @@ import { callApi } from '../client.js'
4
4
  export const findEmailsBulkName = 'find_emails_bulk'
5
5
 
6
6
  export const findEmailsBulkDescription =
7
- 'Find professional emails for up to 5,000 people in one ASYNC job. Returns a job_id immediately this does NOT return emails inline. ' +
8
- 'Poll get_bulk_job(job_id) until status is "done" (usually minutes), then read the found/not_found summary and page through rows. ' +
9
- 'Each person should have first_name + last_name + domain (people missing those come back as not_found and are not charged). ' +
10
- 'Charged only per found email. A "found" row means an email was LOCATED, not verified deliverable: each row\'s ' +
7
+ 'Find professional emails for up to 5,000 people in one ASYNC job. Each row runs the SAME managed multi-provider ' +
8
+ 'waterfall as find_email a LinkedIn URL is searched directly, so pass it whenever you have it. Returns a job_id ' +
9
+ 'immediately this does NOT return emails inline. ' +
10
+ 'Poll get_bulk_job(job_id) until status is "done" (minutes for small jobs, up to a couple of hours for thousands of rows), then read the found/not_found summary and page through rows. ' +
11
+ 'A row is searchable with a linkedin_url alone, OR first_name + last_name + (domain or company_name); unsearchable rows come back as not_found and are not charged. ' +
12
+ 'Billing is per row, charge-on-success (no upfront reservation; misses are free). A "found" row means an email was LOCATED, not verified deliverable: each row\'s ' +
11
13
  'result carries a `confidence` (high/medium/unknown) — treat medium/unknown as unverified and run ' +
12
14
  'verify_emails_bulk before sending, or you risk bounces. A located email the provider itself flags as a low-confidence ' +
13
15
  'pattern guess comes back as verdict `guessed` instead of `found` and is FREE — never send a `guessed` email unverified. ' +
14
- 'The 202 response includes `credits_reserved` (worst-case hold, ' +
15
- 'settled to actual on completion) and a `low_balance_warning` when your balance is running low. For 50 or fewer people that ' +
16
- 'you want back inline, use find_emails instead.'
16
+ 'For 50 or fewer people that you want back inline, use find_emails instead.'
17
17
 
18
18
  export const findEmailsBulkSchema = {
19
19
  people: z
@@ -23,12 +23,13 @@ export const findEmailsBulkSchema = {
23
23
  first_name: z.string().optional().describe('First name'),
24
24
  last_name: z.string().optional().describe('Last name'),
25
25
  domain: z.string().optional().describe('Company domain (e.g. "stripe.com")'),
26
- linkedin_url: z.string().optional().describe('LinkedIn profile URL (optional)'),
26
+ company_name: z.string().optional().describe('Company name company signal when the domain is unknown.'),
27
+ linkedin_url: z.string().optional().describe('LinkedIn profile URL — searchable on its own; pass it whenever you have it.'),
27
28
  }),
28
29
  )
29
30
  .min(1)
30
31
  .max(5000)
31
- .describe('People to find emails for (1–5000). Each needs first_name + last_name + domain to be searched.'),
32
+ .describe('People to find emails for (1–5000). Searchable = linkedin_url alone, OR first_name + last_name + (domain or company_name).'),
32
33
  webhook_url: z.string().optional().describe('Optional URL POSTed when the whole job completes.'),
33
34
  }
34
35