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

Terminal

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

Claude Desktop

config.json

{
  "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.
`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.
`country`	string	no	Two letter country code for job search, for example us or gb.
`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.
`max_results`	string	no	Cap on postings returned per run. Keeps a broad keyword set from running away.
`max_pages`	string	no	1 to 5. Each page is one SerpAPI call, so this is the main cost dial on discovery.
`new_postings_only`	string	no	true to return only postings not seen in a previous run.
`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.
`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.
`exclude_marketplaces`	string	no	true to drop Upwork, Fiverr, Freelancer and similar gig listings.
`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.
`target_contacts`	string	no	1 to 25.
`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.
`verify_email`	string	no	true to verify each address. Needs a Reoon or BounceBan key.
`score_icp`	string	no	true to score every row against the ICP rules and tier it A to D.
`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.
`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.
`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.
`source_timeout_secs`	string	no	5 to 120. A source that exceeds this is marked degraded and the run continues.
`skip_cache`	string	no	true to ignore the 7 day cross-run cache and recompute everything.
`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.
`reoon_api_key`	string	no	Your Reoon key. First email verification provider.
`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.

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.

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.

Source

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

Built by Mamba Labs