@sellable/mcp 0.1.233 → 0.1.234

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -522,7 +522,7 @@ search_prospeo_companies({
522
522
  }
523
523
  })
524
524
  Do not invent company_oids. When seedCompanies or seedDomains are present, omit company_oids and let the backend resolve real Prospeo company IDs.
525
- 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.
525
+ Route lookalike seed selection by campaign intent. For outbound/sales prospecting, use explicit target/account/customer domains or company names first, then verified past-customer/account evidence from research, CRM, or proof; never substitute the sender's company/domain or employer history unless it is confirmed as a target/customer seed or the user asks for sender-company peers. For job-search/application campaigns, current/past employers can be lookalike seeds because they define the candidate-fit lane. If intent or seed source is ambiguous, ask target/customer domains vs current/past employers, or switch to non-lookalike filters under YOLO. If the user asks for a geography like Germany, preserve it in company discovery where supported and in the follow-on people search.
526
526
  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.
527
527
  For accounts in the news: { "company_news": { "categories": ["Funding & Investment"], "timeframe_days": 90 } }.
528
528
  For awards: { "company_awards": { "include": ["G2"], "match_mode": "CONTAINS" } }.
@@ -1499,7 +1499,7 @@ export const leadToolDefinitions = [
1499
1499
  {
1500
1500
  name: "search_prospeo_companies",
1501
1501
  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. ' +
1502
- "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. " +
1502
+ "Route lookalike seeds by campaign intent: outbound uses explicit target/account/customer domains or verified past-customer accounts, not the sender company/domain; job-search/application campaigns may use current/past employers as existing-company seeds. Preserve geography like Germany in account or people filters. " +
1503
1503
  prospeoCompanyAccountWorkflowGuidance,
1504
1504
  inputSchema: {
1505
1505
  type: "object",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@sellable/mcp",
3
- "version": "0.1.233",
3
+ "version": "0.1.234",
4
4
  "type": "module",
5
5
  "description": "Sellable MCP server for Claude Code and Codex campaign workflows",
6
6
  "main": "dist/index.js",
@@ -220,19 +220,21 @@ reference to avoid long-token copy errors. Account rows are not people leads
220
220
  yet. The confirmation creates the `domainFilterId` that constrains the follow-on
221
221
  `search_prospeo` people search.
222
222
 
223
- For lookalike seed selection, treat "best customer", "top customer", "past
224
- companies", "companies I worked with", and similar wording as customer/account
225
- or past-company seed asks. Never substitute the sender's current company or
226
- domain as a lookalike seed; never use the sender's current company/domain as a
227
- silent substitute unless the user explicitly asks for companies like the current
228
- employer, sender company, or its direct peers/competitors. Seed priority is:
229
- explicit user-provided customer/account/company/domain; verified
230
- customer/worked-with/past-company evidence from research/proof; then ask for the
231
- missing seed or switch to non-lookalike company filters if YOLO requires moving
232
- without a seed. If using profile/work-history seeds, label them as
233
- past-company/public proof clues, not confirmed customers unless the source proves
234
- customer status. If the user asks for a geography like Germany, preserve it in
235
- account discovery where supported (`company_location_search` or
223
+ For lookalike seed selection, route by campaign intent. In outbound/sales
224
+ prospecting campaigns, treat "best customer", "top customer", "target domains",
225
+ "approved accounts", "customer domains", and similar wording as target
226
+ account/customer seed asks. Use explicit user-provided target/account/customer
227
+ domains or company names first, then verified past-customer/account evidence from
228
+ research, CRM, or proof. Never substitute the sender's current company/domain or
229
+ employer history as a lookalike seed for outbound unless the user explicitly
230
+ confirms that domain is a target/customer seed or asks for sender-company peers.
231
+ In job-search/application campaigns, lookalike seeds may be existing companies
232
+ from the candidate's current or past employers because those companies define
233
+ the candidate-fit lane. If campaign intent or seed source is ambiguous, ask
234
+ whether the seed should be target/customer domains or current/past employers; if
235
+ YOLO requires moving without a seed, switch to non-lookalike company filters
236
+ instead of inventing a seed. If the user asks for a geography like Germany,
237
+ preserve it in account discovery where supported (`company_location_search` or
236
238
  `company_icp.geographic_markets`) and in follow-on people search
237
239
  (`person_location_search`); do not drop geography when moving from lookalike
238
240
  accounts to people leads.
@@ -24,13 +24,13 @@
24
24
  "useWhen": [
25
25
  "You want Prospeo filters or domain-based search",
26
26
  "You need company lookalike account discovery before finding people",
27
- "You want companies like X, best-customer/top-customer/past-company lookalikes, or accounts using AI/API/SSO/Chrome extensions",
27
+ "You want companies like X, target-domain, best-customer/top-customer, or job-search employer lookalikes, or accounts using AI/API/SSO/Chrome extensions",
28
28
  "You need companies hiring for specific roles using job-posting filters",
29
29
  "You need high deliverability from Prospeo"
30
30
  ],
31
31
  "avoidWhen": ["You need LinkedIn activity filters"],
32
32
  "reason": "Strong for hiring-led search, company/account lookalikes, Prospeo-specific filters, verified contacts, and domain lists.",
33
- "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}?"
33
+ "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 outbound lookalikes, I will use target/account/customer domains or verified past-customer accounts, not the sender's company. For job-search/application lookalikes, I can use current or past employers as existing-company seeds.\n\nShould I search Prospeo for {icp}?"
34
34
  },
35
35
  "askOption": {
36
36
  "label": "Prospeo",
@@ -99,7 +99,7 @@ Is your ICP LinkedIn-active (founders, sales, marketing, GTM, engineers)?
99
99
  Need hiring-by-role filters? -> Prospeo (has company job-posting filters)
100
100
  Need tech stack targeting? -> Apollo (has technology filters)
101
101
  Have specific company names/domains? -> Sales Navigator for small lists or Prospeo with domainFilterId
102
- 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
102
+ Need companies like X, target-domain lookalikes, best-customer/top-customer lookalikes, job-search employer lookalikes, AI/API/SSO/Chrome extension filters, news/awards/integrations/key customers? -> Prospeo account discovery first; outbound uses target/account/customer domains or verified past-customer accounts, while job-search/application campaigns can use current/past employers as existing-company seeds
103
103
  ```
104
104
 
105
105
  ## ICP-to-Provider Quick Reference
@@ -188,19 +188,21 @@ Show the account sample first, ask approval, then pass the returned
188
188
  `confirm_prospeo_company_accounts`. The confirmed `domainFilterId` constrains
189
189
  the follow-on people search; account rows are not people leads yet.
190
190
 
191
- For lookalike seed selection, treat "best customer", "top customer", "past
192
- companies", "companies I worked with", and similar wording as customer/account
193
- or past-company seed asks. Never substitute the sender's current company or
194
- domain as a lookalike seed; never use the sender's current company/domain as a
195
- silent substitute unless the user explicitly asks for companies like the current
196
- employer, sender company, or its direct peers/competitors. Seed priority is:
197
- explicit user-provided customer/account/company/domain; verified
198
- customer/worked-with/past-company evidence from research/proof; then ask for the
199
- missing seed or switch to non-lookalike company filters if YOLO requires moving
200
- without a seed. If using profile/work-history seeds, label them as
201
- past-company/public proof clues, not confirmed customers unless the source proves
202
- customer status. If the user asks for a geography like Germany, preserve it in
203
- account discovery where supported (`company_location_search` or
191
+ For lookalike seed selection, route by campaign intent. In outbound/sales
192
+ prospecting campaigns, treat "best customer", "top customer", "target domains",
193
+ "approved accounts", "customer domains", and similar wording as target
194
+ account/customer seed asks. Use explicit user-provided target/account/customer
195
+ domains or company names first, then verified past-customer/account evidence from
196
+ research, CRM, or proof. Never substitute the sender's current company/domain or
197
+ employer history as a lookalike seed for outbound unless the user explicitly
198
+ confirms that domain is a target/customer seed or asks for sender-company peers.
199
+ In job-search/application campaigns, lookalike seeds may be existing companies
200
+ from the candidate's current or past employers because those companies define
201
+ the candidate-fit lane. If campaign intent or seed source is ambiguous, ask
202
+ whether the seed should be target/customer domains or current/past employers; if
203
+ YOLO requires moving without a seed, switch to non-lookalike company filters
204
+ instead of inventing a seed. If the user asks for a geography like Germany,
205
+ preserve it in account discovery where supported (`company_location_search` or
204
206
  `company_icp.geographic_markets`) and in follow-on people search
205
207
  (`person_location_search`); do not drop geography when moving from lookalike
206
208
  accounts to people leads.
@@ -391,22 +391,25 @@ Use first for broad persona expansion, ABM/domain targeting, hiring-led targetin
391
391
  - For companies like X, our best customers, lookalike accounts, companies that use AI, companies with API/SSO/Chrome extension, or
392
392
  news/award/integration/key-customer account filters, use
393
393
  `search_prospeo_companies` before people search.
394
- - For lookalike seed selection, treat "best customer", "top customer", "past
395
- companies", "companies I worked with", and similar wording as
396
- customer/account or past-company seed asks. Never substitute the sender's
397
- current company or domain as a lookalike seed; never use the sender's current
398
- company/domain as a silent substitute unless the user explicitly asks for
399
- companies like the current employer, sender company, or its direct
400
- peers/competitors. Seed priority is: explicit user-provided
401
- customer/account/company/domain; verified customer/worked-with/past-company
402
- evidence from research/proof; then ask for the missing seed or switch to
403
- non-lookalike company filters if YOLO requires moving without a seed. If using
404
- profile/work-history seeds, label them as past-company/public proof clues, not
405
- confirmed customers unless the source proves customer status. If the user asks
406
- for a geography like Germany, preserve it in account discovery where supported
407
- (`company_location_search` or `company_icp.geographic_markets`) and in
408
- follow-on people search (`person_location_search`); do not drop geography when
409
- moving from lookalike accounts to people leads.
394
+ - For lookalike seed selection, route by campaign intent. In outbound/sales
395
+ prospecting campaigns, treat "best customer", "top customer", "target
396
+ domains", "approved accounts", "customer domains", and similar wording as
397
+ target account/customer seed asks. Use explicit user-provided
398
+ target/account/customer domains or company names first, then verified
399
+ past-customer/account evidence from research, CRM, or proof. Never substitute
400
+ the sender's current company/domain or employer history as a lookalike seed for
401
+ outbound unless the user explicitly confirms that domain is a target/customer
402
+ seed or asks for sender-company peers. In job-search/application campaigns,
403
+ lookalike seeds may be existing companies from the candidate's current or past
404
+ employers because those companies define the candidate-fit lane. If campaign
405
+ intent or seed source is ambiguous, ask whether the seed should be
406
+ target/customer domains or current/past employers; if YOLO requires moving
407
+ without a seed, switch to non-lookalike company filters instead of inventing a
408
+ seed. If the user asks for a geography like Germany, preserve it in account
409
+ discovery where supported (`company_location_search` or
410
+ `company_icp.geographic_markets`) and in follow-on people search
411
+ (`person_location_search`); do not drop geography when moving from lookalike
412
+ accounts to people leads.
410
413
  - Use Prospeo company/account search when the ask depends on website traffic
411
414
  (`company_website_traffic`), confirmed AI Attributes including `pricing`,
412
415
  `uses_ai`, `has_api`, `has_chrome_extension`, `has_sso`, `has_open_source`,
@@ -87,19 +87,21 @@ backend resolves real Prospeo company IDs. Do not invent company_oids such as
87
87
  placeholder IDs from examples. Only send `company_lookalike.company_oids` when
88
88
  they are real Prospeo company IDs returned by a prior tool/search.
89
89
 
90
- For lookalike seed selection, treat "best customer", "top customer", "past
91
- companies", "companies I worked with", and similar wording as customer/account
92
- or past-company seed asks. Never substitute the sender's current company/domain
93
- as a lookalike seed, and never use the sender's current company/domain as a
94
- silent substitute unless the user explicitly asks for companies like the current
95
- employer, sender company, or its direct peers/competitors. Seed priority is:
96
- explicit user-provided customer/account/company/domain; verified
97
- customer/worked-with/past-company evidence from research/proof; then ask for the
98
- missing seed or switch to non-lookalike company filters if YOLO requires moving
99
- without a seed. If using profile/work-history seeds, label them as
100
- past-company/public proof clues, not confirmed customers unless the source proves
101
- customer status. If the user asks for a geography like Germany, preserve it in
102
- account discovery where supported (`company_location_search` or
90
+ For lookalike seed selection, route by campaign intent. In outbound/sales
91
+ prospecting campaigns, treat "best customer", "top customer", "target domains",
92
+ "approved accounts", "customer domains", and similar wording as target
93
+ account/customer seed asks. Use explicit user-provided target/account/customer
94
+ domains or company names first, then verified past-customer/account evidence from
95
+ research, CRM, or proof. Never substitute the sender's current company/domain or
96
+ employer history as a lookalike seed for outbound unless the user explicitly
97
+ confirms that domain is a target/customer seed or asks for sender-company peers.
98
+ In job-search/application campaigns, lookalike seeds may be existing companies
99
+ from the candidate's current or past employers because those companies define
100
+ the candidate-fit lane. If campaign intent or seed source is ambiguous, ask
101
+ whether the seed should be target/customer domains or current/past employers; if
102
+ YOLO requires moving without a seed, switch to non-lookalike company filters
103
+ instead of inventing a seed. If the user asks for a geography like Germany,
104
+ preserve it in account discovery where supported (`company_location_search` or
103
105
  `company_icp.geographic_markets`) and in follow-on people search
104
106
  (`person_location_search`); do not drop geography when moving from lookalike
105
107
  accounts to people leads.
@@ -126,8 +128,9 @@ Avoidable-400 guardrails:
126
128
  - 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.
127
129
  - 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.
128
130
  - Do not send placeholder seed names such as `another approved best-customer seed`; use only concrete company names or domains you have actually resolved.
129
- - Do not silently use the sender company as a customer lookalike seed; use
130
- explicit customer/account/past-company evidence instead.
131
+ - Do not silently use the sender company as a customer lookalike seed for
132
+ outbound; use explicit target/account/customer domains or verified
133
+ past-customer evidence instead.
131
134
  - If the user references another approved seed but does not name it, ask for the
132
135
  seed or run a one-seed lookalike without `match_all`; do not invent a second
133
136
  seed from examples, competitors, or exclusions.
@@ -294,10 +297,11 @@ Preference rules:
294
297
  - 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.
295
298
  - 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.
296
299
  - For seeded lookalikes, avoid first-call `has_api` + `has_sso`; use one confirmed attribute first, then refine.
297
- - For customer, best-customer, top-customer, or past-company lookalikes, never
298
- use the sender's current company/domain as a silent substitute; use explicit
299
- customer/account/past-company evidence, then label profile-derived seeds as
300
- past-company/public proof clues unless customer status is verified.
300
+ - For outbound customer, best-customer, or top-customer lookalikes, never use the
301
+ sender's current company/domain as a silent substitute; use explicit
302
+ target/account/customer domains or verified past-customer evidence. For
303
+ job-search/application campaigns, current/past employers may be the lookalike
304
+ seeds because the campaign is about finding similar employers.
301
305
  - If the user gives geography like Germany, keep that geography in the company
302
306
  discovery or follow-on people filters instead of dropping it after account
303
307
  confirmation.