@sellable/mcp 0.1.231 → 0.1.233

package/dist/tools/leads.js

@@ -522,6 +522,7 @@ search_prospeo_companies({
   }
 })
 Do not invent company_oids. When seedCompanies or seedDomains are present, omit company_oids and let the backend resolve real Prospeo company IDs.
+For customer, best-customer, top-customer, or past-company lookalikes, never substitute the sender's current company or domain as a lookalike seed and never use the sender's current company/domain as a silent substitute. Use explicit customer/account/company/domain input first, then verified customer/worked-with/past-company evidence from research/proof, then ask for the missing seed or switch to non-lookalike company filters if YOLO requires moving without a seed. Label profile/work-history seeds as past-company/public proof clues, not confirmed customers unless the source proves customer status. If the user asks for a geography like Germany, preserve it in company discovery where supported and in the follow-on people search.
 After account approval, copy the companySearchToken exactly into confirm_prospeo_company_accounts; package-backed MCP may return a short mcp-prospeo-company-search-token:* reference to avoid long-token copy errors.
 For accounts in the news: { "company_news": { "categories": ["Funding & Investment"], "timeframe_days": 90 } }.
 For awards: { "company_awards": { "include": ["G2"], "match_mode": "CONTAINS" } }.
@@ -1497,7 +1498,8 @@ export const leadToolDefinitions = [
     },
     {
         name: "search_prospeo_companies",
-        description: 'Search Prospeo for company/account results through the public /search-company lane. Requires get_provider_prompt({ provider: "prospeo" }) first. Use this first for company lookalike/account asks such as "find companies like Red Rover that use AI and have an API", "find founders at companies like our best customers", or "find accounts in the news about funding or partnerships". Results are accounts, not finished people leads. Review the returned accounts with the user, then call confirm_prospeo_company_accounts with the companySearchToken to create a domainFilterId before using search_prospeo for people at those accounts. Supports company lookalike, confirmed AI Attributes including pricing, company news, awards, website search, products/services, integrations, key customers, operating languages, Google discovery, headcount by location, structured company ICP, and experimental website traffic/key executive filters. Do not invent company_oids; when seedCompanies or seedDomains are present, omit company_oids and let the backend resolve real Prospeo IDs. company_intent and support-channel guesses like phone/email/chat/ticket/social are unsupported. Public API rows do not include lookalike tier/score/reason. ' +
+        description: 'Search Prospeo for company/account results through the public /search-company lane. Requires get_provider_prompt({ provider: "prospeo" }) first. Use this first for company lookalike/account asks such as "find companies like Red Rover that use AI and have an API", "find founders at companies like our best customers", or "find accounts in the news about funding or partnerships". Results are accounts, not finished people leads. Review the returned accounts with the user, then call confirm_prospeo_company_accounts with the companySearchToken to create a domainFilterId before using search_prospeo for people at those accounts. Supports company lookalike, confirmed AI Attributes including pricing, company news, awards, website search, products/services, integrations, key customers, operating languages, Google discovery, headcount by location, structured company ICP, and experimental website traffic/key executive filters. Do not invent company_oids; when seedCompanies or seedDomains are present, omit company_oids and let the backend resolve real Prospeo IDs. company_intent and support-channel guesses like phone/email/chat/ticket/social are unsupported. Public API rows do not include lookalike tier/score/reason. If output includes omittedFilters or warnings, report them as truthful MCP/backend safety handling rather than claiming Prospeo enforced those omitted constraints. ' +
+            "For best-customer, top-customer, customer, or past-company lookalikes, never substitute the sender's current company/domain as the seed unless current-company peers were explicitly requested; use explicit or verified customer/account/past-company seeds and preserve geography like Germany in account or people filters. " +
             prospeoCompanyAccountWorkflowGuidance,
         inputSchema: {
             type: "object",
@@ -1630,7 +1632,7 @@ export const leadToolDefinitions = [
     },
     {
         name: "search_prospeo",
-        description: 'Search Prospeo for people using filters and optional domainFilterId. Requires get_provider_prompt({ provider: "prospeo" }) first. Use Prospeo first for hiring-led targeting because it supports company_job_posting_hiring_for and company_job_posting_quantity; Sales Nav does not filter companies by hiring role. When targeting known accounts, call load_csv_domains for CSV-on-disk workflows or save_domain_filters for pasted/raw domain lists, then pass domainFilterId. For company lookalike/account asks, call search_prospeo_companies first, review accounts, then confirm_prospeo_company_accounts to create a domainFilterId before using search_prospeo for people. Raw domain inputs and company-name targeting are NOT supported in this MCP tool. Strategy: start with 2-3 high-signal filters (title/seniority + industry or domainFilterId + headcount), add job-posting filters for hiring-led campaigns, then tighten one filter at a time. For security, AppSec, SOC, RevOps, Demand Gen, and similar function-specific lanes, do not widen with bare seniority labels like "Head" or "Director" alone; pair them with explicit function-title keywords and inspect the sample for off-function `Head of X` leakage. Prefer person location over company HQ unless HQ is explicitly needed. `campaignOfferId` routing rule: OMIT campaignOfferId ONLY in pre-mint Phase 84 `find leads` discovery mode (validating ICP before the commit gate). In every other context — post-mint lead additions, operator-driven searches on a live campaign, any search where the intent is to persist results to a specific campaign — you MUST pass campaignOfferId so the search shows up in that campaign\'s Contact Search panel. Post-mint create-campaign-v2 watch runs MUST pass currentStep: "prospeo". Omitting campaignOfferId post-mint orphans the search from the UI. Returns normalized results with pagination.',
+        description: 'Search Prospeo for people using filters and optional domainFilterId. Requires get_provider_prompt({ provider: "prospeo" }) first. Use Prospeo first for hiring-led targeting because it supports company_job_posting_hiring_for and company_job_posting_quantity; Sales Nav does not filter companies by hiring role. When targeting known accounts, call load_csv_domains for CSV-on-disk workflows or save_domain_filters for pasted/raw domain lists, then pass domainFilterId. For company lookalike/account asks, call search_prospeo_companies first, review accounts, then confirm_prospeo_company_accounts to create a domainFilterId before using search_prospeo for people. Raw domain inputs and company-name targeting are NOT supported in this MCP tool. Strategy: start with 2-3 high-signal filters (title/seniority + industry or domainFilterId + headcount), add job-posting filters for hiring-led campaigns, then tighten one filter at a time. For security, AppSec, SOC, RevOps, Demand Gen, and similar function-specific lanes, do not widen with bare seniority labels like "Head" or "Director" alone; pair them with explicit function-title keywords and inspect the sample for off-function `Head of X` leakage. If output includes warnings/fallback, report that the MCP retried a rejected precise title request with a safer domain-filter people search instead of claiming the original precise filter succeeded. Prefer person location over company HQ unless HQ is explicitly needed. `campaignOfferId` routing rule: OMIT campaignOfferId ONLY in pre-mint Phase 84 `find leads` discovery mode (validating ICP before the commit gate). In every other context — post-mint lead additions, operator-driven searches on a live campaign, any search where the intent is to persist results to a specific campaign — you MUST pass campaignOfferId so the search shows up in that campaign\'s Contact Search panel. Post-mint create-campaign-v2 watch runs MUST pass currentStep: "prospeo". Omitting campaignOfferId post-mint orphans the search from the UI. Returns normalized results with pagination.',
         inputSchema: {
             type: "object",
             properties: {
@@ -2367,7 +2369,7 @@ export async function searchProspeoCompanies(input) {
         page: safeInput?.page,
         sort: safeInput?.sort,
     }));
-    return compactProspeoCompanySearchResponse(response);
+    return compactProspeoCompanySearchResponse(response, safeInput.omittedFilters ?? []);
 }
 export async function confirmProspeoCompanyAccounts(input) {
     if (!input?.companySearchToken) {
@@ -2404,6 +2406,7 @@ function removeUndefinedValues(input) {
     return Object.fromEntries(Object.entries(input).filter(([, value]) => value !== undefined));
 }
 function normalizeProspeoCompanySearchInputForMcp(input) {
+    const omittedFilters = [];
     const seedDomains = normalizeMcpSeeds(input.seedDomains, "domain");
     const seedCompanies = seedDomains.length > 0
         ? []
@@ -2418,22 +2421,28 @@ function normalizeProspeoCompanySearchInputForMcp(input) {
             typeof lookalike === "object" &&
             !Array.isArray(lookalike) &&
             "company_oids" in lookalike) {
+            omittedFilters.push({
+                field: "company_lookalike.company_oids",
+                reason: "Dropped model-supplied company_oids because seedDomains/seedCompanies require backend resolution of real Prospeo IDs.",
+                value: lookalike.company_oids,
+            });
             delete lookalike.company_oids;
             removeEmptyObjectFilter(filters, "company_lookalike");
         }
     }
-    relaxMcpSeedMatchAll(filters, seedDomains.length + seedCompanies.length);
-    normalizeMcpCompanyKeywords(filters);
-    normalizeMcpCompanyWebsiteSearch(filters);
+    normalizeMcpSeedMatchAll(filters, inferConcreteLookalikeSeedCount(filters, seedDomains.length + seedCompanies.length), omittedFilters);
+    normalizeMcpCompanyKeywords(filters, omittedFilters);
+    normalizeMcpCompanyWebsiteSearch(filters, omittedFilters);
     normalizeMcpCompanyIcp(filters);
     stripMcpDuplicateCompanyIndustry(filters);
-    stripMcpSeededLookalikeRiskyRefinements(filters, hasSeeds || hasMcpCompanyLookalikeOids(filters));
+    stripMcpSeededLookalikeRiskyRefinements(filters, hasSeeds || hasMcpCompanyLookalikeOids(filters), omittedFilters);
     stripMcpKeyCustomerCompanionFilters(filters);
     return {
         ...input,
         seedCompanies: seedCompanies.length > 0 ? seedCompanies : undefined,
         seedDomains: seedDomains.length > 0 ? seedDomains : undefined,
         filters,
+        omittedFilters: omittedFilters.length > 0 ? omittedFilters : undefined,
     };
 }
 function normalizeProspeoSearchInputForMcp(input) {
@@ -2446,7 +2455,7 @@ function normalizeProspeoSearchInputForMcp(input) {
         filters,
     };
 }
-function normalizeMcpCompanyKeywords(filters) {
+function normalizeMcpCompanyKeywords(filters, omittedFilters = []) {
     const keywords = filters.company_keywords;
     if (!isPlainObject(keywords)) {
         return;
@@ -2460,6 +2469,13 @@ function normalizeMcpCompanyKeywords(filters) {
         keywords.include = uniqueStrings(validInclude);
     }
     else {
+        if (keywords.exclude !== undefined) {
+            omittedFilters.push({
+                field: "company_keywords.exclude",
+                reason: "Dropped exclude-only company_keywords because Prospeo company search requires a positive keyword include signal.",
+                value: keywords.exclude,
+            });
+        }
         delete keywords.include;
         delete keywords.exclude;
     }
@@ -2468,7 +2484,7 @@ function normalizeMcpCompanyKeywords(filters) {
     }
     removeEmptyObjectFilter(filters, "company_keywords");
 }
-function normalizeMcpCompanyWebsiteSearch(filters) {
+function normalizeMcpCompanyWebsiteSearch(filters, omittedFilters = []) {
     const websiteSearch = filters.company_website_search;
     if (!isPlainObject(websiteSearch)) {
         return;
@@ -2479,6 +2495,13 @@ function normalizeMcpCompanyWebsiteSearch(filters) {
         normalizeStringArray(websiteSearch.urls).length > 0 ||
         Object.entries(websiteSearch).some(([key, value]) => key.startsWith("has_") && typeof value === "boolean" && value);
     if (!hasPositiveWebsiteSignal) {
+        if (websiteSearch.exclude_keywords !== undefined) {
+            omittedFilters.push({
+                field: "company_website_search.exclude_keywords",
+                reason: "Dropped website-search exclusions because Prospeo needs a positive website signal before exclude_keywords are safe.",
+                value: websiteSearch.exclude_keywords,
+            });
+        }
         delete websiteSearch.exclude_keywords;
     }
     removeEmptyObjectFilter(filters, "company_website_search");
@@ -2568,11 +2591,27 @@ function stripMcpDuplicateCompanyIndustry(filters) {
         delete filters.company_industry;
     }
 }
-function relaxMcpSeedMatchAll(filters, seedCount) {
-    if (seedCount <= 1 || !isPlainObject(filters.company_lookalike)) {
+function inferConcreteLookalikeSeedCount(filters, explicitSeedCount) {
+    if (explicitSeedCount > 0) {
+        return explicitSeedCount;
+    }
+    const lookalike = filters.company_lookalike;
+    if (!isPlainObject(lookalike) || !Array.isArray(lookalike.company_oids)) {
+        return 0;
+    }
+    return lookalike.company_oids.filter((oid) => typeof oid === "string" && /^cccc[a-z0-9]+$/i.test(oid)).length;
+}
+function normalizeMcpSeedMatchAll(filters, concreteSeedCount, omittedFilters = []) {
+    if (!isPlainObject(filters.company_lookalike)) {
         return;
     }
-    if (filters.company_lookalike.match_all === true) {
+    if (filters.company_lookalike.match_all === true &&
+        concreteSeedCount < 2) {
+        omittedFilters.push({
+            field: "company_lookalike.match_all",
+            reason: "Dropped match_all because fewer than two concrete approved lookalike seeds remained after MCP seed normalization.",
+            value: true,
+        });
         delete filters.company_lookalike.match_all;
     }
 }
@@ -2582,7 +2621,7 @@ function hasMcpCompanyLookalikeOids(filters) {
         Array.isArray(lookalike.company_oids) &&
         lookalike.company_oids.some((oid) => typeof oid === "string" && oid.length > 0));
 }
-function stripMcpSeededLookalikeRiskyRefinements(filters, hasSeeds) {
+function stripMcpSeededLookalikeRiskyRefinements(filters, hasSeeds, omittedFilters = []) {
     if (!hasSeeds || !isPlainObject(filters.company_lookalike)) {
         return;
     }
@@ -2593,17 +2632,43 @@ function stripMcpSeededLookalikeRiskyRefinements(filters, hasSeeds) {
         !filters.company_industry) {
         filters.company_industry = { include: icp.industries };
     }
-    delete filters.company_icp;
-    delete filters.company_keywords;
-    delete filters.company_website_search;
-    simplifyMcpSeededLookalikeAttributes(filters);
+    if (filters.company_icp !== undefined) {
+        omittedFilters.push({
+            field: "company_icp",
+            reason: "Dropped company_icp from seeded lookalike account search; use it as a later refinement after the seed returns a safe account sample.",
+            value: filters.company_icp,
+        });
+        delete filters.company_icp;
+    }
+    if (filters.company_keywords !== undefined) {
+        omittedFilters.push({
+            field: "company_keywords",
+            reason: "Dropped company_keywords from seeded lookalike account search to avoid Prospeo vendor 400s; use keywords as a later refinement after the seed works.",
+            value: filters.company_keywords,
+        });
+        delete filters.company_keywords;
+    }
+    if (filters.company_website_search !== undefined) {
+        omittedFilters.push({
+            field: "company_website_search",
+            reason: "Dropped company_website_search from seeded lookalike account search to avoid Prospeo vendor 400s; use website search as a later refinement after the seed works.",
+            value: filters.company_website_search,
+        });
+        delete filters.company_website_search;
+    }
+    simplifyMcpSeededLookalikeAttributes(filters, omittedFilters);
 }
-function simplifyMcpSeededLookalikeAttributes(filters) {
+function simplifyMcpSeededLookalikeAttributes(filters, omittedFilters = []) {
     const attributes = filters.company_attributes;
     if (!isPlainObject(attributes)) {
         return;
     }
     if (attributes.has_api === true && attributes.has_sso === true) {
+        omittedFilters.push({
+            field: "company_attributes.has_sso",
+            reason: "Dropped has_sso from the first seeded lookalike call because has_api + has_sso is safer as a two-step refinement.",
+            value: true,
+        });
         delete attributes.has_sso;
     }
 }
@@ -2694,7 +2759,7 @@ function storeProspeoCompanySearchTokenRef(token) {
 function resolveProspeoCompanySearchTokenRef(token) {
     return prospeoCompanySearchTokenRefs.get(token) ?? token;
 }
-function compactProspeoCompanySearchResponse(response) {
+function compactProspeoCompanySearchResponse(response, omittedFilters = []) {
     if (!response || typeof response !== "object") {
         return response;
     }
@@ -2704,7 +2769,7 @@ function compactProspeoCompanySearchResponse(response) {
     const sampleResults = accountResults
         .slice(0, 10)
         .map(compactProspeoCompanyAccount);
-    return {
+    return removeUndefinedValues({
         success: response.success ?? true,
         totalCount: typeof response.totalCount === "number"
             ? response.totalCount
@@ -2723,9 +2788,19 @@ function compactProspeoCompanySearchResponse(response) {
         },
         requestedFilters: response.normalizedFilters ?? response.filters ?? {},
         warnings: Array.isArray(response.warnings) ? response.warnings : [],
+        omittedFilters: omittedFilters.length > 0
+            ? sanitizeMcpFilterAdjustments(omittedFilters)
+            : undefined,
         companySearchToken: storeProspeoCompanySearchTokenRef(response.companySearchToken),
         nextStep: "Review accounts, then call confirm_prospeo_company_accounts with companySearchToken and selectedCompanyIds. These accounts are not people leads yet.",
-    };
+    });
+}
+function sanitizeMcpFilterAdjustments(adjustments) {
+    return adjustments.map((adjustment) => removeUndefinedValues({
+        field: adjustment.field,
+        reason: adjustment.reason,
+        value: adjustment.value,
+    }));
 }
 function compactProspeoCompanyAccount(account) {
     const compact = {
@@ -2804,10 +2879,99 @@ export async function searchProspeo(input) {
         throw new Error("search_prospeo does not accept filters.company.websites or filters.company.names. For known accounts, resolve names/domains into a domainFilterId with load_csv_domains or save_domain_filters. For company/account lookalikes, use search_prospeo_companies first, then confirm_prospeo_company_accounts.");
     }
     const safeInput = normalizeProspeoSearchInputForMcp(input);
-    const response = await api.post(`/api/v3/prospeo/search`, safeInput);
-    return compactProspeoSearchResponse(response);
+    try {
+        const response = await api.post(`/api/v3/prospeo/search`, safeInput);
+        return compactProspeoSearchResponse(response);
+    }
+    catch (error) {
+        const fallbackInput = buildProspeoPeopleSearchFallbackInput(safeInput, error);
+        if (!fallbackInput) {
+            throw error;
+        }
+        const fallbackResponse = await api.post(`/api/v3/prospeo/search`, fallbackInput);
+        const keyword = String(fallbackInput.filters.person_name_or_job_title ?? "title keyword");
+        return compactProspeoSearchResponse(fallbackResponse, {
+            warnings: [
+                `Prospeo rejected precise person-title filters for this domainFilterId; retried with person_name_or_job_title "${keyword}" plus seniority fallback.`,
+            ],
+            fallback: {
+                reason: "precise_person_title_filters_rejected",
+                originalStatus: getErrorStatus(error),
+                filters: fallbackInput.filters,
+            },
+        });
+    }
+}
+function getErrorStatus(error) {
+    if (!error || typeof error !== "object") {
+        return undefined;
+    }
+    const status = error.status;
+    return typeof status === "number" ? status : undefined;
+}
+function buildProspeoPeopleSearchFallbackInput(input, error) {
+    if (getErrorStatus(error) !== 400 || !input.domainFilterId) {
+        return null;
+    }
+    const filters = input.filters;
+    const jobTitle = filters?.person_job_title;
+    if (!isPlainObject(jobTitle) || filters.person_name_or_job_title) {
+        return null;
+    }
+    const keyword = inferProspeoPeopleFallbackKeyword(jobTitle);
+    if (!keyword) {
+        return null;
+    }
+    const fallbackFilters = {
+        person_name_or_job_title: keyword,
+        person_seniority: {
+            include: [
+                "C-Suite",
+                "Vice President",
+                "Head",
+                "Director",
+                "Manager",
+            ],
+        },
+        max_person_per_company: typeof filters.max_person_per_company === "number"
+            ? filters.max_person_per_company
+            : 1,
+    };
+    if (isPlainObject(filters.person_location_search)) {
+        fallbackFilters.person_location_search = filters.person_location_search;
+    }
+    return removeUndefinedValues({
+        campaignOfferId: input.campaignOfferId,
+        domainFilterId: input.domainFilterId,
+        page: input.page,
+        searchName: input.searchName,
+        currentStep: input.currentStep,
+        confirmed: input.confirmed,
+        filters: fallbackFilters,
+    });
+}
+function inferProspeoPeopleFallbackKeyword(jobTitle) {
+    const text = [
+        typeof jobTitle.boolean_search === "string" ? jobTitle.boolean_search : "",
+        ...normalizeStringArray(jobTitle.include),
+    ].join(" ");
+    if (/security|ciso|appsec|soc/i.test(text))
+        return "Security";
+    if (/platform/i.test(text))
+        return "Platform";
+    if (/product/i.test(text))
+        return "Product";
+    if (/growth|gtm|go[-\s]?to[-\s]?market/i.test(text))
+        return "Growth";
+    if (/sales|revenue/i.test(text))
+        return "Sales";
+    if (/marketing|demand/i.test(text))
+        return "Marketing";
+    if (/engineering|technical|developer/i.test(text))
+        return "Engineering";
+    return null;
 }
-function compactProspeoSearchResponse(response) {
+function compactProspeoSearchResponse(response, metadata = {}) {
     if (!response || typeof response !== "object") {
         return response;
     }
@@ -2815,7 +2979,7 @@ function compactProspeoSearchResponse(response) {
         ? response.people.results
         : [];
     const sampleResults = peopleResults.slice(0, 10).map(compactProspeoPerson);
-    return {
+    return removeUndefinedValues({
         success: response.success ?? true,
         searchId: response.searchId ?? null,
         searchName: response.searchName ?? null,
@@ -2836,7 +3000,9 @@ function compactProspeoSearchResponse(response) {
             sampleCount: sampleResults.length,
             results: sampleResults,
         },
-    };
+        warnings: metadata.warnings,
+        fallback: metadata.fallback,
+    });
 }
 function compactProspeoPerson(person) {
     const currentRole = Array.isArray(person?._prospeo?.job_history)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sellable/mcp",
-  "version": "0.1.231",
+  "version": "0.1.233",
   "type": "module",
   "description": "Sellable MCP server for Claude Code and Codex campaign workflows",
   "main": "dist/index.js",

package/skills/create-campaign/SKILL.md

@@ -220,6 +220,23 @@ reference to avoid long-token copy errors. Account rows are not people leads
 yet. The confirmation creates the `domainFilterId` that constrains the follow-on
 `search_prospeo` people search.
 
+For lookalike seed selection, treat "best customer", "top customer", "past
+companies", "companies I worked with", and similar wording as customer/account
+or past-company seed asks. Never substitute the sender's current company or
+domain as a lookalike seed; never use the sender's current company/domain as a
+silent substitute unless the user explicitly asks for companies like the current
+employer, sender company, or its direct peers/competitors. Seed priority is:
+explicit user-provided customer/account/company/domain; verified
+customer/worked-with/past-company evidence from research/proof; then ask for the
+missing seed or switch to non-lookalike company filters if YOLO requires moving
+without a seed. If using profile/work-history seeds, label them as
+past-company/public proof clues, not confirmed customers unless the source proves
+customer status. If the user asks for a geography like Germany, preserve it in
+account discovery where supported (`company_location_search` or
+`company_icp.geographic_markets`) and in follow-on people search
+(`person_location_search`); do not drop geography when moving from lookalike
+accounts to people leads.
+
 Prospeo company/account search is useful when the source plan depends on
 website traffic (`company_website_traffic`), confirmed AI Attributes including
 `pricing`, `uses_ai`, `has_api`, `has_chrome_extension`, `has_sso`,

package/skills/create-campaign/core/providers/prospeo.json

@@ -24,13 +24,13 @@
     "useWhen": [
       "You want Prospeo filters or domain-based search",
       "You need company lookalike account discovery before finding people",
-      "You want companies like X, best-customer lookalikes, or accounts using AI/API/SSO/Chrome extensions",
+      "You want companies like X, best-customer/top-customer/past-company lookalikes, or accounts using AI/API/SSO/Chrome extensions",
       "You need companies hiring for specific roles using job-posting filters",
       "You need high deliverability from Prospeo"
     ],
     "avoidWhen": ["You need LinkedIn activity filters"],
     "reason": "Strong for hiring-led search, company/account lookalikes, Prospeo-specific filters, verified contacts, and domain lists.",
-    "prose": "Since you're targeting **{icp}**, I'd recommend **Prospeo**.\n\nHere's why:\n- Prospeo can discover lookalike accounts first, then turn approved accounts into a domainFilterId for people search\n- Prospeo can filter for companies hiring specific roles with job-posting filters\n- We can pair those company signals with buyer/referrer titles and verified-contact coverage\n\nFor lookalike accounts, I will show an account sample first; those account rows are not people leads yet. After approval, I will use the companySearchToken to confirm the accounts, then search people at the returned domainFilterId.\n\nShould I search Prospeo for {icp}?"
+    "prose": "Since you're targeting **{icp}**, I'd recommend **Prospeo**.\n\nHere's why:\n- Prospeo can discover lookalike accounts first, then turn approved accounts into a domainFilterId for people search\n- Prospeo can filter for companies hiring specific roles with job-posting filters\n- We can pair those company signals with buyer/referrer titles and verified-contact coverage\n\nFor lookalike accounts, I will show an account sample first; those account rows are not people leads yet. After approval, I will use the companySearchToken to confirm the accounts, then search people at the returned domainFilterId. For best-customer, top-customer, or past-company lookalikes, I will use explicit customer/account/past-company seeds, not the sender's current company, unless you explicitly ask for current-company peers.\n\nShould I search Prospeo for {icp}?"
   },
   "askOption": {
     "label": "Prospeo",

package/skills/create-campaign/references/provider-selection-strategy.md

@@ -99,7 +99,7 @@ Is your ICP LinkedIn-active (founders, sales, marketing, GTM, engineers)?
 Need hiring-by-role filters? -> Prospeo (has company job-posting filters)
 Need tech stack targeting? -> Apollo (has technology filters)
 Have specific company names/domains? -> Sales Navigator for small lists or Prospeo with domainFilterId
-Need companies like X, best-customer lookalikes, AI/API/SSO/Chrome extension filters, news/awards/integrations/key customers? -> Prospeo account discovery first
+Need companies like X, best-customer/top-customer/past-company lookalikes, AI/API/SSO/Chrome extension filters, news/awards/integrations/key customers? -> Prospeo account discovery first; use explicit customer/account/past-company seeds, not the sender's current company unless current-company peers were requested
 ```
 
 ## ICP-to-Provider Quick Reference

package/skills/create-campaign-v2/SKILL.md

@@ -188,6 +188,23 @@ Show the account sample first, ask approval, then pass the returned
 `confirm_prospeo_company_accounts`. The confirmed `domainFilterId` constrains
 the follow-on people search; account rows are not people leads yet.
 
+For lookalike seed selection, treat "best customer", "top customer", "past
+companies", "companies I worked with", and similar wording as customer/account
+or past-company seed asks. Never substitute the sender's current company or
+domain as a lookalike seed; never use the sender's current company/domain as a
+silent substitute unless the user explicitly asks for companies like the current
+employer, sender company, or its direct peers/competitors. Seed priority is:
+explicit user-provided customer/account/company/domain; verified
+customer/worked-with/past-company evidence from research/proof; then ask for the
+missing seed or switch to non-lookalike company filters if YOLO requires moving
+without a seed. If using profile/work-history seeds, label them as
+past-company/public proof clues, not confirmed customers unless the source proves
+customer status. If the user asks for a geography like Germany, preserve it in
+account discovery where supported (`company_location_search` or
+`company_icp.geographic_markets`) and in follow-on people search
+(`person_location_search`); do not drop geography when moving from lookalike
+accounts to people leads.
+
 Before any provider prompt/search/scout call, move the watched campaign to
 source selection, show `## Find Buyers Plan`, then open `request_user_input`
 without repeating the URL. The plan must appear before the question and only

package/skills/find-leads/SKILL.md

@@ -391,6 +391,22 @@ Use first for broad persona expansion, ABM/domain targeting, hiring-led targetin
 - For companies like X, our best customers, lookalike accounts, companies that use AI, companies with API/SSO/Chrome extension, or
   news/award/integration/key-customer account filters, use
   `search_prospeo_companies` before people search.
+- For lookalike seed selection, treat "best customer", "top customer", "past
+  companies", "companies I worked with", and similar wording as
+  customer/account or past-company seed asks. Never substitute the sender's
+  current company or domain as a lookalike seed; never use the sender's current
+  company/domain as a silent substitute unless the user explicitly asks for
+  companies like the current employer, sender company, or its direct
+  peers/competitors. Seed priority is: explicit user-provided
+  customer/account/company/domain; verified customer/worked-with/past-company
+  evidence from research/proof; then ask for the missing seed or switch to
+  non-lookalike company filters if YOLO requires moving without a seed. If using
+  profile/work-history seeds, label them as past-company/public proof clues, not
+  confirmed customers unless the source proves customer status. If the user asks
+  for a geography like Germany, preserve it in account discovery where supported
+  (`company_location_search` or `company_icp.geographic_markets`) and in
+  follow-on people search (`person_location_search`); do not drop geography when
+  moving from lookalike accounts to people leads.
 - Use Prospeo company/account search when the ask depends on website traffic
   (`company_website_traffic`), confirmed AI Attributes including `pricing`,
   `uses_ai`, `has_api`, `has_chrome_extension`, `has_sso`, `has_open_source`,

package/skills/providers/prospeo.md

@@ -87,6 +87,23 @@ backend resolves real Prospeo company IDs. Do not invent company_oids such as
 placeholder IDs from examples. Only send `company_lookalike.company_oids` when
 they are real Prospeo company IDs returned by a prior tool/search.
 
+For lookalike seed selection, treat "best customer", "top customer", "past
+companies", "companies I worked with", and similar wording as customer/account
+or past-company seed asks. Never substitute the sender's current company/domain
+as a lookalike seed, and never use the sender's current company/domain as a
+silent substitute unless the user explicitly asks for companies like the current
+employer, sender company, or its direct peers/competitors. Seed priority is:
+explicit user-provided customer/account/company/domain; verified
+customer/worked-with/past-company evidence from research/proof; then ask for the
+missing seed or switch to non-lookalike company filters if YOLO requires moving
+without a seed. If using profile/work-history seeds, label them as
+past-company/public proof clues, not confirmed customers unless the source proves
+customer status. If the user asks for a geography like Germany, preserve it in
+account discovery where supported (`company_location_search` or
+`company_icp.geographic_markets`) and in follow-on people search
+(`person_location_search`); do not drop geography when moving from lookalike
+accounts to people leads.
+
 For structured ICP sizing, pair `company_icp.company_sizes` with
 `company_headcount_range` when possible. The MCP normalizer derives headcount
 ranges for `micro`, `smb`, `midmarket`, `enterprise`, and `large_enterprise`
@@ -109,15 +126,30 @@ Avoidable-400 guardrails:
 - For seeded company lookalikes, keep the first call simple: seed company/domain + `company_lookalike.minimum_tier` + confirmed attributes, headcount, or industry. Do not add `company_website_search`, `company_keywords`, or `company_icp` until the account sample proves the seed works.
 - For seeded company lookalikes, do not combine `has_api` and `has_sso` in the first call; start with `has_api` and refine after a valid account sample if SSO still matters.
 - Do not send placeholder seed names such as `another approved best-customer seed`; use only concrete company names or domains you have actually resolved.
+- Do not silently use the sender company as a customer lookalike seed; use
+  explicit customer/account/past-company evidence instead.
 - If the user references another approved seed but does not name it, ask for the
   seed or run a one-seed lookalike without `match_all`; do not invent a second
   seed from examples, competitors, or exclusions.
 - Prefer seed domains for single-seed lookalikes. For multi-seed `match_all`
-  lookalikes, use concrete company names unless you already know the exact
-  canonical Prospeo domains; guessed product or marketing domains can 400 with
-  `match_all`. Do not mix `seedDomains` and `seedCompanies` in the same call.
+  lookalikes, use two or more concrete approved seed domains or company names;
+  never infer the second seed from examples, competitors, or exclusions. If
+  Prospeo rejects `match_all`, the backend may retry without `match_all` and
+  return a warning. Report that as a vendor fallback, not as proof that strict
+  `match_all` succeeded. Do not mix `seedDomains` and `seedCompanies` in the
+  same call.
 - Do not send `company_website_search.exclude_keywords` without a positive website include signal.
+- If `search_prospeo_companies` returns `omittedFilters`, those fields were
+  intentionally not sent to Prospeo to avoid known public-API failures. Report
+  them as safety handling and keep the account sample separate from people
+  leads; use a follow-up refinement or manual review for those omitted
+  constraints instead of claiming Prospeo enforced them.
 - For post-confirm people search, prefer `person_job_title.boolean_search` for long role synonym lists instead of many `person_job_title.include` values plus broad department/seniority filters.
+- If `search_prospeo` returns a `warnings` array or `fallback` object after a
+  domain-filter people search, report the retry honestly. The MCP may retry a
+  Prospeo 400 from precise title filters with `person_name_or_job_title` plus
+  seniority so the run produces a usable sample without hiding the vendor
+  limitation.
 
 Unsupported/caveats:
 
@@ -262,6 +294,13 @@ Preference rules:
 - Run `company_key_customers` as a standalone first-pass filter. Do not combine `company_key_customers` with ICP, website-search, keyword, attribute, industry, or headcount filters until the standalone pass proves useful.
 - For seeded lookalikes, avoid first-call `company_website_search`, `company_keywords`, and `company_icp`; use resolved seeds plus lookalike tier and simple attributes/headcount/industry first.
 - For seeded lookalikes, avoid first-call `has_api` + `has_sso`; use one confirmed attribute first, then refine.
+- For customer, best-customer, top-customer, or past-company lookalikes, never
+  use the sender's current company/domain as a silent substitute; use explicit
+  customer/account/past-company evidence, then label profile-derived seeds as
+  past-company/public proof clues unless customer status is verified.
+- If the user gives geography like Germany, keep that geography in the company
+  discovery or follow-on people filters instead of dropping it after account
+  confirmation.
 - Do not invent missing approved seeds. If a second seed is not named, ask for it
   or run one seed without `match_all`.
 - Prefer `seedDomains` for single-seed lookalikes. For multi-seed `match_all`