mcp-person-linkedin-url-resolver
LocalAbout mcp-person-linkedin-url-resolver
An Apify-backed MCP server that finds a person's LinkedIn profile URL from their name and company. It uses Google results and returns match confidence without opening LinkedIn or requiring a LinkedIn account.
Key features
- 01Profile URL lookup by name and company
- 02Match confidence and status
- 03Company relationship classification
- 04Headline and follower count from Google
- 05Filters out non-profile URLs
Use cases
- 01Find a contact's LinkedIn profile
- 02Resolve profile URLs for CRM records
- 03Distinguish current and former company matches
MCP support
Exposes the `resolve_person_linkedin_url` tool to MCP clients. It starts the Apify actor, waits for completion, and returns dataset rows.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
npx -y @mambalabsdev/mcp-person-linkedin-url-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 6d ago
| Parameter | Type | Required | Description |
|---|---|---|---|
| country | string | No | Two letter Google country code. Default us. |
| persons | array | No | Several persons, one per line as Full Name | company.com | job title. Up to 500. |
| keywords | string | No | Optional extra words for the Google query. |
| location | string | No | Optional city or country. A small boost when the snippet agrees. |
| full_name | string | No | The person's first and last name, for example Armon Dadgar. |
| job_title | string | No | Optional. A headline that agrees gets a small boost. |
| company_name | string | No | Optional. The company name as people write it, used instead of the word in the domain. |
| company_domain | string | No | The company domain, for example hashicorp.com. Give this or company_name. |
| max_charge_usd | string | No | Optional. The run stops before a charge that would pass this amount. |
| allow_name_only | enum | No | true searches a person with no company; such a row is never found, only ambiguous. Default false.true | false |
Details
From the project READMEPerson LinkedIn URL Resolver MCP Server
Give it a person's name and company domain (or company name). Each run reads Google result pages through the Apify Google SERP proxy and returns one row per person with the LinkedIn profile URL, the headline and follower count Google shows, and a match confidence. It never opens LinkedIn and needs no LinkedIn account.
What's Inside
- What it does
- Quick start
- Prerequisites
- Example prompts
- Tool
- Inputs
- Pricing
- Your keys
- Full actor documentation
- License
What it does
match_statusisfoundat a confidence of 0.8 or more with a clear lead over every other profile,ambiguous(the likely URL),not_found, orblocked.company_matchsays whether the company iscurrent(headline or a present role),former(marked prev, ex, or former), or onlymentioned.- Posts, articles, and directory pages are dropped; only
/in/profile URLs are returned.
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-person-linkedin-url-resolver": {
"command": "npx",
"args": [
"-y",
"@mambalabsdev/mcp-person-linkedin-url-resolver"
],
"env": {
"APIFY_TOKEN": "your-apify-token"
}
}
}
}
Restart the client. The resolve_person_linkedin_url 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
- "Find the LinkedIn profile of Armon Dadgar at hashicorp.com."
- "Here are 20 names and company domains from my CRM. Find each LinkedIn URL and tell me which ones are certain."
Tool
resolve_person_linkedin_url. One tool. Example arguments:
{ "full_name": "Armon Dadgar", "company_domain": "hashicorp.com" }
Inputs
Every buyer facing input of the actor, unchanged. Omitted inputs take the actor's own defaults.
| Input | Type | Description |
|---|---|---|
full_name | string | First and last name |
company_domain | string | The company domain; give this or company_name |
company_name | string | Optional company name |
job_title | string | Optional; a small boost when the headline agrees |
location | string | Optional; a small boost when the snippet agrees |
keywords | string | Optional extra query words |
persons | array | Up to 500 lines as Full Name | company.com | job title |
country | string | Google country code. Default us |
allow_name_only | string | true searches without a company; never found |
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 |
|---|---|---|---|---|
person-searched, per input person | $0.035 | $0.03325 | $0.0315 | $0.02975 |
apify-actor-start, per run start | $0.0005 | $0.0005 | $0.0005 | $0.0005 |
found, ambiguous, and not_found rows each cost one person-searched. blocked and error rows are free. The actor reads at most 2 Google result pages per person.
Your keys
The actor needs no key and holds none. Mamba Labs pays the platform costs of the run, Google SERP proxy traffic included.
Full actor documentation
apify.com/mambalabs/person-linkedin-url-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.