@sellable/mcp 0.1.222 → 0.1.224

package/dist/tools/leads.d.ts

@@ -1246,12 +1246,14 @@ export declare const leadToolDefinitions: ({
                                 type: string;
                                 items: {
                                     type: string;
+                                    minLength: number;
                                 };
                             };
                             exclude: {
                                 type: string;
                                 items: {
                                     type: string;
+                                    minLength: number;
                                 };
                             };
                             include_all: {
@@ -1613,6 +1615,7 @@ export declare const leadToolDefinitions: ({
                                         type: string;
                                         items: {
                                             type: string;
+                                            enum: string[];
                                         };
                                     };
                                     other: {
@@ -1648,6 +1651,7 @@ export declare const leadToolDefinitions: ({
                             };
                             geographic_scope: {
                                 type: string;
+                                enum: string[];
                             };
                         };
                     };
@@ -2384,12 +2388,14 @@ export declare const leadToolDefinitions: ({
                                 type: string;
                                 items: {
                                     type: string;
+                                    minLength: number;
                                 };
                             };
                             exclude: {
                                 type: string;
                                 items: {
                                     type: string;
+                                    minLength: number;
                                 };
                             };
                             include_all: {
@@ -2751,6 +2757,7 @@ export declare const leadToolDefinitions: ({
                                         type: string;
                                         items: {
                                             type: string;
+                                            enum: string[];
                                         };
                                     };
                                     other: {
@@ -2786,6 +2793,7 @@ export declare const leadToolDefinitions: ({
                             };
                             geographic_scope: {
                                 type: string;
+                                enum: string[];
                             };
                         };
                     };

package/dist/tools/leads.js

@@ -177,10 +177,10 @@ const prospeoFundingFilterSchema = {
 };
 const prospeoCompanyKeywordsSchema = {
     type: "object",
-    description: "Company keyword search",
+    description: 'Company keyword search. Prospeo requires keyword values to be at least 3 characters; use "artificial intelligence" instead of "AI".',
     properties: {
-        include: { type: "array", items: { type: "string" } },
-        exclude: { type: "array", items: { type: "string" } },
+        include: { type: "array", items: { type: "string", minLength: 3 } },
+        exclude: { type: "array", items: { type: "string", minLength: 3 } },
         include_all: { type: "boolean" },
         include_company_description: { type: "boolean" },
         include_company_description_seo: { type: "boolean" },
@@ -375,14 +375,36 @@ const prospeoCompanyHeadcountByLocationSchema = {
 };
 const prospeoCompanyIcpSchema = {
     type: "object",
-    description: "Structured company ICP filter.",
+    description: "Structured company ICP filter. Product is not a company_icp.departments value; use titles_include for product roles. geographic_scope only accepts single_country or multi_country.",
     properties: {
         titles_include: { type: "array", items: { type: "string" } },
         titles_exclude: { type: "array", items: { type: "string" } },
         departments: {
             type: "object",
             properties: {
-                include: { type: "array", items: { type: "string" } },
+                include: {
+                    type: "array",
+                    items: {
+                        type: "string",
+                        enum: [
+                            "Consumers",
+                            "Customer Success",
+                            "Data",
+                            "Design",
+                            "Engineering",
+                            "Finance",
+                            "HR",
+                            "IT",
+                            "Legal",
+                            "Marketing",
+                            "Operations",
+                            "Procurement",
+                            "SMB Owners",
+                            "Sales",
+                            "Security",
+                        ],
+                    },
+                },
                 other: { type: "array", items: { type: "string" } },
                 match_mode: { type: "string", enum: ["ANY", "ALL"] },
             },
@@ -396,7 +418,10 @@ const prospeoCompanyIcpSchema = {
         },
         industries: { type: "array", items: { type: "string" } },
         geographic_markets: { type: "array", items: { type: "string" } },
-        geographic_scope: { type: "string" },
+        geographic_scope: {
+            type: "string",
+            enum: ["single_country", "multi_country"],
+        },
     },
 };
 const prospeoCompanyWebsiteTrafficSchema = {
@@ -405,7 +430,10 @@ const prospeoCompanyWebsiteTrafficSchema = {
     properties: {
         min_monthly_visits: { type: "number" },
         max_monthly_visits: { type: "number" },
-        visit_change: { type: "string", enum: ["increased", "decreased", "stable"] },
+        visit_change: {
+            type: "string",
+            enum: ["increased", "decreased", "stable"],
+        },
         top_countries: { type: "array", items: { type: "string" } },
         min_country_percentage: { type: "number" },
         max_country_percentage: { type: "number" },
@@ -439,7 +467,7 @@ const prospeoCompanyAccountWorkflowGuidance = `Company account workflow: search_
 search_prospeo_companies({
   "seedDomains": ["tryredrover.com"],
   "filters": {
-    "company_lookalike": { "company_oids": ["cmp_red_rover"], "minimum_tier": "T1" },
+    "company_lookalike": { "minimum_tier": "T1" },
     "company_attributes": { "uses_ai": true, "has_api": true, "pricing": true },
     "company_website_search": {
       "include_keywords": ["pricing"],
@@ -448,12 +476,13 @@ 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 accounts in the news: { "company_news": { "categories": ["Funding & Investment"], "timeframe_days": 90 } }.
 For awards: { "company_awards": { "include": ["G2"], "match_mode": "CONTAINS" } }.
 For website traffic: { "company_website_traffic": { "min_monthly_visits": 50000 } }.
 For products/services, integrations, key customers, and Google discovery use "company_products_services", "company_integrations", "company_key_customers", and "company_google_discovery".
 For headcount by location: { "company_headcount_by_location": { "entries": [{ "country": "United States", "city": "Austin", "min_headcount": 10 }] } }.
-For structured ICP: { "company_icp": { "titles_include": ["Head of RevOps"], "company_sizes": ["midmarket"], "departments": { "include": ["Sales"], "match_mode": "ANY" } }, "company_headcount_range": ["101-200", "201-500", "501-1000"] }. Pair company_icp.company_sizes with company_headcount_range or rely on MCP normalization that derives the range; inspect the account sample for size drift.
+For structured ICP: { "company_icp": { "titles_include": ["Head of RevOps"], "company_sizes": ["midmarket"], "departments": { "include": ["Sales"], "match_mode": "ANY" }, "geographic_scope": "multi_country", "geographic_markets": ["United States", "Canada"] }, "company_headcount_range": ["101-200", "201-500", "501-1000"] }. Pair company_icp.company_sizes with company_headcount_range or rely on MCP normalization that derives the range; inspect the account sample for size drift. Product is not a company_icp.departments value; use titles_include for product roles. geographic_scope only accepts single_country or multi_country.
 company_intent is unsupported; support-channel AI Attribute guesses like phone/email/chat/ticket/social are not exposed. public API rows do not include lookalike tier/score/reason.`;
 function loadSignalDiscoveryConfig() {
     if (!existsSync(signalProviderConfigPath)) {
@@ -1421,7 +1450,7 @@ 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. 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. ' +
             prospeoCompanyAccountWorkflowGuidance,
         inputSchema: {
             type: "object",
@@ -1442,11 +1471,14 @@ export const leadToolDefinitions = [
                 },
                 filters: {
                     type: "object",
-                    description: 'Company/account filters. For lookalikes, use company_lookalike.company_oids when you already have Prospeo IDs; otherwise pass seedCompanies/seedDomains and the backend resolves IDs. minimum_tier must be "T1", "T2", or "T3". Do not use company_intent.',
+                    description: 'Company/account filters. For lookalikes, use company_lookalike.company_oids only when you already have real Prospeo IDs; otherwise pass seedCompanies/seedDomains and omit company_oids so the backend resolves IDs. minimum_tier must be "T1", "T2", or "T3". Do not invent company_oids. Do not use company_intent.',
                     properties: {
                         company_industry: prospeoFilterValueSchema,
                         company_technology: prospeoFilterValueSchema,
-                        company_email_provider: { type: "array", items: { type: "string" } },
+                        company_email_provider: {
+                            type: "array",
+                            items: { type: "string" },
+                        },
                         company_naics: prospeoFilterValueSchema,
                         company_sics: prospeoFilterValueSchema,
                         company_headcount_range: {

package/dist/tools/registry.d.ts

@@ -2585,12 +2585,14 @@ export declare const allTools: ({
                                 type: string;
                                 items: {
                                     type: string;
+                                    minLength: number;
                                 };
                             };
                             exclude: {
                                 type: string;
                                 items: {
                                     type: string;
+                                    minLength: number;
                                 };
                             };
                             include_all: {
@@ -2952,6 +2954,7 @@ export declare const allTools: ({
                                         type: string;
                                         items: {
                                             type: string;
+                                            enum: string[];
                                         };
                                     };
                                     other: {
@@ -2987,6 +2990,7 @@ export declare const allTools: ({
                             };
                             geographic_scope: {
                                 type: string;
+                                enum: string[];
                             };
                         };
                     };
@@ -3723,12 +3727,14 @@ export declare const allTools: ({
                                 type: string;
                                 items: {
                                     type: string;
+                                    minLength: number;
                                 };
                             };
                             exclude: {
                                 type: string;
                                 items: {
                                     type: string;
+                                    minLength: number;
                                 };
                             };
                             include_all: {
@@ -4090,6 +4096,7 @@ export declare const allTools: ({
                                         type: string;
                                         items: {
                                             type: string;
+                                            enum: string[];
                                         };
                                     };
                                     other: {
@@ -4125,6 +4132,7 @@ export declare const allTools: ({
                             };
                             geographic_scope: {
                                 type: string;
+                                enum: string[];
                             };
                         };
                     };

package/package.json

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

package/skills/create-campaign/SKILL.md

@@ -226,9 +226,18 @@ website traffic (`company_website_traffic`), confirmed AI Attributes including
 integrations, key customers, Google discovery, location headcount, or
 structured ICP. When using `company_icp.company_sizes` for micro/SMB/midmarket
 or enterprise sizing, pair it with `company_headcount_range` or rely on the MCP
-normalization that derives the range; inspect the sample for size drift. Do not
-use `company_intent`, and do not invent unsupported support-channel filters or
-AI Attribute guesses like phone/email/chat/ticket/social.
+normalization that derives the range; inspect the sample for size drift. For
+lookalike seeds passed as `seedCompanies` or `seedDomains`, omit `company_oids`;
+the MCP backend resolves real Prospeo company IDs. Do not invent company_oids.
+For company ICP geography, `geographic_scope` only accepts `single_country` or
+`multi_country`; put North America style regions in `geographic_markets` as
+specific markets such as United States and Canada. Product is not a
+company_icp.departments value; use `titles_include` for product roles.
+`company_keywords.include/exclude` values must be at least 3 characters; use
+`artificial intelligence` instead of `AI`, or use confirmed attributes such as
+`uses_ai` when that is the actual signal. Do not use `company_intent`, and do
+not invent unsupported support-channel filters or AI Attribute guesses like
+phone/email/chat/ticket/social.
 
     After scouting, ask for a second approval on Start Import. For
     LinkedIn engagement (`signal-discovery` internally), name how many

package/skills/find-leads/SKILL.md

@@ -401,6 +401,19 @@ Use first for broad persona expansion, ABM/domain targeting, hiring-led targetin
   sizing, pair it with `company_headcount_range` or rely on MCP normalization
   that derives the range; inspect the account sample for size drift before
   approving accounts.
+- For lookalike seeds passed as `seedCompanies` or `seedDomains`, omit
+  `company_oids`; the MCP backend resolves real Prospeo company IDs. Do not
+  invent company_oids.
+- For company ICP geography, `geographic_scope` only accepts `single_country`
+  or `multi_country`; put North America style regions in `geographic_markets`
+  as specific markets such as United States and Canada.
+- Product is not a company_icp.departments value; use `titles_include` for
+  product roles. Allowed company ICP departments include Consumers, Customer
+  Success, Data, Design, Engineering, Finance, HR, IT, Legal, Marketing,
+  Operations, Procurement, SMB Owners, Sales, and Security.
+- `company_keywords.include/exclude` values must be at least 3 characters; use
+  `artificial intelligence` instead of `AI`, or use confirmed attributes such
+  as `uses_ai` when that is the actual signal.
 - Do not use `company_intent`. Do not invent unsupported support-channel filters
   or AI Attribute guesses like phone/email/chat/ticket/social.
 - Company/account search returns an account sample only; account rows are not people leads yet. Ask the user to approve the account sample.

package/skills/providers/prospeo.md

@@ -25,7 +25,7 @@ Example account discovery:
 search_prospeo_companies({
   "seedDomains": ["tryredrover.com"],
   "filters": {
-    "company_lookalike": { "company_oids": ["cmp_red_rover"], "minimum_tier": "T1" },
+    "company_lookalike": { "minimum_tier": "T1" },
     "company_attributes": {
       "uses_ai": true,
       "has_api": true,
@@ -56,7 +56,9 @@ search_prospeo_companies({
     "company_icp": {
       "titles_include": ["Head of RevOps"],
       "company_sizes": ["midmarket"],
-      "departments": { "include": ["Sales"], "match_mode": "ANY" }
+      "departments": { "include": ["Sales"], "match_mode": "ANY" },
+      "geographic_scope": "multi_country",
+      "geographic_markets": ["United States", "Canada"]
     },
     "company_headcount_range": ["101-200", "201-500", "501-1000"],
     "company_website_traffic": { "min_monthly_visits": 50000 },
@@ -80,11 +82,23 @@ confirm_prospeo_company_accounts({
 
 Use the returned `domainFilterId` in `search_prospeo` with people filters. Do not reconstruct raw account rows or domains manually as Prospeo-sourced provenance.
 
+When `seedDomains` or `seedCompanies` are present, omit `company_oids`; the MCP
+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 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`
 when no explicit headcount range is supplied, but the sample should still be
 checked for size drift before accounts are approved.
+For company ICP geography, `geographic_scope` only accepts `single_country` or
+`multi_country`; put "North America" style regions in `geographic_markets` as
+specific markets such as `United States` and `Canada`. Product is not a
+company_icp.departments value; use `titles_include` for product roles. Allowed
+company ICP departments include Consumers, Customer Success, Data, Design,
+Engineering, Finance, HR, IT, Legal, Marketing, Operations, Procurement, SMB
+Owners, Sales, and Security.
 
 Unsupported/caveats:
 
@@ -223,6 +237,7 @@ Preference rules:
 - In security, AppSec, SOC, RevOps, Demand Gen, and similar function-specific lanes, do not rely on bare `Head` / `Director` / `VP` widening by itself. Pair seniority with explicit function keywords in `person_job_title` and verify the sample for off-function titles like `Head of Social Media`.
 - Prefer `company_headcount_range` for most sizing; use `company_headcount_custom` for precise numeric bounds.
 - Prefer `company_industry` before `company_keywords`; use keywords for refinement, not first-pass targeting.
+- `company_keywords.include/exclude` values must be at least 3 characters; use `artificial intelligence` instead of `AI`, or use confirmed attributes such as `uses_ai` when that is the real signal.
 
 ### Person Filters