mcp-personal-email-to-company-resolver
LocalAbout mcp-personal-email-to-company-resolver
This MCP server uses an Apify Actor to infer employers from public Gravatar, GitHub, and related evidence for personal email addresses. It returns confidence and evidence details for lead screening.
Key features
- 01Resolve up to 300 email addresses
- 02Read public Gravatar and GitHub profiles
- 03Optional web search and LinkedIn resolution
- 04Return employer, domain, confidence, and evidence
- 05Provide match status and a charge cap
Use cases
- 01Screen leads who signed up with free email
- 02Check a likely employer and its evidence
- 03Organize email-to-company matches in bulk
MCP support
The `resolve_personal_email_employer` MCP tool accepts one or more addresses and returns the Apify Actor results. It does not access mailboxes or open LinkedIn.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
npx -y @mambalabsdev/mcp-personal-email-to-company-resolverAPIFY_TOKENSecretApify API token from https://console.apify.com/account/integrationsLocal servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.
Tools
1Saved tool list · updated 1w ago
| Parameter | Type | Required | Description |
|---|---|---|---|
| string | No | One email address, for example a signup on a Gmail address. | |
| emails | array | No | Several addresses, up to 300. A company address returns its own domain, free. |
| country | string | No | Two letter Google country code. Default us. |
| search_web | enum | No | true adds one exact Google search for an address that Gravatar and GitHub leave without an employer. Default false.true | false |
| github_token | string | No | Optional. Your own free GitHub token, for batches over about 25 addresses. Used for this run only and never stored. |
| max_charge_usd | string | No | Optional. The run stops before a charge that would pass this amount; it is passed to the LinkedIn step too. |
| use_linkedin_resolver | enum | No | true (default) runs Mamba Labs Person LinkedIn URL Resolver from your account for the addresses with a name and an employer, billed at that actor's own price per person sent to it, found or not (0.035 USD on the free plan). false skips it.true | false |
Details
From the project READMEPersonal Email to Company Resolver MCP Server
Give it a free mail address (Gmail, Outlook, iCloud, Yahoo, and about 140 more consumer domains). Each run reads the public Gravatar profile for the address, the GitHub account whose public commits are signed with it, and, for a name with an employer, Mamba Labs Person LinkedIn URL Resolver. It returns one row per address with the person's name, likely employer, employer domain, and a confidence. It never contacts the mailbox and never opens LinkedIn.
What's Inside
- What it does
- Quick start
- Prerequisites
- Example prompts
- Tool
- Inputs
- Pricing
- Your keys
- Full actor documentation
- License
What it does
match_statusisresolved(employer at 0.75 or more, billed),weak,name_only,corporate_email,not_found,invalid_email, orblocked, and onlyresolvedis billed.employer_sourcesays where the employer came from:gravatar,github,web_result,linkedin_headline, oremail_domain.evidence_urlslists the public pages.- The LinkedIn step raises the confidence when a LinkedIn result shows the employer as current and lowers it when it shows it as former.
All of the work runs on Apify. This package is a thin client that starts the actor run, waits for it, and hands back the dataset rows.
Quick start
You need Node.js 18 or newer and an Apify account with an API token.
Add this to your Claude Desktop config (claude_desktop_config.json), Cursor, or any MCP client:
{
"mcpServers": {
"mamba-personal-email-to-company-resolver": {
"command": "npx",
"args": [
"-y",
"@mambalabsdev/mcp-personal-email-to-company-resolver"
],
"env": {
"APIFY_TOKEN": "your-apify-token"
}
}
}
}
Restart the client. The resolve_personal_email_employer tool appears.
Prerequisites
- Node.js 18 or newer.
- An Apify API token from console.apify.com/account/integrations, set as
APIFY_TOKEN. The server lists its tool without a token; a call needs one.
Example prompts
- "These ten signups used Gmail addresses. Which companies do they work at?"
- "Find the employer behind this Outlook address and show me the evidence."
Tool
resolve_personal_email_employer. One tool. Example arguments:
{ "emails": ["[email protected]"] }
Inputs
Every buyer facing input of the actor, unchanged. Omitted inputs take the actor's own defaults.
| Input | Type | Description |
|---|---|---|
email | string | One address |
emails | array | Up to 300 addresses |
github_token | string | Optional, your own free GitHub token |
search_web | string | true adds one exact Google search per address left without an employer. Default false |
use_linkedin_resolver | string | true (default) runs Person LinkedIn URL Resolver from your account, billed at its own price |
country | string | Google country code. Default us |
max_charge_usd | string | Optional cost cap for the run |
Pricing
Pay per event on Apify, billed to your Apify account. Prices in USD.
| Event | Free plan | Bronze | Silver | Gold |
|---|---|---|---|---|
email-resolved, per address with an employer at 0.75 or more | $0.025 | $0.02375 | $0.0225 | $0.02125 |
apify-actor-start, per run start | $0.0005 | $0.0005 | $0.0005 | $0.0005 |
Every other row is free. With use_linkedin_resolver on, Person LinkedIn URL Resolver bills its own events on top: $0.035 per person sent to it, found or not, plus $0.0005 per run on the free plan.
Your keys
The actor holds no key. github_token is optional and is your own, used for the run only. Mamba Labs pays the platform costs of the run, proxy traffic included.
Full actor documentation
apify.com/mambalabs/personal-email-to-company-resolver
License
MIT. See LICENSE.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.