# People Data Labs — how to use (mcp.ai)

Connect your People Data Labs account and use 24 tools for analytics straight from your AI agent. Connect with your own API key. PeopleDataLabs provides B2B data enrichment and identity resolution, empowering organizations to build enriched user profiles and validate customer information.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_peopledatalabs?ms=1787293500000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `peopledatalabs_clean_company_data`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/peopledatalabs`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/peopledatalabs/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/peopledatalabs/clean/company/data` — Cleans and standardizes company information based on a name, website, or profile URL; providing at least one of these inputs is highly recommended for meaningful results.
  - body: { name?: string, pretty?: boolean, profile?: string, website?: string }
- `POST https://api.mcp.ai/api/peopledatalabs/clean/company/post` — Tool to clean and standardize company data using POST method. Use when you need to standardize company information by providing company name, website, or social profile. Returns standardized company i
  - body: { name?: string, pretty?: boolean, profile?: string, website?: string }
- `POST https://api.mcp.ai/api/peopledatalabs/clean/location/data` — Cleans and standardizes a raw, unformatted location string into a structured representation, provided the input is a recognizable geographical place.
  - body: { location: string }
- `POST https://api.mcp.ai/api/peopledatalabs/clean/location/post` — Tool to clean and standardize location data using POST method. Use when you need to normalize raw location strings into structured location information including city, region, and country.
  - body: { pretty?: boolean, location: string }
- `POST https://api.mcp.ai/api/peopledatalabs/clean/school/data` — Cleans and standardizes school information; provide at least one of the school's name, website, or profile for optimal results.
  - body: { name?: string, pretty?: boolean, profile?: string, website?: string }
- `POST https://api.mcp.ai/api/peopledatalabs/clean/school/data/post` — Tool to clean and standardize school data using POST method. Use when you need to clean school information by providing name, website, or profile.
  - body: { name?: string, pretty?: boolean, profile?: string, website?: string }
- `POST https://api.mcp.ai/api/peopledatalabs/enrich/bulk/company/data` — Tool to enrich up to 100 companies in a single request using the Bulk Company Enrichment API. Use when you need to enrich multiple company profiles efficiently. Each request must include at least one 
  - body: { requests: object[] }
- `POST https://api.mcp.ai/api/peopledatalabs/enrich/bulk/person/data` — Tool to enrich up to 100 person profiles in a single API request using the Bulk Person Enrichment API. Use when you need to enrich multiple people efficiently, as this effectively increases the rate l
  - body: { requests: object[] }
- `POST https://api.mcp.ai/api/peopledatalabs/enrich/company/data` — Enriches company data from People Data Labs with details like firmographics and employee counts. CRITICAL: This action REQUIRES at least one company identifier. DO NOT send empty {} requests. You MUST
  - body: { name?: string, pdl_id?: string, pretty?: boolean, region?: string, ticker?: string, country?: string, profile?: string, website?: string, locality?: string, location?: string, titlecase?: boolean, postal_code?: string, street_address?: string }
- `POST https://api.mcp.ai/api/peopledatalabs/enrich/ip/data` — Enriches an IP address with company, location, metadata, and person data from People Data Labs.
  - body: { ip: string, pretty?: boolean, titlecase?: boolean, return_person?: boolean, min_confidence?: string, return_ip_location?: boolean, return_ip_metadata?: boolean, return_if_unmatched?: boolean, updated_title_roles?: boolean }
- `POST https://api.mcp.ai/api/peopledatalabs/enrich/job/title/data` — Enhances a job title by providing additional contextual information and details.
  - body: { job_title: string }
- `POST https://api.mcp.ai/api/peopledatalabs/enrich/person/data` — Enriches person data using various identifiers; requires a primary ID (profile, email, phone, email_hash, lid, pdl_id) OR a name (full, or first and last) combined with another demographic detail (e.g
  - body: { lid?: string, name?: string, email?: string, phone?: string, pdl_id?: string, pretty?: boolean, region?: string, school?: string, company?: string, country?: string, profile?: string, locality?: string, location?: string, required?: string, last_name?: string, birth_date?: string, email_hash?: string, first_name?: string, postal_code?: string, data_include?: string, min_likelihood?: integer, street_address?: string, include_if_matched?: boolean }
- `POST https://api.mcp.ai/api/peopledatalabs/enrich/skill/data` — Retrieves detailed, standardized information for a given skill by querying the People Data Labs Skill Enrichment API; for best results, provide a recognized professional skill or area of expertise.
  - body: { skill: string }
- `POST https://api.mcp.ai/api/peopledatalabs/generate/search/query` — DEPRECATED: This action is deprecated and will be removed in a future release. Converts natural language queries into structured PDL Elasticsearch queries for people or company searches; generates opt
  - body: { query: string }
- `POST https://api.mcp.ai/api/peopledatalabs/get/autocomplete/suggestions` — Provides autocompletion suggestions for a specific field (e.g., company, skill, title) based on partial text input.
  - body: { size?: integer, text?: string, field: string, pretty?: boolean, titlecase?: boolean }
- `POST https://api.mcp.ai/api/peopledatalabs/get/autocomplete/suggestions/post` — Tool to get autocompletion suggestions using POST method for complex query parameters. Use when building type-ahead interfaces or needing to suggest values for Search API queries. Supports company, lo
  - body: { size?: integer, text?: string, field: string, pretty?: boolean, titlecase?: boolean }
- `POST https://api.mcp.ai/api/peopledatalabs/get/column/details` — Retrieves predefined enum values for a column name from `enum_mappings.json`; `is_enum` in the response will be false if the column is not found or is not an enum type.
  - body: { column: string }
- `POST https://api.mcp.ai/api/peopledatalabs/get/schema` — Retrieves the schema, including field names, descriptions, and data types, for 'person' or 'company' entity types.
  - body: { entity_type: string }
- `POST https://api.mcp.ai/api/peopledatalabs/get/subject/requests` — Tool to retrieve subject access requests for data privacy compliance. Use when you need to manage or review data subject requests related to person data in your PeopleDataLabs account.
- `POST https://api.mcp.ai/api/peopledatalabs/identify/person/data` — Retrieves detailed profile information for an individual from People Data Labs (PDL), requiring at least one identifier such as email, phone, or profile URL. If using name alone, it must be paired wit
  - body: { lid?: string, name?: string, email?: string, phone?: string, pretty?: boolean, region?: string, school?: string, company?: string, profile?: string, locality?: string, location?: string, last_name?: string, titlecase?: boolean, email_hash?: string, first_name?: string, postal_code?: string, street_address?: string, include_if_matched?: boolean }
- `POST https://api.mcp.ai/api/peopledatalabs/people/search/elastic` — Searches for person profiles in the People Data Labs (PDL) database using an Elasticsearch Domain Specific Language (DSL) query. This action allows for highly targeted searches based on criteria such 
  - body: { size?: integer, query: string, pretty?: boolean, dataset?: string, titlecase?: boolean, scroll_token?: string }
- `POST https://api.mcp.ai/api/peopledatalabs/query/person/changelog` — Tool to query the changelog of person records between two consecutive dataset versions. Returns information about updates, additions, deletions, merges, and opt-outs for individuals. Use when you need
  - body: { ids?: string[], type?: string, scroll_token?: string, fields_updated?: string[], origin_version: string, current_version: string }
- `POST https://api.mcp.ai/api/peopledatalabs/search/company/elastic` — Performs a search for company profiles within People Data Labs using a custom Elasticsearch Domain Specific Language (DSL) query. This action allows for detailed and complex filtering based on various
  - body: { size?: integer, query: string, pretty?: boolean, titlecase?: boolean, scroll_token?: string }
- `POST https://api.mcp.ai/api/peopledatalabs/search/company/post` — Tool to search and filter company records from the full Company Dataset using Elasticsearch or SQL queries via POST method. Use when you need to find multiple companies matching specific criteria with
  - body: { sql?: string, size?: integer, query?: string, pretty?: boolean, titlecase?: boolean, from_offset?: integer, scroll_token?: string }

## Example prompts
- "What can I do in People Data Labs?"
- "Show me a summary of my People Data Labs account"

## More
- Page: https://mcp.ai/peopledatalabs
- Agent spec (llms.txt): https://mcp.ai/peopledatalabs/llms.txt
- Postman collection: https://mcp.ai/peopledatalabs/postman.json