@sellable/mcp 0.1.221 → 0.1.223

package/dist/tools/leads.d.ts

@@ -1613,6 +1613,7 @@ export declare const leadToolDefinitions: ({
                                         type: string;
                                         items: {
                                             type: string;
+                                            enum: string[];
                                         };
                                     };
                                     other: {
@@ -1648,6 +1649,7 @@ export declare const leadToolDefinitions: ({
                             };
                             geographic_scope: {
                                 type: string;
+                                enum: string[];
                             };
                         };
                     };
@@ -2751,6 +2753,7 @@ export declare const leadToolDefinitions: ({
                                         type: string;
                                         items: {
                                             type: string;
+                                            enum: string[];
                                         };
                                     };
                                     other: {
@@ -2786,6 +2789,7 @@ export declare const leadToolDefinitions: ({
                             };
                             geographic_scope: {
                                 type: string;
+                                enum: string[];
                             };
                         };
                     };

package/dist/tools/leads.js

@@ -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" } } }.
+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

@@ -2952,6 +2952,7 @@ export declare const allTools: ({
                                         type: string;
                                         items: {
                                             type: string;
+                                            enum: string[];
                                         };
                                     };
                                     other: {
@@ -2987,6 +2988,7 @@ export declare const allTools: ({
                             };
                             geographic_scope: {
                                 type: string;
+                                enum: string[];
                             };
                         };
                     };
@@ -4090,6 +4092,7 @@ export declare const allTools: ({
                                         type: string;
                                         items: {
                                             type: string;
+                                            enum: string[];
                                         };
                                     };
                                     other: {
@@ -4125,6 +4128,7 @@ export declare const allTools: ({
                             };
                             geographic_scope: {
                                 type: string;
+                                enum: string[];
                             };
                         };
                     };

package/package.json

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

package/skills/create-campaign/SKILL.md

@@ -218,6 +218,24 @@ reconstruct raw account rows or domains manually. Account rows are not people
 leads yet. The confirmation creates the `domainFilterId` that constrains the
 follow-on `search_prospeo` people search.
 
+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`,
+`has_open_source`, `has_marketplace`, `has_blog`, `has_knowledge_base`,
+`has_soc2`, `data_residency: "EU"`, news, awards, website pages, products,
+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. 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. 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
     recommended posts will be scraped and the target engager/source-candidate

package/skills/find-leads/SKILL.md

@@ -391,6 +391,28 @@ 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.
+- 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`,
+  `has_marketplace`, `has_blog`, `has_knowledge_base`, `has_soc2`,
+  `data_residency: "EU"`, website pages, products, 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 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.
+- 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.
 - After approval, call `confirm_prospeo_company_accounts` with the
   `companySearchToken` and selected Prospeo company IDs from

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,8 +56,11 @@ 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 },
     "company_key_execs": {
       "event_types": ["VP of Sales Appointed"],
@@ -79,6 +82,24 @@ 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:
 
 - `company_intent` is unsupported by Prospeo public API.
@@ -86,7 +107,7 @@ Unsupported/caveats:
 - Public API account rows do not expose row-level lookalike tier/score/reason; do not fabricate them.
 - Website traffic and key executive filters are experimental and may fail by account/API policy.
 
-Confirmed AI Attribute keys:
+The confirmed AI Attributes keys are:
 
 - `demo`
 - `freetrial`