This is a Model Context Protocol (MCP) server that wraps the People Data Labs API. It provides comprehensive access to People Data Labs' various data models and search capabilities.
Features
Person API
- Person Enrichment: Enrich a person's profile with additional data
- People Search: Search for people matching specific criteria using SQL-like queries
- Bulk Person Enrichment: Enrich multiple person profiles in a single request
Company API
- Company Enrichment: Enrich a company profile with additional data
- Company Search: Search for companies matching specific criteria
Additional Data Models
- School Search: Search for schools matching specific criteria
- Location Search: Search for locations matching specific criteria
- Job Title Search: Search for job titles matching specific criteria
- Skill Search: Search for skills matching specific criteria
Utilities
- Autocomplete: Get autocomplete suggestions for various fields
Setup
- Clone this repository
- Install dependencies:
npm install
- Build the project:
npm run build
- Configure your People Data Labs API key using one of the provided configuration scripts
Configuration
Automatic Configuration
This project includes scripts to automatically configure the MCP server for both Claude Desktop and VS Code:
For Claude Desktop:
npm run config:claude
For VS Code:
npm run config:vscode
Both scripts will:
1. Check if the configuration file exists and create it if needed
2. Prompt you for your People Data Labs API key
3. Add the MCP server configuration to the appropriate file
4. Provide instructions for next steps
Manual Configuration
If you prefer to configure the MCP server manually, you need to add it to your MCP settings file. The location of this file depends on your environment:
- For VS Code:
%APPDATA%CodeUserglobalStorage
ooveterinaryinc.roo-clinesettingsmcp_settings.json
- For Claude Desktop:
%APPDATA%Claudeclaude_desktop_config.json
Add the following configuration to the mcpServers object in your MCP settings file:
{
"mcpServers": {
"peopledatalabs": {
"command": "node",
"args": ["path/to/peopledatalabs-mcp/build/index.js"],
"env": {
"PDL_API_KEY": "your-api-key-here"
}
}
}
}
Replace:
- path/to/peopledatalabs-mcp/build/index.js with the actual path to the built index.js file
- your-api-key-here with your actual People Data Labs API key
enrich_person
Enrich a person profile with additional data from People Data Labs.
Parameters:
- email (string, optional): Email address of the person
- phone (string, optional): Phone number of the person
- name (string, optional): Full name of the person
- profile (array of strings, optional): Social media profile URLs of the person
- location (string, optional): Location of the person (city, state, country)
- company (string, optional): Company name where the person works
- title (string, optional): Job title of the person
- min_likelihood (number, optional): Minimum likelihood score (0-1) for the match
Note: At least one of email, phone, name, or profile must be provided.
search_people
Search for people matching specific criteria using SQL-like queries.
Parameters:
- query (string, required): SQL-like query to search for people
- size (number, optional): Number of results to return (max 100)
bulk_person_enrich
Enrich multiple person profiles in a single request.
Parameters:
- requests (array, required): Array of person enrichment requests
enrich_company
Enrich a company profile with additional data.
Parameters:
- name (string, optional): Name of the company
- website (string, optional): Website of the company
- profile (array of strings, optional): Social media profile URLs of the company
- ticker (string, optional): Stock ticker symbol of the company
Note: At least one of name, website, profile, or ticker must be provided.
search_companies
Search for companies matching specific criteria.
Parameters:
- query (string, required): SQL-like query to search for companies
- size (number, optional): Number of results to return (max 100)
search_schools
Search for schools matching specific criteria.
Parameters:
- query (string, required): SQL-like query to search for schools
- size (number, optional): Number of results to return (max 100)
search_locations
Search for locations matching specific criteria.
Parameters:
- query (string, required): SQL-like query to search for locations
- size (number, optional): Number of results to return (max 100)
search_job_titles
Search for job titles matching specific criteria.
Parameters:
- query (string, required): SQL-like query to search for job titles
- size (number, optional): Number of results to return (max 100)
search_skills
Search for skills matching specific criteria.
Parameters:
- query (string, required): SQL-like query to search for skills
- size (number, optional): Number of results to return (max 100)
autocomplete
Get autocomplete suggestions for a partial query.
Parameters:
- field (string, required): Field to autocomplete (company, school, title, skill, location)
- text (string, required): Partial text to autocomplete
- size (number, optional): Number of results to return (max 100)
Example Usage
Person API Examples
<use_mcp_tool>
<server_name>peopledatalabs</server_name>
<tool_name>enrich_person</tool_name>
<arguments>
{
"email": "[email protected]"
}
</arguments>
</use_mcp_tool>
<use_mcp_tool>
<server_name>peopledatalabs</server_name>
<tool_name>search_people</tool_name>
<arguments>
{
"query": "SELECT * FROM person WHERE location='San Francisco' AND job_title='Software Engineer'",
"size": 5
}
</arguments>
</use_mcp_tool>
Company API Examples
<use_mcp_tool>
<server_name>peopledatalabs</server_name>
<tool_name>enrich_company</tool_name>
<arguments>
{
"name": "Apple Inc."
}
</arguments>
</use_mcp_tool>
<use_mcp_tool>
<server_name>peopledatalabs</server_name>
<tool_name>search_companies</tool_name>
<arguments>
{
"query": "SELECT * FROM company WHERE location='New York' AND industry='Finance'",
"size": 5
}
</arguments>
</use_mcp_tool>
Autocomplete Example
<use_mcp_tool>
<server_name>peopledatalabs</server_name>
<tool_name>autocomplete</tool_name>
<arguments>
{
"field": "company",
"text": "Goog"
}
</arguments>
</use_mcp_tool>
License
Apache 2.0
[
{
"description": "Enrich a person profile with additional data from People Data Labs",
"inputSchema": {
"anyOf": [
{
"required": [
"email"
]
},
{
"required": [
"phone"
]
},
{
"required": [
"name"
]
},
{
"required": [
"profile"
]
}
],
"properties": {
"company": {
"description": "Company name where the person works",
"type": "string"
},
"email": {
"description": "Email address of the person",
"type": "string"
},
"location": {
"description": "Location of the person (city, state, country)",
"type": "string"
},
"min_likelihood": {
"description": "Minimum likelihood score (0-1) for the match",
"maximum": 1,
"minimum": 0,
"type": "number"
},
"name": {
"description": "Full name of the person",
"type": "string"
},
"phone": {
"description": "Phone number of the person",
"type": "string"
},
"profile": {
"description": "Social media profile URLs of the person",
"items": {
"type": "string"
},
"type": "array"
},
"title": {
"description": "Job title of the person",
"type": "string"
}
},
"type": "object"
},
"name": "enrich_person"
},
{
"description": "Search for people matching specific criteria",
"inputSchema": {
"properties": {
"query": {
"description": "SQL-like query to search for people",
"type": "string"
},
"size": {
"description": "Number of results to return (max 100)",
"maximum": 100,
"minimum": 1,
"type": "number"
}
},
"required": [
"query"
],
"type": "object"
},
"name": "search_people"
},
{
"description": "Enrich multiple person profiles in a single request",
"inputSchema": {
"properties": {
"requests": {
"description": "Array of person enrichment requests",
"items": {
"properties": {
"params": {
"description": "Parameters for person enrichment",
"type": "object"
}
},
"required": [
"params"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"requests"
],
"type": "object"
},
"name": "bulk_person_enrich"
},
{
"description": "Enrich a company profile with additional data",
"inputSchema": {
"anyOf": [
{
"required": [
"name"
]
},
{
"required": [
"website"
]
},
{
"required": [
"profile"
]
},
{
"required": [
"ticker"
]
}
],
"properties": {
"name": {
"description": "Name of the company",
"type": "string"
},
"profile": {
"description": "Social media profile URLs of the company",
"items": {
"type": "string"
},
"type": "array"
},
"ticker": {
"description": "Stock ticker symbol of the company",
"type": "string"
},
"website": {
"description": "Website of the company",
"type": "string"
}
},
"type": "object"
},
"name": "enrich_company"
},
{
"description": "Search for companies matching specific criteria",
"inputSchema": {
"properties": {
"query": {
"description": "SQL-like query to search for companies",
"type": "string"
},
"size": {
"description": "Number of results to return (max 100)",
"maximum": 100,
"minimum": 1,
"type": "number"
}
},
"required": [
"query"
],
"type": "object"
},
"name": "search_companies"
},
{
"description": "Search for schools matching specific criteria",
"inputSchema": {
"properties": {
"query": {
"description": "SQL-like query to search for schools",
"type": "string"
},
"size": {
"description": "Number of results to return (max 100)",
"maximum": 100,
"minimum": 1,
"type": "number"
}
},
"required": [
"query"
],
"type": "object"
},
"name": "search_schools"
},
{
"description": "Search for locations matching specific criteria",
"inputSchema": {
"properties": {
"query": {
"description": "SQL-like query to search for locations",
"type": "string"
},
"size": {
"description": "Number of results to return (max 100)",
"maximum": 100,
"minimum": 1,
"type": "number"
}
},
"required": [
"query"
],
"type": "object"
},
"name": "search_locations"
},
{
"description": "Search for job titles matching specific criteria",
"inputSchema": {
"properties": {
"query": {
"description": "SQL-like query to search for job titles",
"type": "string"
},
"size": {
"description": "Number of results to return (max 100)",
"maximum": 100,
"minimum": 1,
"type": "number"
}
},
"required": [
"query"
],
"type": "object"
},
"name": "search_job_titles"
},
{
"description": "Search for skills matching specific criteria",
"inputSchema": {
"properties": {
"query": {
"description": "SQL-like query to search for skills",
"type": "string"
},
"size": {
"description": "Number of results to return (max 100)",
"maximum": 100,
"minimum": 1,
"type": "number"
}
},
"required": [
"query"
],
"type": "object"
},
"name": "search_skills"
},
{
"description": "Get autocomplete suggestions for a partial query",
"inputSchema": {
"properties": {
"field": {
"description": "Field to autocomplete (company, school, title, skill, location)",
"enum": [
"company",
"school",
"title",
"skill",
"location"
],
"type": "string"
},
"size": {
"description": "Number of results to return (max 100)",
"maximum": 100,
"minimum": 1,
"type": "number"
},
"text": {
"description": "Partial text to autocomplete",
"type": "string"
}
},
"required": [
"field",
"text"
],
"type": "object"
},
"name": "autocomplete"
}
]