Skip to main content
Glama
yumaheymans

PeopleSearch.im MCP Server

by yumaheymans

PeopleSearch.im MCP server

Give your AI agent PeopleSearch.im: search a global professional database in plain English, reveal full profiles, and fetch verified professional (work) emails, plus email verification, reverse email lookup, LinkedIn lookups, and company lookups. Searching is free; most lookups cost 1 credit and are refunded automatically when nothing is found.

Listed in the Official MCP Registry as im.peoplesearch/email-finder.

No install. The server runs at:

https://peoplesearch.im/api/mcp

The first time your assistant uses a PeopleSearch.im tool, it asks you to sign in and approve the connection (OAuth). No API key to copy.

Claude and ChatGPT: add the URL above as a custom connector (in ChatGPT, choose OAuth).

Claude Code:

claude mcp add --transport http peoplesearch https://peoplesearch.im/api/mcp

Cursor (~/.cursor/mcp.json):

{
  "mcpServers": {
    "peoplesearch": {
      "url": "https://peoplesearch.im/api/mcp"
    }
  }
}

VS Code (.vscode/mcp.json):

{
  "servers": {
    "peoplesearch": {
      "type": "http",
      "url": "https://peoplesearch.im/api/mcp"
    }
  }
}

Prefer an API key? (Windsurf, scripts, clients without OAuth)

Create a key (sk_sift_...) on the developer page and send it as a Bearer header:

claude mcp add --transport http peoplesearch https://peoplesearch.im/api/mcp \
  --header "Authorization: Bearer sk_sift_..."
{
  "mcpServers": {
    "peoplesearch": {
      "serverUrl": "https://peoplesearch.im/api/mcp",
      "headers": { "Authorization": "Bearer sk_sift_..." }
    }
  }
}

Related MCP server: LeadSpark MCP

Connect (local stdio bridge)

For clients that only speak stdio, this repository is a zero-dependency bridge (index.mjs, Node 18+). It speaks MCP over stdio and forwards each tool call to the PeopleSearch.im REST API with your API key:

{
  "mcpServers": {
    "peoplesearch": {
      "command": "npx",
      "args": ["-y", "github:yumaheymans/peoplesearch-mcp"],
      "env": { "PEOPLESEARCH_API_KEY": "sk_sift_..." }
    }
  }
}

Or clone the repository and run node index.mjs with PEOPLESEARCH_API_KEY set. PEOPLESEARCH_BASE_URL optionally overrides the API base (default https://peoplesearch.im).

Tools

Tool

What it does

Cost

people_search

Search people in plain English (masked previews and the true total)

free

company_search

Search companies in plain English

free

check_credits

Your credit balance

free

reveal_profile

Unlock one person from a search result

1 credit (+1 for the email)

find_people

Search and unlock a batch of people in one charge

1 credit per person unlocked

fetch_email

Verified work email for an unlocked person

1 credit (refunded if none)

verify_email

Check whether an address exists and is safe to send to

1 credit (refunded if no verdict)

find_company_emails

Role-based addresses for a company domain

2 credits (refunded if none)

find_linkedin_profile

A person's LinkedIn URL from their name

2 credits (refunded if no match)

lookup_linkedin_profile

Structured data from a LinkedIn profile URL

2 credits (refunded if none)

lookup_company

Firmographics from a LinkedIn company URL

1 credit (refunded if none)

reverse_email_lookup

The person behind a professional email

13 credits (refunded if no match)

Data comes from Icypeas, a B2B people-data provider. Emails are professional (work) addresses looked up live, not personal ones. A lookup can come back empty, and then the credit is refunded.

License

MIT

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    F
    maintenance
    Enables AI tools to search and enrich B2B leads, including finding professional emails, company profiles, and filtering people and companies by various criteria.
    5
    697 npm
    MIT
  • F
    license
    A
    quality
    D
    maintenance
    Enables AI agents to research companies and find contacts with structured data from multiple free sources, including company info, tech stack, and email addresses.
    3
    -
  • A
    license
    Not graded
    quality
    A
    maintenance
    Find and enrich the right people from 750M professional profiles. Search by role, seniority, skills, industry, and location in plain English. Pull profiles with work history, education, and seniority, then see who's likely to change jobs next with Next Move Signal. Built for AI products and agents: sourcing candidates, building lead lists, and mapping markets and accounts.
    206 npm
    MIT
  • A
    license
    Not graded
    quality
    B
    maintenance
    Enables AI assistants to look up verified work emails and generate personalized cold outreach drafts, with free email guessing and strong coverage for finance contacts.
    MIT