Prospect Engine MCP Server

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.

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