# PeopleDB MCP

> PeopleDB is a B2B intelligence server that lets your AI agent enrich and verify company and person profiles instantly. It taps into a database of over 3 billion records, allowing you to clean dirty CRM data, validate email deliverability on the fly, and find key contacts using SQL-like filters.

## Overview
- **Category:** sales-automation
- **Price:** Free
- **Tags:** data-enrichment, b2b-intelligence, email-verification, contact-data, data-cleaning, lead-generation

## Description

PeopleDB is your B2B intelligence server. It lets your agent instantly enrich and verify company and person profiles using a massive database of over 3 billion records. You use this when you need to clean dirty CRM data, validate email deliverability on the fly, or find key contacts with precise filters.

**Data Standardization: Making Messy Inputs Clean**
You've got raw text in your fields—a company name might be misspelled, or an address could be incomplete. Don't worry about it; PeopleDB fixes that before you even try to use the data. The `clean_company` tool standardizes and cleans up messy input strings for company names. For location details, `clean_location` corrects and standardizes everything—city, state, country—from raw text inputs. If a person's name is inconsistent or misspelled, the `clean_name` tool fixes those spelling errors and formats names correctly for your database entry. When you're doing data entry into a form, use `autocomplete`; it suggests valid field values as you type them in.

**Profiling and Enrichment: Adding Depth to Records**
Once the data is clean, you deepen the records. If you have an existing company profile, run `enrich_company` to add deep details and expand its entire set of profile data points. For people, use `enrich_person` to expand a professional's background by adding job roles or organizational context. You don't need perfect identifying information; `identify_person` figures out who someone is using only partial identifiers. When you run into dirty lead records, the system handles it all: `bulk_enrich_people` processes details for multiple people profiles at once, so you avoid calling the tool manually for every contact.

**Searching and Verification: Finding Leads That Work**
Need leads? You find them first by running `search_companies`, which lists corporate entities based on criteria like industry, size, or location. Alternatively, use `search_people` to retrieve a list of people matching specific professional titles or company affiliations. Before any outreach campaign, you absolutely must confirm the email deliverability using `verify_email`; it confirms if an address is active and highly deliverable, preventing costly bounce rates. For tracking usage, remember that `get_balance` checks your remaining credit balance for every data enrichment query you run.

**Bulk Processing Power**
When dealing with massive lists of contacts, the system handles everything. You can use `bulk_enrich_people` to process entire lists efficiently, ensuring every person gets their professional details updated at once.

## Tools

### autocomplete
Suggests valid field values as you type them into a data entry form.

### bulk_enrich_people
Enriches details for multiple people profiles at once, processing large lists efficiently.

### clean_company
Standardizes and cleans up messy input strings used for company names.

### clean_location
Corrects and standardizes location data (city, state, country) from raw text inputs.

### clean_name
Fixes spelling inconsistencies and formats names correctly for database entry.

### enrich_company
Adds deep details to an existing company record, expanding its profile data points.

### enrich_person
Expands a person's professional profile by adding job roles and organizational context.

### get_balance
Checks the remaining credit balance for running data enrichment queries.

### identify_person
Determines who a person is using partial identifying information.

### search_companies
Finds and lists companies based on criteria like industry, size, or location.

### search_people
Retrieves a list of people matching specific professional titles or company affiliations.

### verify_email
Confirms if an email address is active and deliverable to prevent bounce rates.

## Prompt Examples

**Prompt:** 
```
Enrich the person with email john@company.com on PeopleDB
```

**Response:** 
```
I've enriched the profile for john@company.com. His name is John Doe, and he currently works as a Senior Software Engineer at TechCorp. Would you like to see his LinkedIn profile and full skill set?
```

**Prompt:** 
```
Is the email contact@example.com valid and deliverable?
```

**Response:** 
```
Yes, the email contact@example.com is valid and highly deliverable. It is tied to an active MX record and does not appear to be a catch-all.
```

**Prompt:** 
```
Find all CTOs in SaaS companies based in San Francisco
```

**Response:** 
```
I found 2,150 CTOs in SaaS companies based in San Francisco. Do you want me to filter them further by company size or specific skills like 'Machine Learning'?
```

## Capabilities

### Verify Email Deliverability
Checks if an email address is valid, active, and highly deliverable by cross-referencing it with MX records.

### Enrich People Profiles
Adds missing professional details—like job titles or company history—to a person's profile using limited identifying data.

### Find and Search Companies
Searches for corporate entities by name, industry, or location to retrieve structured business records.

### Clean Data Fields
Takes messy raw text (like a company name or address) and standardizes it into clean, consistent formats ready for a database.

### Bulk Process Contacts
Runs enrichment and cleaning processes across entire lists of contacts, avoiding manual single-entry calls.

## Use Cases

### Cleaning a Cold Lead List
A BDR gets a spreadsheet of 500 leads with names and emails, but the data is inconsistent. The agent runs `clean_name` on the names, then uses `verify_email` on every address, followed by `bulk_enrich_people`. It returns a clean list ready for immediate use.

### Finding Key Stakeholders
A Marketing Manager needs to target all VP-level contacts at SaaS companies in Texas. The agent uses `search_people` with the title and location filters, then calls `enrich_company` on the resulting company names to ensure they are legitimate businesses.

### Validating a Website's Directory
A developer is building an internal directory. They feed raw contacts into the system, running `clean_company` and `identify_person`. The tool resolves ambiguities, ensuring that 'Acme Corp.' is standardized to its official legal name.

### Building a Target Account List
A sales team needs to find all companies in the healthcare sector with over 500 employees. They use `search_companies` to pull the list, and then use `enrich_company` on those results to grab executive contacts for follow-up.

## Benefits

- Stop wasting time on bad contacts. `verify_email` checks deliverability, stopping your outreach efforts from bouncing off unverified addresses.
- Process lists at scale. Use `bulk_enrich_people` to run enrichment across hundreds of leads in a single call, skipping manual lookups entirely.
- Clean up CRM sludge before reporting. Tools like `clean_company` and `clean_location` standardize messy data inputs so your reports are accurate every time.
- Find the right person fast. You can use `search_people` to filter by job title (e.g., 'CTO') and company, dramatically narrowing down your target list.
- Expand profiles with precision. Instead of guessing, call `enrich_person` to add verifiable details like current roles or industry affiliations.

## How It Works

The bottom line is: you feed raw contact data into an AI prompt, and PeopleDB gives back clean, verified, and expanded records in one step.

1. Start by subscribing to PeopleDB via Vinkius and generating your API key in the dashboard.
2. Instruct your AI client (e.g., Claude or Cursor) to call a specific tool, like `enrich_person`, providing the initial data inputs.
3. The server queries the database, processes the enrichment/verification, and returns structured, cleaned JSON output directly to your agent.

## Frequently Asked Questions

**How does PeopleDB MCP Server verify emails?**
It checks deliverability by verifying active MX records associated with the address. This means it confirms the email is set up to receive mail, not just that it has a valid format.

**Can I use PeopleDB MCP Server for bulk data enrichment?**
Yes. The `bulk_enrich_people` tool lets you process large lists of contacts at once, which is much faster than running individual single-record calls.

**What if my company name is misspelled? Which tool should I use?**
Use the `clean_company` tool. It specifically takes messy or misspelled corporate names and standardizes them to their official, verifiable format.

**How do I find a specific job title in San Francisco using PeopleDB MCP Server?**
You start with `search_people`. Provide the location (San Francisco) and the desired role/title (e.g., 'VP of Sales') to get a filtered list.

**How do I check my PeopleDB account usage and credit limits using the `get_balance` tool?**
You run `get_balance`. This tells your AI client exactly how many credits you have left for enrichment tasks. It's a quick way to prevent job failures due to hitting usage overages.

**If I only have partial data, like an old email or name, how reliable is the `identify_person` tool?**
It compares your input against its 3 billion record database. The agent searches for matching records and returns a confidence score alongside the profile, showing you exactly how reliable the match is.

**Is it faster to process many contacts using `bulk_enrich_people` than running `enrich_person` individually?**
Yes. The bulk tool optimizes API calls by submitting multiple people's data in a single batch request. This significantly reduces overall processing time and system overhead compared to sequential individual calls.

**What specific parameters should I provide when using the `search_companies` tool?**
You can filter by industry, location, or employee count. Providing these specific fields immediately narrows the search results, letting you find targeted company profiles much faster than a general query.

**How does person enrichment work?**
Provide an email, LinkedIn URL, name+company, or phone number and receive full professional profile including title, company, skills, education, and social links.

**Can I clean messy data?**
Yes, use cleaner tools to standardize names into first/middle/last, locations into city/region/country, and company names into canonical forms.

**Is email verification supported?**
Yes, you can directly verify if an email address is valid, deliverable, and safe to use in your outbound campaigns.