# mcp-people-finder

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/mambalabsdev/mcp-people-finder  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/mcp-people-finder

## Description
Find people at a company by role, seniority and department, with verified business emails.

## Claude Desktop Quick Installation
Heuristic fallback — verify the package name and runner against the repository README before running it. Uses `npx` (confidence: low):

```json
"mcpServers": {
  "mcp-people-finder": {
    "command": "npx",
    "args": ["-y","mcp-people-finder"]
  }
}
```

## Documentation & README

# People Finder & Email Verifier MCP Server

[![Smithery](https://smithery.ai/badge/mambabuilt/mcp-people-finder)](https://smithery.ai/servers/mambabuilt/mcp-people-finder) [![Glama score](https://glama.ai/mcp/servers/mambalabsdev/mcp-people-finder/badges/score.svg)](https://glama.ai/mcp/servers/mambalabsdev/mcp-people-finder) [![MCP Registry](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fregistry.modelcontextprotocol.io%2Fv0%2Fservers%3Fsearch%3Dcom.mambabuilt%252Fmcp-people-finder%26limit%3D1&query=%24.servers%5B0%5D._meta%5B%22io.modelcontextprotocol.registry%2Fofficial%22%5D.status&label=mcp%20registry&color=blue)](https://registry.modelcontextprotocol.io/v0/servers?search=com.mambabuilt/mcp-people-finder&limit=1) [![npm version](https://img.shields.io/npm/v/@mambalabsdev/mcp-people-finder)](https://www.npmjs.com/package/@mambalabsdev/mcp-people-finder) [![npm downloads](https://img.shields.io/npm/dm/@mambalabsdev/mcp-people-finder)](https://www.npmjs.com/package/@mambalabsdev/mcp-people-finder) [![license](https://img.shields.io/github/license/mambalabsdev/mcp-people-finder)](https://github.com/mambalabsdev/mcp-people-finder/blob/main/LICENSE) [![mcpservers.org](https://img.shields.io/badge/mcpservers.org-listed-blue)](https://mcpservers.org/servers/mambalabsdev/mcp-people-finder)

MCP server for the Mamba Labs [People Finder & Email Verifier](https://apify.com/mambalabs/people-finder) actor on Apify.

Give it a company domain, name or LinkedIn URL and it returns the people at that company who match your role, seniority and department filters, each as a structured contact record with an optional verified business email.

## Install

```bash
npx -y @mambalabsdev/mcp-people-finder
```

### Claude Desktop

```json
{
  "mcpServers": {
    "mamba-people-finder": {
      "command": "npx",
      "args": ["-y", "@mambalabsdev/mcp-people-finder"],
      "env": { "APIFY_TOKEN": "your-apify-token" }
    }
  }
}
```

Get an Apify token at [console.apify.com/account/integrations](https://console.apify.com/account/integrations).

## Tool

### `find_people_and_emails`

Give it a company domain, name or LinkedIn URL and it returns the people at that company who match your role, seniority and department filters, each as a structured contact record with an optional verified business email.

| Input | Type | Required | Notes |
| --- | --- | --- | --- |
| `domain` | string | no | Bare domain without https:// or trailing slash. Example: stripe.com |
| `company_name` | string | no | Used when no domain is available, or as a disambiguation hint alongside a domain. |
| `linkedin_company_url` | string | no | Example: https://www.linkedin.com/company/stripe. Skips internal company resolution when provided. |
| `domains` | array | no | Optional list of bare domains. Takes precedence over the single domain field. Each domain is searched independently and every output row echoes its source domain. |
| `targetCount` | integer | no | Maximum people to return per company. Billing is per person actually returned, so a lower number is a hard cost cap. |
| `jobTitles` | array | no | Case-insensitive substring match against the person's current title. Any match qualifies. Leave empty for no title filter. Example: VP Sales, Head of Growth |
| `excludeJobTitles` | array | no | Case-insensitive substring match. A person matching any of these is dropped even if they matched an include. Example: intern, assistant, former |
| `seniority` | array | no | Filter to these normalized seniority levels. Leave empty for all. |
| `departments` | array | no | Filter to these normalized departments. Leave empty for all. |
| `countries` | array | no | ISO 3166-1 alpha-2 codes. Filters to people located in these countries. Example: US, GB, NL |
| `includeEmails` | boolean | no | Discover a business email for each person found, using your Icypeas and/or Prospeo keys. Billed only when an email is actually returned. Turn off to build an org map cheaply. |
| `verifyEmails` | boolean | no | Check deliverability of each email found, escalating catch-all domains to a second provider for a definitive answer. Requires a Reoon and/or BounceBan key. |
| `verifyPosition` | boolean | no | Check that the person still holds the returned title at the target company, and report the reasoning. Reduces bounced outreach to people who have moved on. |
| `suppressLinkedInUrls` | array | no | LinkedIn profile URLs to exclude from results. Use to suppress already-contacted prospects or honor data subject removal requests. |
| `batchSize` | integer | no | How many companies to search concurrently in batch mode. Default 5, maximum 10. |
| `skipCache` | boolean | no | Results are cached for 7 days and reused on repeat lookups. Set true to force a fresh search. |
| `serpApiKey` | string | no | Serper.dev API key. Unlocks the search layer, which is the highest-coverage source of LinkedIn profile URLs. Without it this actor falls back to company website parsing only, which returns far fewer people. Get a key at https://serper.dev. You are billed by Serper for searches; this actor does not mark them up. |
| `prospeoApiKey` | string | no | Second provider in the email waterfall. Used only for people the first provider could not resolve. Get a key at https://prospeo.io. Billed to you by Prospeo; this actor does not mark it up. |
| `reoonApiKey` | string | no | Primary email verification. Returns deliverability status for each discovered address. Get a key at https://emailverifier.reoon.com. Billed to you by Reoon. |
| `bounceBanApiKey` | string | no | Catch-all resolution. Used only when the primary verifier returns catch-all or risky, to determine whether that specific mailbox exists. Get a key at https://bounceban.com. Billed to you by BounceBan. |
| `icypeasApiKey` | string | no | Optional. Only used for the licensed-database fallback layer, which runs when the company website and public search results do not yield enough people. Leave empty to skip that layer entirely; the run still succeeds and reports any shortfall in the summary. |
| `claudeApiKey` | string | no | Optional. Only used to classify job titles that the built-in rule table cannot place into a seniority and department. One batched call per run, never per person. Leave empty to leave those two fields null on the affected rows. |

## Billing

You are charged per company searched, per person found, per email found, per email verified, per position verified and per SERP query, plus a small actor start fee. A lower targetCount is a hard cost cap.

Pricing is on the [actor's Apify page](https://apify.com/mambalabs/people-finder). 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]( https://apify.com/mambalabs/people-finder). This wrapper is [MIT licensed](LICENSE).

Built by [Mamba Labs](https://apify.com/mambalabs)