@coldiq/mcp 5.4.6 → 5.4.8

package/dist/tools/get-website-visitors.js

@@ -2,13 +2,13 @@ import { z } from 'zod';
 import { callApi } from '../client.js';
 export const getWebsiteVisitorsName = 'get_website_visitors';
 export const getWebsiteVisitorsDescription = 'Read the leads ColdIQ Visitor ID identified on one of your websites — the people who visited (with verified work email, title and LinkedIn where available) or the companies they belong to (with firmographics). ' +
-    'Use `type: "people"` for enriched contacts and `type: "companies"` for enriched accounts. To find `website_id`, call the free `GET /visitor-id/websites` endpoint through call_endpoint (api "visitor-id"). ' +
+    'Use `type: "people"` for enriched contacts and `type: "companies"` for enriched accounts. To find `website_id`, call `list_website_visitors_sites`; to add a site, call `setup_website_visitors`. ' +
     'Results are paginated: pass the `cursor` from the previous response to fetch the next page. Free — identifications are billed when they are delivered, not when you read them.';
 export const getWebsiteVisitorsSchema = {
     website_id: z
         .number()
         .int()
-        .describe('The tracked website to read leads from, as returned by GET /visitor-id/websites.'),
+        .describe('The tracked website to read leads from, as returned by `list_website_visitors_sites`.'),
     type: z
         .enum(['people', 'companies'])
         .describe('"people" returns identified contacts (email, title, LinkedIn); "companies" returns identified accounts (firmographics).'),

package/dist/tools/get-website-visitors.js.map

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

package/dist/tools/list-website-visitors-sites.d.ts

@@ -0,0 +1,19 @@
+import { z } from 'zod';
+export declare const listWebsiteVisitorsSitesName = "list_website_visitors_sites";
+export declare const listWebsiteVisitorsSitesDescription: string;
+export declare const listWebsiteVisitorsSitesSchema: {
+    website_id: z.ZodOptional<z.ZodNumber>;
+};
+export declare function listWebsiteVisitorsSitesHandler(input: Record<string, unknown>): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+//# sourceMappingURL=list-website-visitors-sites.d.ts.map

package/dist/tools/list-website-visitors-sites.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-website-visitors-sites.d.ts","sourceRoot":"","sources":["../../src/tools/list-website-visitors-sites.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,eAAO,MAAM,4BAA4B,gCAAgC,CAAA;AAEzE,eAAO,MAAM,mCAAmC,QAImE,CAAA;AAEnH,eAAO,MAAM,8BAA8B;;CAM1C,CAAA;AASD,wBAAsB,+BAA+B,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;;;;;;GAsBnF"}

package/dist/tools/list-website-visitors-sites.js

@@ -0,0 +1,43 @@
+import { z } from 'zod';
+import { callApi } from '../client.js';
+export const listWebsiteVisitorsSitesName = 'list_website_visitors_sites';
+export const listWebsiteVisitorsSitesDescription = 'List the websites ColdIQ Visitor ID tracks for this account — each with its `id`, `domain`, `status`, whether it is `identifying` right now, and its `monthly_limit` (credits, companies, people, used_credits). ' +
+    'Pass `website_id` to get one website in full (pixel `embed_html` and `install` state; `install` null = state unknown, re-check later) together with its usage this period (people and companies identified, what it cost, and the live `credits_per_person` / `credits_per_company` — a person costs 6× a company; always quote these live values, never numbers from memory) — returned as `{ website, usage }`; when the usage read fails, `usage` is null and `usage_error` carries the status and message. ' +
+    'Free. Use the `id` as `website_id` in `get_website_visitors`; add a new site with `setup_website_visitors` (a 409 there whose message mentions a deactivated workspace means the domain is held by a deactivated workspace — do not retry, tell the user to contact ColdIQ support; any other 409 means the domain is already in this list — reuse it). ' +
+    'Any write (POST/PATCH/PUT/DELETE) returns 403 for a workspace member key — ask the workspace owner or an admin.';
+export const listWebsiteVisitorsSitesSchema = {
+    website_id: z
+        .number()
+        .int()
+        .optional()
+        .describe('Return this one website with its install state and usage instead of the list.'),
+};
+function failure(error, status, data) {
+    return {
+        content: [{ type: 'text', text: JSON.stringify({ error, status, data }) }],
+        isError: true,
+    };
+}
+export async function listWebsiteVisitorsSitesHandler(input) {
+    if (input.website_id === undefined) {
+        const res = await callApi('GET', '/visitor-id/websites');
+        if (!res.ok)
+            return failure('Failed to list tracked websites', res.status, res.data);
+        return { content: [{ type: 'text', text: JSON.stringify({ data: res.data }) }] };
+    }
+    const websiteId = input.website_id;
+    const [website, usage] = await Promise.all([
+        callApi('GET', `/visitor-id/websites/${websiteId}`),
+        callApi('GET', `/visitor-id/websites/${websiteId}/usage`),
+    ]);
+    if (!website.ok)
+        return failure('Failed to read tracked website', website.status, website.data);
+    // A failed usage read must not discard the website the caller asked for: the pixel
+    // and install state stay useful on their own, so the usage gap is reported next to
+    // them instead of replacing them.
+    const data = usage.ok
+        ? { website: website.data, usage: usage.data }
+        : { website: website.data, usage: null, usage_error: { status: usage.status, data: usage.data } };
+    return { content: [{ type: 'text', text: JSON.stringify({ data }) }] };
+}
+//# sourceMappingURL=list-website-visitors-sites.js.map

package/dist/tools/list-website-visitors-sites.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-website-visitors-sites.js","sourceRoot":"","sources":["../../src/tools/list-website-visitors-sites.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAEtC,MAAM,CAAC,MAAM,4BAA4B,GAAG,6BAA6B,CAAA;AAEzE,MAAM,CAAC,MAAM,mCAAmC,GAC9C,mNAAmN;IACnN,ifAAif;IACjf,0VAA0V;IAC1V,iHAAiH,CAAA;AAEnH,MAAM,CAAC,MAAM,8BAA8B,GAAG;IAC5C,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,GAAG,EAAE;SACL,QAAQ,EAAE;SACV,QAAQ,CAAC,+EAA+E,CAAC;CAC7F,CAAA;AAED,SAAS,OAAO,CAAC,KAAa,EAAE,MAAc,EAAE,IAAa;IAC3D,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QACnF,OAAO,EAAE,IAAI;KACd,CAAA;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,+BAA+B,CAAC,KAA8B;IAClF,IAAI,KAAK,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QACnC,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,KAAK,EAAE,sBAAsB,CAAC,CAAA;QACxD,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,OAAO,OAAO,CAAC,iCAAiC,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,CAAA;QACpF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,CAAA;IAC3F,CAAC;IAED,MAAM,SAAS,GAAG,KAAK,CAAC,UAAoB,CAAA;IAC5C,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACzC,OAAO,CAAC,KAAK,EAAE,wBAAwB,SAAS,EAAE,CAAC;QACnD,OAAO,CAAC,KAAK,EAAE,wBAAwB,SAAS,QAAQ,CAAC;KAC1D,CAAC,CAAA;IACF,IAAI,CAAC,OAAO,CAAC,EAAE;QAAE,OAAO,OAAO,CAAC,gCAAgC,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;IAE/F,mFAAmF;IACnF,mFAAmF;IACnF,kCAAkC;IAClC,MAAM,IAAI,GAAG,KAAK,CAAC,EAAE;QACnB,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE;QAC9C,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,EAAE,CAAA;IAEnG,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,CAAA;AACjF,CAAC"}

package/dist/tools/setup-website-visitors.d.ts

@@ -0,0 +1,21 @@
+import { z } from 'zod';
+export declare const setupWebsiteVisitorsName = "setup_website_visitors";
+export declare const setupWebsiteVisitorsDescription: string;
+export declare const setupWebsiteVisitorsSchema: {
+    domain: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+};
+export declare function setupWebsiteVisitorsHandler(input: Record<string, unknown>): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+}>;
+//# sourceMappingURL=setup-website-visitors.d.ts.map

package/dist/tools/setup-website-visitors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-website-visitors.d.ts","sourceRoot":"","sources":["../../src/tools/setup-website-visitors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,eAAO,MAAM,wBAAwB,2BAA2B,CAAA;AAEhE,eAAO,MAAM,+BAA+B,QAOyB,CAAA;AAErE,eAAO,MAAM,0BAA0B;;;CAMtC,CAAA;AAED,wBAAsB,2BAA2B,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;;;;;;;GAiB/E"}

package/dist/tools/setup-website-visitors.js

@@ -0,0 +1,36 @@
+import { z } from 'zod';
+import { callApi } from '../client.js';
+export const setupWebsiteVisitorsName = 'setup_website_visitors';
+export const setupWebsiteVisitorsDescription = 'Set up ColdIQ Visitor ID on a website the user owns: creates the tracked website for a domain and returns it with the ready-to-paste tracking pixel (`embed_html`, `script_url`) and its install state (`install.is_installed`). ' +
+    '`install` can be null: that means the install state is unknown — re-check later, never report "not installed" from null. ' +
+    'One pixel per domain: a 409 whose message mentions a deactivated workspace = the domain is held by a deactivated workspace — do not retry, tell the user to contact ColdIQ support; any other 409 = a pixel already exists for this domain — call `list_website_visitors_sites` and reuse it. ' +
+    'Any write (POST/PATCH/PUT/DELETE) returns 403 for a workspace member key — ask the workspace owner or an admin. ' +
+    'Setup and reads are free. Identifications are billed once the pixel is live, within the site\'s monthly limit; a person costs 6× a company. ' +
+    'Always quote the live `credits_per_person` / `credits_per_company` from `list_website_visitors_sites` with a `website_id`, never numbers from memory. ' +
+    'Read the identified leads afterwards with `get_website_visitors`.';
+export const setupWebsiteVisitorsSchema = {
+    domain: z
+        .string()
+        .min(1)
+        .describe('Website domain the tracking pixel will identify visitors for, e.g. "coldiq.com".'),
+    name: z.string().optional().describe('Display name for the website (defaults to the domain).'),
+};
+export async function setupWebsiteVisitorsHandler(input) {
+    const body = { domain: String(input.domain) };
+    if (input.name)
+        body.name = String(input.name);
+    const res = await callApi('POST', '/visitor-id/websites', body);
+    if (!res.ok) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({ error: 'Failed to set up website visitor identification', status: res.status, data: res.data }),
+                },
+            ],
+            isError: true,
+        };
+    }
+    return { content: [{ type: 'text', text: JSON.stringify({ data: res.data }) }] };
+}
+//# sourceMappingURL=setup-website-visitors.js.map

package/dist/tools/setup-website-visitors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-website-visitors.js","sourceRoot":"","sources":["../../src/tools/setup-website-visitors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAEtC,MAAM,CAAC,MAAM,wBAAwB,GAAG,wBAAwB,CAAA;AAEhE,MAAM,CAAC,MAAM,+BAA+B,GAC1C,mOAAmO;IACnO,2HAA2H;IAC3H,gSAAgS;IAChS,kHAAkH;IAClH,8IAA8I;IAC9I,wJAAwJ;IACxJ,mEAAmE,CAAA;AAErE,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,kFAAkF,CAAC;IAC/F,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wDAAwD,CAAC;CAC/F,CAAA;AAED,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAAC,KAA8B;IAC9E,MAAM,IAAI,GAA4B,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAA;IACtE,IAAI,KAAK,CAAC,IAAI;QAAE,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAE9C,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,MAAM,EAAE,sBAAsB,EAAE,IAAI,CAAC,CAAA;IAC/D,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,iDAAiD,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC;iBACvH;aACF;YACD,OAAO,EAAE,IAAI;SACd,CAAA;IACH,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,CAAA;AAC3F,CAAC"}

package/dist/utils/provider-resolver.js

@@ -9,8 +9,8 @@ export const CONFIGURED_FIND_EMAILS_PROVIDERS = [
     'findymail',
     'leadmagic',
     'prospeo',
-    'apollo-people-match',
     'limadata-work-email',
+    'apollo-people-match',
     'icypeas',
     'wiza',
 ];

package/package.json

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

package/src/index.ts

@@ -179,6 +179,20 @@ import {
   getWebsiteVisitorsHandler,
 } from './tools/get-website-visitors.js'
 
+import {
+  setupWebsiteVisitorsName,
+  setupWebsiteVisitorsDescription,
+  setupWebsiteVisitorsSchema,
+  setupWebsiteVisitorsHandler,
+} from './tools/setup-website-visitors.js'
+
+import {
+  listWebsiteVisitorsSitesName,
+  listWebsiteVisitorsSitesDescription,
+  listWebsiteVisitorsSitesSchema,
+  listWebsiteVisitorsSitesHandler,
+} from './tools/list-website-visitors-sites.js'
+
 import {
   listDataSourcesName,
   listDataSourcesDescription,
@@ -268,9 +282,11 @@ registerPublicTool(listSkillsName, listSkillsDescription, listSkillsSchema, list
 registerPublicTool(loadSkillName, loadSkillDescription, loadSkillSchema, loadSkillHandler)
 registerPublicTool(extractPostEngagementName, withKnowledgeFirstRequirement(extractPostEngagementDescription), extractPostEngagementSchema, extractPostEngagementHandler)
 registerPublicTool(getPlaceReviewsName, withKnowledgeFirstRequirement(getPlaceReviewsDescription), getPlaceReviewsSchema, getPlaceReviewsHandler)
-// ColdIQ Visitor ID: read the leads identified on the account's own websites.
-// Listing the websites themselves needs no tool — search_endpoints/call_endpoint
-// already reach GET /visitor-id/websites.
+// ColdIQ Visitor ID: set up a tracked website (one pixel per domain), list the
+// account's websites (with install state + usage), read the leads identified on them.
+// All three are free; identifications are billed when delivered.
+registerPublicTool(setupWebsiteVisitorsName, withKnowledgeFirstRequirement(setupWebsiteVisitorsDescription), setupWebsiteVisitorsSchema, setupWebsiteVisitorsHandler)
+registerPublicTool(listWebsiteVisitorsSitesName, withKnowledgeFirstRequirement(listWebsiteVisitorsSitesDescription), listWebsiteVisitorsSitesSchema, listWebsiteVisitorsSitesHandler)
 registerPublicTool(getWebsiteVisitorsName, withKnowledgeFirstRequirement(getWebsiteVisitorsDescription), getWebsiteVisitorsSchema, getWebsiteVisitorsHandler)
 // Generic endpoint discovery + invoke: reach any integrated provider without a dedicated tool.
 registerPublicTool(searchEndpointsName, withKnowledgeFirstRequirement(searchEndpointsDescription), searchEndpointsSchema, searchEndpointsHandler)

package/src/registry.ts

@@ -475,9 +475,12 @@ const searchCompaniesProviders: ProviderEntry[] = [
     id: 'apollo',
     endpoint: '/apollo/organizations/search',
     method: 'POST',
-    priority: 8,
+    // Keep Apollo behind the normal company databases. Its limited seat is a
+    // recovery source, before the costly Lima Data prospect and DiscoLike tails.
+    priority: 19,
     isApplicable: (input) => {
       // Apollo has no founded-year, technologies, funding, revenue, exclusion, or hiring filters — skip when set.
+      if (input.linkedin_search_url) return false
       if (typeof input.min_founded_year === 'number' || typeof input.max_founded_year === 'number') return false
       if (isNonEmptyArray(input.technologies)) return false
       if (isNonEmptyArray(input.funding_stages)) return false
@@ -891,7 +894,7 @@ const searchCompaniesProviders: ProviderEntry[] = [
     id: 'limadata-prospect-filter',
     endpoint: '/limadata/prospect/companies/filter',
     method: 'POST',
-    priority: 12,
+    priority: 20,
     mapParams: (input) => {
       // Lima Data prospect filter uses [{filter_type, values}]. We can only reliably
       // map company_headcount (size buckets); industries/locations need LinkedIn IDs.
@@ -923,7 +926,7 @@ const searchCompaniesProviders: ProviderEntry[] = [
     id: 'limadata-prospect-url',
     endpoint: '/limadata/prospect/companies/search-url',
     method: 'POST',
-    priority: 13,
+    priority: 21,
     mapParams: (input) => ({
       body: { search_url: input.linkedin_search_url as string },
     }),
@@ -1087,7 +1090,7 @@ const searchCompaniesProviders: ProviderEntry[] = [
     id: 'discolike',
     endpoint: '/discolike/discover',
     method: 'GET',
-    priority: 19,
+    priority: 22,
     isApplicable: (input) => {
       if (!isNonEmptyArray(input.similar_to_domains) && !isNonEmptyArray(input.keywords) && !isNonEmptyArray(input.industries)) return false
       if (isNonEmptyArray(input.locations)) return false
@@ -1277,7 +1280,8 @@ const findPeopleProviders: ProviderEntry[] = [
     id: 'apollo',
     endpoint: '/apollo/people/search',
     method: 'POST',
-    priority: 2,
+    // Apollo is the last active people-search recovery source in this mirror.
+    priority: 11,
     // Apollo caps per_page at 100 and rejects larger values with a 400. The
     // find_people schema permits limit up to 500 (a waterfall-wide ceiling),
     // so clamp here to keep Apollo from breaking the request when the caller
@@ -1614,7 +1618,7 @@ const findEmailProviders: ProviderEntry[] = [
     id: 'limadata-work-email',
     endpoint: '/limadata/find/work-email',
     method: 'POST',
-    priority: 5,
+    priority: 4,
     mapParams: (input) => {
       const fullName = [input.first_name, input.last_name].filter(Boolean).join(' ')
       return {
@@ -1711,7 +1715,7 @@ const findEmailProviders: ProviderEntry[] = [
     id: 'apollo-people-match',
     endpoint: '/apollo/people/match',
     method: 'POST',
-    priority: 4,
+    priority: 5,
     isApplicable: (input) =>
       (typeof input.linkedin_url === 'string' && (input.linkedin_url as string).length > 0) ||
       (!!input.first_name && !!input.last_name && !!(input.domain || input.company_name)),
@@ -2066,7 +2070,7 @@ const enrichCompanyProviders: ProviderEntry[] = [
     id: 'apollo',
     endpoint: '/apollo/organizations/enrich',
     method: 'POST',
-    priority: 3,
+    priority: 7,
     isApplicable: (input) => !!input.domain,
     mapParams: (input) => ({ body: { domain: input.domain } }),
     hasResult: (data) => {
@@ -2095,7 +2099,7 @@ const enrichCompanyProviders: ProviderEntry[] = [
     id: 'findymail',
     endpoint: '/findymail/search/company',
     method: 'POST',
-    priority: 9,
+    priority: 6,
     mapParams: (input) => ({
       body: {
         ...(input.domain ? { domain: input.domain } : {}),
@@ -3296,7 +3300,7 @@ const enrichPersonProviders: ProviderEntry[] = [
     id: 'apollo-people-match',
     endpoint: '/apollo/people/match',
     method: 'POST',
-    priority: 4,
+    priority: 11,
     mapParams: (input) => ({
       body: {
         first_name: input.first_name,
@@ -3414,7 +3418,7 @@ const enrichPersonProviders: ProviderEntry[] = [
     id: 'icypeas-reverse-email-lookup',
     endpoint: '/icypeas/reverse-email-lookup',
     method: 'POST',
-    priority: 11,
+    priority: 12,
     isApplicable: (input) => typeof input.email === 'string' && (input.email as string).includes('@'),
     mapParams: (input) => ({ body: { email: input.email } }),
     hasResult: isIcypeasReverseEmailFound,
@@ -3423,7 +3427,7 @@ const enrichPersonProviders: ProviderEntry[] = [
     id: 'pdl-person-identify',
     endpoint: '/pdl/person/identify',
     method: 'POST',
-    priority: 12,
+    priority: 13,
     mapParams: (input) => ({
       body: {
         email: input.email,

package/src/tools/get-website-visitors.ts

@@ -5,14 +5,14 @@ export const getWebsiteVisitorsName = 'get_website_visitors'
 
 export const getWebsiteVisitorsDescription =
   'Read the leads ColdIQ Visitor ID identified on one of your websites — the people who visited (with verified work email, title and LinkedIn where available) or the companies they belong to (with firmographics). ' +
-  'Use `type: "people"` for enriched contacts and `type: "companies"` for enriched accounts. To find `website_id`, call the free `GET /visitor-id/websites` endpoint through call_endpoint (api "visitor-id"). ' +
+  'Use `type: "people"` for enriched contacts and `type: "companies"` for enriched accounts. To find `website_id`, call `list_website_visitors_sites`; to add a site, call `setup_website_visitors`. ' +
   'Results are paginated: pass the `cursor` from the previous response to fetch the next page. Free — identifications are billed when they are delivered, not when you read them.'
 
 export const getWebsiteVisitorsSchema = {
   website_id: z
     .number()
     .int()
-    .describe('The tracked website to read leads from, as returned by GET /visitor-id/websites.'),
+    .describe('The tracked website to read leads from, as returned by `list_website_visitors_sites`.'),
   type: z
     .enum(['people', 'companies'])
     .describe('"people" returns identified contacts (email, title, LinkedIn); "companies" returns identified accounts (firmographics).'),

package/src/tools/list-website-visitors-sites.ts

@@ -0,0 +1,49 @@
+import { z } from 'zod'
+import { callApi } from '../client.js'
+
+export const listWebsiteVisitorsSitesName = 'list_website_visitors_sites'
+
+export const listWebsiteVisitorsSitesDescription =
+  'List the websites ColdIQ Visitor ID tracks for this account — each with its `id`, `domain`, `status`, whether it is `identifying` right now, and its `monthly_limit` (credits, companies, people, used_credits). ' +
+  'Pass `website_id` to get one website in full (pixel `embed_html` and `install` state; `install` null = state unknown, re-check later) together with its usage this period (people and companies identified, what it cost, and the live `credits_per_person` / `credits_per_company` — a person costs 6× a company; always quote these live values, never numbers from memory) — returned as `{ website, usage }`; when the usage read fails, `usage` is null and `usage_error` carries the status and message. ' +
+  'Free. Use the `id` as `website_id` in `get_website_visitors`; add a new site with `setup_website_visitors` (a 409 there whose message mentions a deactivated workspace means the domain is held by a deactivated workspace — do not retry, tell the user to contact ColdIQ support; any other 409 means the domain is already in this list — reuse it). ' +
+  'Any write (POST/PATCH/PUT/DELETE) returns 403 for a workspace member key — ask the workspace owner or an admin.'
+
+export const listWebsiteVisitorsSitesSchema = {
+  website_id: z
+    .number()
+    .int()
+    .optional()
+    .describe('Return this one website with its install state and usage instead of the list.'),
+}
+
+function failure(error: string, status: number, data: unknown) {
+  return {
+    content: [{ type: 'text' as const, text: JSON.stringify({ error, status, data }) }],
+    isError: true,
+  }
+}
+
+export async function listWebsiteVisitorsSitesHandler(input: Record<string, unknown>) {
+  if (input.website_id === undefined) {
+    const res = await callApi('GET', '/visitor-id/websites')
+    if (!res.ok) return failure('Failed to list tracked websites', res.status, res.data)
+    return { content: [{ type: 'text' as const, text: JSON.stringify({ data: res.data }) }] }
+  }
+
+  const websiteId = input.website_id as number
+  const [website, usage] = await Promise.all([
+    callApi('GET', `/visitor-id/websites/${websiteId}`),
+    callApi('GET', `/visitor-id/websites/${websiteId}/usage`),
+  ])
+  if (!website.ok) return failure('Failed to read tracked website', website.status, website.data)
+
+  // A failed usage read must not discard the website the caller asked for: the pixel
+  // and install state stay useful on their own, so the usage gap is reported next to
+  // them instead of replacing them.
+  const data = usage.ok
+    ? { website: website.data, usage: usage.data }
+    : { website: website.data, usage: null, usage_error: { status: usage.status, data: usage.data } }
+
+  return { content: [{ type: 'text' as const, text: JSON.stringify({ data }) }] }
+}

package/src/tools/setup-website-visitors.ts

@@ -0,0 +1,40 @@
+import { z } from 'zod'
+import { callApi } from '../client.js'
+
+export const setupWebsiteVisitorsName = 'setup_website_visitors'
+
+export const setupWebsiteVisitorsDescription =
+  'Set up ColdIQ Visitor ID on a website the user owns: creates the tracked website for a domain and returns it with the ready-to-paste tracking pixel (`embed_html`, `script_url`) and its install state (`install.is_installed`). ' +
+  '`install` can be null: that means the install state is unknown — re-check later, never report "not installed" from null. ' +
+  'One pixel per domain: a 409 whose message mentions a deactivated workspace = the domain is held by a deactivated workspace — do not retry, tell the user to contact ColdIQ support; any other 409 = a pixel already exists for this domain — call `list_website_visitors_sites` and reuse it. ' +
+  'Any write (POST/PATCH/PUT/DELETE) returns 403 for a workspace member key — ask the workspace owner or an admin. ' +
+  'Setup and reads are free. Identifications are billed once the pixel is live, within the site\'s monthly limit; a person costs 6× a company. ' +
+  'Always quote the live `credits_per_person` / `credits_per_company` from `list_website_visitors_sites` with a `website_id`, never numbers from memory. ' +
+  'Read the identified leads afterwards with `get_website_visitors`.'
+
+export const setupWebsiteVisitorsSchema = {
+  domain: z
+    .string()
+    .min(1)
+    .describe('Website domain the tracking pixel will identify visitors for, e.g. "coldiq.com".'),
+  name: z.string().optional().describe('Display name for the website (defaults to the domain).'),
+}
+
+export async function setupWebsiteVisitorsHandler(input: Record<string, unknown>) {
+  const body: Record<string, unknown> = { domain: String(input.domain) }
+  if (input.name) body.name = String(input.name)
+
+  const res = await callApi('POST', '/visitor-id/websites', body)
+  if (!res.ok) {
+    return {
+      content: [
+        {
+          type: 'text' as const,
+          text: JSON.stringify({ error: 'Failed to set up website visitor identification', status: res.status, data: res.data }),
+        },
+      ],
+      isError: true,
+    }
+  }
+  return { content: [{ type: 'text' as const, text: JSON.stringify({ data: res.data }) }] }
+}

package/src/utils/provider-resolver.ts

@@ -11,8 +11,8 @@ export const CONFIGURED_FIND_EMAILS_PROVIDERS = [
   'findymail',
   'leadmagic',
   'prospeo',
-  'apollo-people-match',
   'limadata-work-email',
+  'apollo-people-match',
   'icypeas',
   'wiza',
 ]

package/tests/executor.test.ts

@@ -310,7 +310,7 @@ describe('executor postFilter integration', () => {
   })
 
   it('invokes Apollo postFilter — strips accounts and drops wrong-country orgs → falls through to error', async () => {
-    // Apollo is at priority 7. Mock all higher-priority providers to return empty so Apollo is reached.
+    // Apollo is a late recovery source. Mock earlier providers so Apollo is reached.
     // Apollo returns orgs with wrong country + accounts key.
     // postFilter should: strip accounts, drop German org, keep no French orgs → hasResult false → error.
     let callCount = 0
@@ -348,7 +348,7 @@ describe('executor postFilter integration', () => {
   })
 
   it('passes raw data through unchanged when postFilter is not set (enrich_company)', async () => {
-    // enrich_company providers (companyenrich, apollo, pdl) have no postFilter.
+    // Company enrichment providers have no postFilter.
     // Verify a successful response is returned as-is.
     globalThis.fetch = vi.fn(async () =>
       new Response(JSON.stringify({ name: 'ColdIQ', domain: 'coldiq.com' }), { status: 200 })

package/tests/registry-enrich-person.test.ts

@@ -133,8 +133,8 @@ describe('apollo-people-match', () => {
     expect(p().hasResult({})).toBe(false)
   })
 
-  it('priority is 4', () => {
-    expect(p().priority).toBe(4)
+  it('priority is 11', () => {
+    expect(p().priority).toBe(11)
   })
 })
 
@@ -450,8 +450,8 @@ describe('pdl-person-identify', () => {
     expect(p().hasResult({ status: 404, matches: [] })).toBe(false)
   })
 
-  it('priority is 12 (last fallback)', () => {
-    expect(p().priority).toBe(12)
+  it('priority is 13 (last dormant fallback)', () => {
+    expect(p().priority).toBe(13)
   })
 })
 

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

@@ -897,8 +897,9 @@ describe('find_people priority ordering', () => {
     expect(providers()[0].id).toBe('leadsfactory')
   })
 
-  it('findymail-search-employees is last in the wired set (priority 10)', () => {
+  it('Apollo is last in the active wired set', () => {
     const ps = providers()
-    expect(ps[ps.length - 1].id).toBe('findymail-search-employees')
+    expect(ps[ps.length - 1].id).toBe('apollo')
+    expect(ps[ps.length - 1].priority).toBe(11)
   })
 })

package/tests/registry-search-companies.test.ts

@@ -291,6 +291,11 @@ describe('apollo search_companies', () => {
     const body = p().mapParams({ keywords: ['SaaS'] }).body as Record<string, unknown>
     expect(body.limit).toBe(25)
   })
+
+  it('is a recovery source and does not handle a LinkedIn search URL', () => {
+    expect(p().priority).toBe(19)
+    expect(p().isApplicable?.({ linkedin_search_url: 'https://www.linkedin.com/sales/search/company' })).toBe(false)
+  })
 })
 
 describe('theirstack search_companies', () => {
@@ -418,9 +423,13 @@ describe('search_companies priority ordering', () => {
     }
   })
 
-  it('discolike is last (priority 19), after ai-ark-companies (18)', () => {
+  it('keeps Apollo before the costly tail and DiscoLike last', () => {
     const ps = providers()
     expect(ps[ps.length - 1].id).toBe('discolike')
-    expect(ps[ps.length - 2].id).toBe('ai-ark-companies')
+    expect(ps[ps.length - 1].priority).toBe(22)
+    expect(ps.findIndex((provider) => provider.id === 'ai-ark-companies'))
+      .toBeLessThan(ps.findIndex((provider) => provider.id === 'apollo'))
+    expect(ps.findIndex((provider) => provider.id === 'apollo'))
+      .toBeLessThan(ps.findIndex((provider) => provider.id === 'limadata-prospect-filter'))
   })
 })

package/tests/registry.test.ts

@@ -472,17 +472,17 @@ describe('registry', () => {
         'fullenrich',
         'theirstack',
         'signalbase',
-        'apollo',
         'limadata',
         'predictleads',
         'sumble',
-        'limadata-prospect-filter',
-        'limadata-prospect-url',
         'linkupapi-search',
         'linkupapi-fundraising',
         'linkupapi-hiring',
         'prospeo-search-company',
         'ai-ark-companies',
+        'apollo',
+        'limadata-prospect-filter',
+        'limadata-prospect-url',
         'discolike',
       ])
     })
@@ -695,11 +695,11 @@ describe('registry', () => {
       expect(wiza.priority).toBe(7)
     })
 
-    it('mirrors the server order: findymail → leadmagic → prospeo → apollo → limadata → icypeas → wiza', () => {
+    it('mirrors the server order: findymail → leadmagic → prospeo → limadata → apollo → icypeas → wiza', () => {
       const ids = getProviders('find_email').map((p) => p.id)
       expect(ids).toEqual([
-        'findymail', 'leadmagic', 'prospeo', 'apollo-people-match',
-        'limadata-work-email', 'icypeas', 'wiza',
+        'findymail', 'leadmagic', 'prospeo', 'limadata-work-email',
+        'apollo-people-match', 'icypeas', 'wiza',
       ])
     })
 
@@ -798,8 +798,8 @@ describe('registry', () => {
     it('providers preserve their order with disabled providers omitted', () => {
       const ids = getProviders('enrich_company').map((p) => p.id)
       expect(ids).toEqual([
-        'apollo', 'limadata', 'prospeo',
-        'wiza', 'findymail', 'icypeas',
+        'limadata', 'prospeo', 'findymail',
+        'apollo', 'wiza', 'icypeas',
         'builtwith', 'openmart', 'linkupapi-by-domain', 'linkupapi-by-url', 'discolike',
       ])
     })
@@ -1215,6 +1215,7 @@ describe('registry', () => {
       expect(apollo.isApplicable!({ exclude_countries: ['CN'] })).toBe(false)
       expect(apollo.isApplicable!({ min_workforce_growth_pct: 10 })).toBe(false)
       expect(apollo.isApplicable!({ is_hiring: true })).toBe(false)
+      expect(apollo.isApplicable?.({ linkedin_search_url: 'https://www.linkedin.com/sales/search/company' })).toBe(false)
     })
 
     it('SignalBase isApplicable: skips for advanced filters it cannot apply', () => {