Skip to main content
Glama
mambalabsdev

Prospect Engine MCP Server

Prospect Engine MCP Server

Smithery Glama score MCP Registry npm version npm downloads license mcpservers.org

MCP server for the Mamba Labs Prospect Engine actor on Apify.

Four modes in one actor: enrich companies you already have, discover who is hiring for your keywords, find contacts at a company, or run the whole chain end to end with an ICP gate in the middle.

Install

npx -y @mambalabsdev/mcp-b2b-prospect-engine

Claude Desktop

{
  "mcpServers": {
    "mamba-b2b-prospect-engine": {
      "command": "npx",
      "args": ["-y", "@mambalabsdev/mcp-b2b-prospect-engine"],
      "env": { "APIFY_TOKEN": "your-apify-token" }
    }
  }
}

Get an Apify token at console.apify.com/account/integrations.

Related MCP server: Prospeo MCP Server

Tool

run_prospect_engine

Four modes in one actor: enrich companies you already have, discover who is hiring for your keywords, find contacts at a company, or run the whole chain end to end with an ICP gate in the middle.

Input

Type

Required

Notes

mode

enum

no

What to run. enrich_companies resolves identity, firmographics, LinkedIn and social for each company. discover_jobs finds who is hiring for your keywords and resolves the real employer from the job description. find_contacts finds people at each company. full chains all three. Default: "enrich_companies". One of: enrich_companies, discover_jobs, find_contacts, full.

domains

array

no

One domain per line. Used by enrich_companies and find_contacts.

company_names

array

no

One name per line. Used when you have a name but no domain.

keywords

array

no

Roles to search for. Used by discover_jobs and full. Example: copy editor, proofreader, content editor. Default: ["copy editor", "proofreader", "content editor"].

country

string

no

Two letter country code for job search, for example us or gb. Default: "us".

location

string

no

Optional location filter for job search, for example New York.

lookback_days

string

no

Drop postings older than this many days. Sent as a string because Clay sends every field as a string. Default: "30".

max_results

string

no

Cap on postings returned per run. Keeps a broad keyword set from running away. Default: "25".

max_pages

string

no

1 to 5. Each page is one SerpAPI call, so this is the main cost dial on discovery. Default: "1".

new_postings_only

string

no

true to return only postings not seen in a previous run. Default: "false".

previous_run_date

string

no

YYYY-MM-DD watermark for delta detection when the cross-run cache is unavailable.

remote_only

string

no

true to keep only postings flagged remote by the board. Default: "false".

company_size_min

string

no

Drop companies below this headcount. Only takes effect once headcount is known, so it applies in full mode and to any discovery row that carried an employee count. Discovery alone does not enrich.

company_size_max

string

no

Drop companies above this headcount. Same condition as the minimum.

exclude_staffing

string

no

true to drop postings from staffing and recruitment agencies. Default: "true".

exclude_marketplaces

string

no

true to drop Upwork, Fiverr, Freelancer and similar gig listings. Default: "true".

extra_marketplaces

array

no

Additional marketplace names to filter out.

fetch_posting_page

string

no

true to open the job posting when the description alone does not identify the employer. Slower, and it is what catches a job board posting on an employer's behalf. Default: "true".

target_contacts

string

no

1 to 25. Default: "3".

target_roles

array

no

Only enrich contacts whose title plausibly matches one of these roles. Filters after discovery and before any paid email lookup, so a non-matching contact costs nothing. Leave empty to keep every contact the seniority and department filters allow.

deny_tokens

array

no

Whole words that disqualify a contact even when the title matched a target role, for example product refuses Product Owner and keeps Production Editor. Applies even when no target roles are set.

company_concurrency

string

no

How many companies to work at once. Simultaneous provider calls are this times contact_concurrency; 6 x 3 = 18 sits under the tightest documented provider ceiling. Default: "6".

contact_concurrency

string

no

How many contacts to enrich at once within one company. The email waterfall itself always runs in order. Default: "3".

max_spend_usd

string

no

Stop making paid vendor calls once this much of your own vendor spend (Findymail, Icypeas, Prospeo, BounceBan) is committed, and return everything completed so far. Caps your vendor bills, not the Apify charge for this actor. Leave empty for no cap.

max_charge_usd

number

no

Your cap on this actor's Apify charge for the run, in USD. A charge that would cross it is not made, the run stops, and one notice row says so. Separate from max_spend_usd, which caps your own vendor bills.

job_titles

array

no

Titles to search for when finding contacts.

seniority

array

no

c_level, vp, director, manager, senior.

departments

array

no

marketing, sales, engineering, product, finance, hr, operations, legal.

include_email

string

no

true to run the email waterfall. Needs an Icypeas or Prospeo key, which you supply and are billed for directly. Default: "false".

verify_email

string

no

true to verify each address. Needs a BounceBan key. Default: "true".

verify_position

string

no

true to ask a model whether each contact's title on record is consistent and plausibly current, from the supplied evidence only. Needs claude_api_key; skipped without it. Contacts found on the company's own website are skipped. Default: "true".

personalize

string

no

true to write a one or two sentence opener per contact that has an address, referencing something specific about the company. Needs claude_api_key; skipped without it. Default: "true".

brand_voice

string

no

How the opener should sound. Leave empty and it writes plainly and directly.

score_icp

string

no

true to score every row against the ICP rules and tier it A to D. Default: "true".

icp_preset

enum

no

Which scoring model to apply. "editorial_services" scores for a seller of managed copy editing and proofreading. "generic_b2b" scores on hiring intent, employer resolvability and headcount with no service-specific vocabulary. Default: "editorial_services". One of: editorial_services, generic_b2b.

min_icp_score

string

no

In full mode, only companies scoring at or above this go on to contact discovery. Default 45: at 25 the filter passed every keyword-discovered editorial posting, because 25 is the floor such a posting can score. Default: "45".

extra_exclude_names

array

no

Any company whose name contains one of these is excluded.

signal_taxonomy

array

no

Override the default signal types. Each entry is an object with type, strength, title_keywords, and optional also_keywords and description_keywords.

include_social

string

no

true to resolve Facebook, Instagram, X and YouTube alongside LinkedIn. Default: "true".

source_timeout_secs

string

no

5 to 120. A source that exceeds this is marked degraded and the run continues. Default: "30".

skip_cache

string

no

true to ignore the 7 day cross-run cache and recompute everything. Default: "false".

serper_api_key

string

no

Your Serper.dev key. Powers people search in find_contacts, which is the highest-coverage layer. Without it the free fallback is measurably poor.

findymail_api_key

string

no

Your Findymail key. First provider in the email waterfall.

icypeas_api_key

string

no

Your Icypeas key. Runs on Findymail misses.

prospeo_api_key

string

no

Your Prospeo key. Runs on the residual after Findymail and Icypeas.

bounceban_api_key

string

no

Your BounceBan key. Second verifier, used for the catch-all case.

serpapi_key

string

no

Your SerpApi key. Required by discover_jobs and full. Distinct from a Serper key: different vendor.

claude_api_key

string

no

Your own Anthropic key, used for position verification and the personalized opener. Both steps are skipped when it is absent. Never stored.

Billing

You are charged per company enriched, per contact verified and per job posting discovered, at different rates for basic and full enrichment. Vendor API calls are billed to you by those vendors directly. Set max_spend_usd to cap that vendor spend per run, and target_roles to skip paid lookups for contacts outside the roles you want. verify_position and personalize run on your own Anthropic key (claude_api_key) and are skipped without it.

Price per event on the Apify FREE plan, from the live pricing record; paid Apify plans pay less per event.

Event

Price (USD)

Company enriched, basic (company-enriched-basic)

0.02

Company enriched, full (company-enriched-full)

0.08

Contact verified (contact-verified)

0.015

Job posting discovered (job-posting-discovered)

0.01

Company enriched, basic, chained run (company-enriched-basic-composed)

0.015

Company enriched, full, chained run (company-enriched-full-composed)

0.06

Contact verified, chained run (contact-verified-composed)

0.01125

Job posting discovered, chained run (job-posting-discovered-composed)

0.0075

Company enriched, full, reserved rate (company-enriched-full-founding)

0.05

Contact verified, reserved rate (contact-verified-founding)

0.009

Job posting discovered, reserved rate (job-posting-discovered-founding)

0.005

Pricing is on the actor's Apify page. Running this server consumes Apify credits.

What this server does and does not do

It is a thin client for the Apify actor. It passes your input through and returns the actor's output unchanged. Every behavior described above lives in the actor, not here.

Errors are surfaced, never swallowed. An invalid input, an invalid token, an exhausted balance, a timeout, or a run that returns anything other than a dataset all come back as an explicit tool error rather than as an empty result.

The tool starts the actor run and polls it to a finished status, so a long run is not cut off at 300 seconds. The run is allowed 1,800 seconds. If it is still going two minutes after that, the call stops waiting and returns the run ID with a link to it in the Apify Console, where the results land when it finishes. A run that does not succeed comes back as an error with its run ID and status. A full or find_contacts run over many companies can take several minutes, which is why this matters here.

Source

The actor is on the Apify Store. This wrapper is MIT licensed.

Built by Mamba Labs

Available Tools

1 tool
run_prospect_engineRun Prospect EngineA
Idempotent

A composed prospecting actor with four modes. enrich_companies resolves identity, firmographics, LinkedIn and social for each domain or company name you supply, and needs no vendor key at all. discover_jobs finds who is hiring for your keywords and resolves the real employer behind each posting, including postings a job board placed on an employer's behalf. find_contacts finds people at the companies you name, with optional email discovery and verification. full runs discovery, enrichment, ICP scoring and then contact discovery, passing only the companies at or above min_icp_score through to the contact stage. Every row comes back flat and Clay ready with per field provenance. Vendor keys are yours: you supply them, those vendors bill you directly, and the per event price covers the actor only. discover_jobs and full require a SerpApi key, which is a different vendor from the Serper key that powers people search. Use it when you need companies, hiring signals, or contacts in one flat table. Do not use it to verify a single email you already have (that is the Work Email Waterfall) or to score a list you already enriched (that is the ICP Fit Scorer). Cost controls: max_results and max_pages bound discovery, target_contacts bounds contacts per company, target_roles skips paid lookups for non-matching contacts, and max_spend_usd caps your own vendor spend. Requires an APIFY_TOKEN and consumes Apify credits. Read only: it enriches and discovers, it writes nothing.

ParametersJSON Schema
NameRequiredDescriptionDefault
modeNoWhat to run. enrich_companies resolves identity, firmographics, LinkedIn and social for each company. discover_jobs finds who is hiring for your keywords and resolves the real employer from the job description. find_contacts finds people at each company. full chains all three. Default: "enrich_companies".
countryNoTwo letter country code for job search, for example us or gb. Default: "us".
domainsNoOne domain per line. Used by enrich_companies and find_contacts.
keywordsNoRoles to search for. Used by discover_jobs and full. Example: copy editor, proofreader, content editor. Default: ["copy editor", "proofreader", "content editor"].
locationNoOptional location filter for job search, for example New York.
max_pagesNo1 to 5. Each page is one SerpAPI call, so this is the main cost dial on discovery. Default: "1".
score_icpNotrue to score every row against the ICP rules and tier it A to D. Default: "true".
seniorityNoc_level, vp, director, manager, senior.
icp_presetNoWhich scoring model to apply. "editorial_services" scores for a seller of managed copy editing and proofreading. "generic_b2b" scores on hiring intent, employer resolvability and headcount with no service-specific vocabulary. Default: "editorial_services".
job_titlesNoTitles to search for when finding contacts.
skip_cacheNotrue to ignore the 7 day cross-run cache and recompute everything. Default: "false".
brand_voiceNoHow the opener should sound. Leave empty and it writes plainly and directly.
deny_tokensNoWhole words that disqualify a contact even when the title matched a target role, for example product refuses Product Owner and keeps Production Editor. Applies even when no target roles are set.
departmentsNomarketing, sales, engineering, product, finance, hr, operations, legal.
max_resultsNoCap on postings returned per run. Keeps a broad keyword set from running away. Default: "25".
personalizeNotrue to write a one or two sentence opener per contact that has an address, referencing something specific about the company. Needs claude_api_key; skipped without it. Default: "true".
remote_onlyNotrue to keep only postings flagged remote by the board. Default: "false".
serpapi_keyNoYour SerpApi key. Required by discover_jobs and full. Distinct from a Serper key: different vendor.
target_rolesNoOnly enrich contacts whose title plausibly matches one of these roles. Filters after discovery and before any paid email lookup, so a non-matching contact costs nothing. Leave empty to keep every contact the seniority and department filters allow.
verify_emailNotrue to verify each address. Needs a BounceBan key. Default: "true".
company_namesNoOne name per line. Used when you have a name but no domain.
include_emailNotrue to run the email waterfall. Needs an Icypeas or Prospeo key, which you supply and are billed for directly. Default: "false".
lookback_daysNoDrop postings older than this many days. Sent as a string because Clay sends every field as a string. Default: "30".
max_spend_usdNoStop making paid vendor calls once this much of your own vendor spend (Findymail, Icypeas, Prospeo, BounceBan) is committed, and return everything completed so far. Caps your vendor bills, not the Apify charge for this actor. Leave empty for no cap.
min_icp_scoreNoIn full mode, only companies scoring at or above this go on to contact discovery. Default 45: at 25 the filter passed every keyword-discovered editorial posting, because 25 is the floor such a posting can score. Default: "45".
claude_api_keyNoYour own Anthropic key, used for position verification and the personalized opener. Both steps are skipped when it is absent. Never stored.
include_socialNotrue to resolve Facebook, Instagram, X and YouTube alongside LinkedIn. Default: "true".
max_charge_usdNoOptional. The actor's own spend cap for this run, in USD. The run stops before a charge would take its total past this amount, writes one notice row saying so, and keeps every row already charged. Leave it empty for no cap of your own; the maximum cost per run set in Apify is honored either way.
serper_api_keyNoYour Serper.dev key. Powers people search in find_contacts, which is the highest-coverage layer. Without it the free fallback is measurably poor.
icypeas_api_keyNoYour Icypeas key. Runs on Findymail misses.
prospeo_api_keyNoYour Prospeo key. Runs on the residual after Findymail and Icypeas.
signal_taxonomyNoOverride the default signal types. Each entry is an object with type, strength, title_keywords, and optional also_keywords and description_keywords.
target_contactsNo1 to 25. Default: "3".
verify_positionNotrue to ask a model whether each contact's title on record is consistent and plausibly current, from the supplied evidence only. Needs claude_api_key; skipped without it. Contacts found on the company's own website are skipped. Default: "true".
company_size_maxNoDrop companies above this headcount. Same condition as the minimum.
company_size_minNoDrop companies below this headcount. Only takes effect once headcount is known, so it applies in full mode and to any discovery row that carried an employee count. Discovery alone does not enrich.
exclude_staffingNotrue to drop postings from staffing and recruitment agencies. Default: "true".
bounceban_api_keyNoYour BounceBan key. Second verifier, used for the catch-all case.
findymail_api_keyNoYour Findymail key. First provider in the email waterfall.
new_postings_onlyNotrue to return only postings not seen in a previous run. Default: "false".
previous_run_dateNoYYYY-MM-DD watermark for delta detection when the cross-run cache is unavailable.
extra_marketplacesNoAdditional marketplace names to filter out.
fetch_posting_pageNotrue to open the job posting when the description alone does not identify the employer. Slower, and it is what catches a job board posting on an employer's behalf. Default: "true".
company_concurrencyNoHow many companies to work at once. Simultaneous provider calls are this times contact_concurrency; 6 x 3 = 18 sits under the tightest documented provider ceiling. Default: "6".
contact_concurrencyNoHow many contacts to enrich at once within one company. The email waterfall itself always runs in order. Default: "3".
extra_exclude_namesNoAny company whose name contains one of these is excluded.
source_timeout_secsNo5 to 120. A source that exceeds this is marked degraded and the run continues. Default: "30".
exclude_marketplacesNotrue to drop Upwork, Fiverr, Freelancer and similar gig listings. Default: "true".

TDQS

A4/5.0
Behavior1/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

The description asserts 'Read only: it enriches and discovers, it writes nothing,' while the annotations explicitly declare readOnlyHint=false. That is a direct negation of the structured safety signal, and the actor in fact writes cache state and output/notice rows and consumes credits, so the text is also factually off. Per the rubric, a description that contradicts its annotations scores 1; otherwise this text would be rich (it does disclose APIFY_TOKEN auth, per-vendor billing, concurrency ceilings and cost caps).

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Long (~10 sentences) but front-loaded: modes first, then mode/key dependencies, then usage boundaries, then cost controls, then auth. For a 48-parameter multi-mode actor the length is justified and nearly every sentence carries non-redundant information; only the trailing read-only claim is wasted and misleading.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Despite having no output schema, the description states the return shape ('every row comes back flat and Clay ready with per field provenance'), the mode pipeline, the required APIFY_TOKEN, the bring-your-own-key vendor model, and the cost/limit controls. An agent has enough to invoke it correctly and to anticipate the billing and result format.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the per-parameter baseline is 3, but the description adds genuine cross-parameter meaning: it groups max_results/max_pages/target_contacts/target_roles/max_spend_usd into a single cost-control model and states which vendor key is required by which mode (SerpApi for discover_jobs/full vs Serper for people search). That relational context is not derivable from any single property description.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Names a specific composite actor and enumerates all four modes (enrich_companies, discover_jobs, find_contacts, full) with what each does, including the pipeline ordering in full mode. An agent immediately knows the verb, resource, and scope, and the definition also distinguishes itself from the named non-sibling tools (Work Email Waterfall, ICP Fit Scorer).

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives an explicit positive trigger ('Use it when you need companies, hiring signals, or contacts in one flat table') and explicit exclusions with the correct alternatives named ('Do not use it to verify a single email... that is the Work Email Waterfall... or to score a list you already enriched... that is the ICP Fit Scorer'). This is textbook when/when-not guidance.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 1 tool updatev1.2.0
    • Changedrun_prospect_engine14 fields changed
      • addedInput schema / properties / brand_voice
        Added value: +{
        +  "description": "How the opener should sound. Leave empty and it writes plainly and directly.",
        +  "type": "string"
        +}
      • addedInput schema / properties / claude_api_key
        Added value: +{
        +  "description": "Your own Anthropic key, used for position verification and the personalized opener. Both steps are skipped when it is absent. Never stored.",
        +  "type": "string"
        +}
      • addedInput schema / properties / company_concurrency
        Added value: +{
        +  "description": "How many companies to work at once. Simultaneous provider calls are this times contact_concurrency; 6 x 3 = 18 sits under the tightest documented provider ceiling. Default: \"6\".",
        +  "type": "string"
        +}
      • addedInput schema / properties / contact_concurrency
        Added value: +{
        +  "description": "How many contacts to enrich at once within one company. The email waterfall itself always runs in order. Default: \"3\".",
        +  "type": "string"
        +}
      • addedInput schema / properties / deny_tokens
        Added value: +{
        +  "description": "Whole words that disqualify a contact even when the title matched a target role, for example product refuses Product Owner and keeps Production Editor. Applies even when no target roles are set.",
        +  "items": {
        +    "type": "string"
        +  },
        +  "type": "array"
        +}
      • changedInput schema / properties / icp_preset / description
        Previous value: -"Which scoring model to apply. \"proofed_editorial\" scores for a seller of managed copy editing and proofreading. \"generic_b2b\" scores on hiring intent, employer resolvability and headcount with no service-specific vocabulary. Default: \"proofed_editorial\"."New value: +"Which scoring model to apply. \"editorial_services\" scores for a seller of managed copy editing and proofreading. \"generic_b2b\" scores on hiring intent, employer resolvability and headcount with no service-specific vocabulary. Default: \"editorial_services\"."
      • changedInput schema / properties / icp_preset / enum
        Previous value: -[
        -  "proofed_editorial",
        -  "generic_b2b"
        -]New value: +[
        +  "editorial_services",
        +  "generic_b2b"
        +]
      • addedInput schema / properties / max_charge_usd
        Added value: +{
        +  "description": "Optional. The actor's own spend cap for this run, in USD. The run stops before a charge would take its total past this amount, writes one notice row saying so, and keeps every row already charged. Leave it empty for no cap of your own; the maximum cost per run set in Apify is honored either way.",
        +  "minimum": 0,
        +  "type": "number"
        +}
      • addedInput schema / properties / max_spend_usd
        Added value: +{
        +  "description": "Stop making paid vendor calls once this much of your own vendor spend (Findymail, Icypeas, Prospeo, BounceBan) is committed, and return everything completed so far. Caps your vendor bills, not the Apify charge for this actor. Leave empty for no cap.",
        +  "type": "string"
        +}
      • addedInput schema / properties / personalize
        Added value: +{
        +  "description": "true to write a one or two sentence opener per contact that has an address, referencing something specific about the company. Needs claude_api_key; skipped without it. Default: \"true\".",
        +  "type": "string"
        +}
      • removedInput schema / properties / reoon_api_key
        Removed value: -{
        -  "description": "Your Reoon key. First email verification provider.",
        -  "type": "string"
        -}
      • addedInput schema / properties / target_roles
        Added value: +{
        +  "description": "Only enrich contacts whose title plausibly matches one of these roles. Filters after discovery and before any paid email lookup, so a non-matching contact costs nothing. Leave empty to keep every contact the seniority and department filters allow.",
        +  "items": {
        +    "type": "string"
        +  },
        +  "type": "array"
        +}
      • changedInput schema / properties / verify_email / description
        Previous value: -"true to verify each address. Needs a Reoon or BounceBan key. Default: \"true\"."New value: +"true to verify each address. Needs a BounceBan key. Default: \"true\"."
      • addedInput schema / properties / verify_position
        Added value: +{
        +  "description": "true to ask a model whether each contact's title on record is consistent and plausibly current, from the supplied evidence only. Needs claude_api_key; skipped without it. Contacts found on the company's own website are skipped. Default: \"true\".",
        +  "type": "string"
        +}
  2. 1 tool updatev1.0.0
    • First observedrun_prospect_engine

TDQS

A4/5.0

Scored across 1 tool

Disambiguation5/5

With only one tool, there is no possibility of misselection between tools. The four modes are clearly described within the single tool, so an agent knows exactly what the tool does.

Naming Consistency5/5

The single tool name 'run_prospect_engine' follows a clear verb_noun snake_case convention. With no other tools, there is no inconsistency to evaluate.

Tool Count3/5

A single tool for a broad prospecting domain covering enrichment, job discovery, contact finding, and full pipeline feels thin. While the tool is intentionally composed with modes, one tool limits granular control and selection.

Completeness3/5

The tool covers core discovery and enrichment workflows, but explicitly references separate tools for verifying a single email and scoring an enriched list that are not present. These are notable gaps for a complete prospecting surface, though core operations are present.

Maintenance

ActivityMaintained
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    D
    maintenance
    Enables comprehensive LinkedIn profile search, data extraction, and contact enrichment using Google Search, Apollo.io, and AI-powered analysis. Includes automated data mining workflows with database storage and CSV export capabilities.
    3
    ISC
  • A
    license
    A
    quality
    D
    maintenance
    Enables AI tools to search and enrich B2B leads, including finding professional emails, company profiles, and filtering people and companies by various criteria.
    5
    283 npm
    MIT
  • A
    license
    A
    quality
    A
    maintenance
    Enables pushing enriched leads into Instantly or Smartlead campaigns with ICP score gating, deduplication, and dry-run previews via an Apify actor.
    1
    111 npm
    MIT