Supports deployment on Linux systems, enabling Linux users to integrate Pearch.ai's people search capabilities into their applications.
Provides installation support for macOS environments, allowing macOS users to deploy the people search functionality on Apple's operating system.
Enables integration with Python applications, allowing developers to embed Pearch.ai's powerful people search capabilities within Python-based software.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Pearch find senior Python developers with AWS experience in San Francisco"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP server for Pearch.AI: natural-language search over people and companies/leads (B2B). Use it from Claude, Cursor, VS Code, or any MCP-compatible client.
Evaluating AI Recruitment Sourcing Tools by Human Preference
Tool | Description |
search_people | Natural-language people search (e.g. "software engineers in California with 5+ years Python"). Supports fast/pro/superfast search types, contact reveal & contact filters, real-time profile refresh, insights, and thread-based pagination/follow-ups. |
search_company_leads | Find companies and leads/contacts within them (B2B). Example: company "AI startups in SF, 50–200 employees" + leads "CTOs and engineering managers", with optional personalized outreach messages. |
get_profile | Look up and enrich a single person by LinkedIn slug or email (contact reveal, real-time refresh, GitHub enrichment). |
get_user_info | Authenticated user info: email, remaining credits, pricing plan. Free. |
Custom structured filters (custom_filters / search_requirements) are intentionally not exposed — describe everything in the natural-language query.
Related MCP server: Potarix enricher
The hosted server lives at https://mcp.pearch.ai/mcp and supports two auth schemes at once:
Add the server without any headers — OAuth-capable clients (Claude, Cursor, VS Code) discover the flow automatically and open a Google sign-in. Sign in with the Google account whose email matches your Pearch account:
claude mcp add --transport http pearch https://mcp.pearch.ai/mcpYour searches bill credits against your own Pearch account. If your Pearch account has no API key yet, create one first in the Pearch.ai Dashboard.
Pass the same Pearch API key as api.pearch.ai:
{
"mcpServers": {
"Pearch.ai": {
"url": "https://mcp.pearch.ai/mcp",
"headers": {
"Authorization": "Bearer ${env:PEARCH_API_KEY}"
}
}
}
}Use test_mcp_key for masked (sample) results — no sign-up required.
Requires Python 3.10+ and pip install -r requirements.txt (or pip install fastmcp).
fastmcp install claude-desktop pearch_mcp.py --env PEARCH_API_KEY=test_mcp_keyOr manually under mcpServers:
"Pearch.ai": {
"command": "python",
"args": ["/path/to/mcp_pearch/pearch_mcp.py"],
"env": { "PEARCH_API_KEY": "test_mcp_key" }
}fastmcp install cursor pearch_mcp.py --env PEARCH_API_KEY=test_mcp_keyReplace test_mcp_key with your dashboard key for full results.
uvicorn pearch_mcp:app --host 0.0.0.0 --port 8000Health: GET /health or /healthcheck (reports the auth mode).
Variable | Default | Purpose |
|
|
|
|
| Public URL of this server. OAuth metadata, token audience, and the |
| — | Google OAuth 2.0 Web application client (register |
| — | Shared secret for the Pearch API's internal email→API-key mapping endpoint. Required in |
|
|
|
| —, | Redis connection for the OAuth store. |
| built-in list | Comma-separated fnmatch patterns for MCP client redirect URIs ( |
|
| Verified-identity cache TTL; also the revocation lag. |
|
| Pearch API base (per-call |
|
| Fallback key for stdio/local use. |
| — |
|
In oauth mode the ingress/reverse proxy must route the whole host to the server, not just /mcp: the flow adds /.well-known/oauth-*, /authorize, /token, /register, /revoke, /consent, and /auth/callback.
export PEARCH_API_KEY='test_mcp_key' # or your key for full results
fastmcp dev inspector pearch_mcp.pyPearch.AI's privacy policy: https://pearch.ai/privacy-policy — covers data collection, usage, storage, third-party sharing, retention, and contact information. Data deletion / opt-out: https://pearch.ai/opt-out. Terms of service: https://pearch.ai/tos.
MIT — see LICENSE.
This server cannot be deployed
Plain-English people search with verified work emails, email verification and LinkedIn lookup.
Query professional profiles, search candidates, and get AI-powered summaries and job fit analysis.
Search and enrich B2B people & companies — 70+ filters (funding, linkedin, industry, country, ...).
Real-time B2B data for agents: search and enrich 1B+ people and 200M+ company profiles.
