Can I use the server without signing up?

Yes, using the test_mcp_key provides masked sample results without requiring sign-up.

Which clients support this MCP server?

It works with Cursor, Claude Desktop, VS Code, and any MCP-compatible client.

What programming language and dependencies are required?

Python 3.10+ is required, along with FastMCP and optionally uv for running the server.

How do I run the server remotely?

Run with Uvicorn exposing /mcp endpoint and provide your API key in the Authorization header.

MCP Pearch

searchpeopleb2brecruitmentleads

MCP server for natural-language search of people and B2B company leads with profile insights and scoring.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Not yet automatically verified

We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "pearch-ai-mcp-pearch": {
      "command": "uvx",
      "args": [
        "fastmcp"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Overview

This MCP server enables natural-language queries to find people and company leads, useful for talent discovery and B2B lead generation. It supports searching for candidates by skills, location, and experience, as well as finding companies and relevant contacts within them. The server works with MCP-compatible clients like Cursor, Claude Desktop, and VS Code. It offers a test API key for sample results and supports full results via a user-provided API key.

Use cases

Search for software engineers or other professionals by skills and location

Find companies matching criteria such as industry and size

Discover leads and contacts within target companies

Integrate people and company search into AI agent workflows

Evaluate candidate profiles with scoring and insights

Key features

Natural-language search for people with optional profile scoring

Search for companies and B2B leads/contacts

Supports masked sample results with test API key

Full results via user API key from Pearch.ai dashboard

Compatible with multiple MCP clients

Can run locally or as a remote HTTP server

Capabilities & Tool Schemas (4)Self-reported

Inspect callable tools, capabilities, and parameters exposed to AI agents by MCP Pearch.

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.

Documentation Overview

Pearch.ai MCP

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

Tools

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.

Remote server (recommended)

The hosted server lives at https://mcp.pearch.ai/mcp and supports two auth schemes at once:

OAuth (no key handling)

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:

Terminal

claude mcp add --transport http pearch https://mcp.pearch.ai/mcp

Your 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.

API key

Pass the same Pearch API key as api.pearch.ai:

config.json

{
  "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.

Local (stdio) installation

Requires Python 3.10+ and pip install -r requirements.txt (or pip install fastmcp).

Claude Desktop / Claude Code

bash

fastmcp install claude-desktop pearch_mcp.py --env PEARCH_API_KEY=test_mcp_key

Or manually under mcpServers:

json

"Pearch.ai": {
  "command": "python",
  "args": ["/path/to/mcp_pearch/pearch_mcp.py"],
  "env": { "PEARCH_API_KEY": "test_mcp_key" }
}

Cursor

bash

fastmcp install cursor pearch_mcp.py --env PEARCH_API_KEY=test_mcp_key

Replace test_mcp_key with your dashboard key for full results.

Running your own HTTP server

bash

uvicorn pearch_mcp:app --host 0.0.0.0 --port 8000

Health: GET /health or /healthcheck (reports the auth mode).

Environment variables

Variable	Default	Purpose
`PEARCH_MCP_AUTH`	`api_key`	`oauth` \| `api_key` \| `none`. In `oauth` mode raw API-key bearers are still accepted (dual auth).
`PEARCH_MCP_BASE_URL`	`http://localhost:8000`	Public URL of this server. OAuth metadata, token audience, and the `/auth/callback` redirect URI all derive from it.
`PEARCH_MCP_GOOGLE_CLIENT_ID` / `PEARCH_MCP_GOOGLE_CLIENT_SECRET`	—	Google OAuth 2.0 Web application client (register `<base_url>/auth/callback` as a redirect URI). Required in `oauth` mode.
`PEARCH_MCP_INTERNAL_TOKEN`	—	Shared secret for the Pearch API's internal email→API-key mapping endpoint. Required in `oauth` mode.
`PEARCH_MCP_OAUTH_STORE`	`disk`	`redis` keeps OAuth state (client registrations, tokens — encrypted) in Redis so it survives restarts and allows >1 replica.
`PEARCH_MCP_OAUTH_REDIS_HOST` / `REDIS_ENDPOINT`, `REDIS_PORT`, `PEARCH_MCP_OAUTH_REDIS_DB`, `REDIS_PASSWORD`	—, `6379`, `4`, —	Redis connection for the OAuth store.
`PEARCH_MCP_ALLOWED_CLIENT_REDIRECT_URIS`	built-in list	Comma-separated fnmatch patterns for MCP client redirect URIs (`*` = any).
`PEARCH_MCP_TOKEN_CACHE_TTL_S`	`300`	Verified-identity cache TTL; also the revocation lag.
`PEARCH_API_URL`	`https://api.pearch.ai`	Pearch API base (per-call `base_url` overrides).
`PEARCH_API_KEY`	`test_mcp_key`	Fallback key for stdio/local use.
`MCP_DISABLE_AUTH`	—	`1` is equivalent to `PEARCH_MCP_AUTH=none` (local dev only).

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.

Development

server.ts

export PEARCH_API_KEY='test_mcp_key'   # or your key for full results
fastmcp dev inspector pearch_mcp.py

Privacy Policy

Pearch.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.

Support

License

MIT — see LICENSE.

Read the full README →View source on GitHub →

Related MCP Servers

View all in Search & Data Extraction View all alternatives

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars

Stargazers on the source repository.

npm downloads

2.1M

Package downloads in the last 30 days.

Last commit

16d ago

Most recent push to the default branch.

Tools exposed

Callable tools this server registers over MCP.

Directory activity

2 views

Config copies, upvotes, and views on AllMCPs.

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about MCP Pearch

Obtain an API key from the Pearch.ai Dashboard and set it as PEARCH_API_KEY in your MCP configuration.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/pearch-ai-mcp-pearch?style=directory)](https://allmcps.com/mcp/pearch-ai-mcp-pearch)

HTML Embed

<a href="https://allmcps.com/mcp/pearch-ai-mcp-pearch"><img src="https://allmcps.com/api/badge/pearch-ai-mcp-pearch?style=directory" alt="MCP Pearch on AllMCPs" /></a>

Technical Specs & Signals

CategorySearch & Data Extraction

PricingFreemium

10/11 checks healthy over the last 33d

51Quality signal: Good · 51/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership4/20

Documentation & tools25/30

Adoption & activity9/15

Community engagement0/10

A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

Supply-chain signal

5 high-severity advisories on record for this package. Most advisories affect transitive dependencies and may not be exploitable in this server's actual usage — this is a directional signal, not a security audit.

Critical 1High 4Medium 3Low 6

Scanned 23d ago via OSV.dev · fastmcp (PyPI)

★ Spotlight Slot

Feature Your MCP Server

Get maximum visibility for your server across our directory, search results, and detail pages.

Spotlight Your Server

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge — proof is checked automatically, then reviewed by our team.

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 🔎 Search & Data Extraction →Best MCP servers for Web Search & Scraping →Alternatives to MCP Pearch →Install in Claude Desktop Install in Cursor Install in VS Code

MCP Pearch

searchpeopleb2brecruitmentleads

MCP server for natural-language search of people and B2B company leads with profile insights and scoring.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Not yet automatically verified

We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "pearch-ai-mcp-pearch": {
      "command": "uvx",
      "args": [
        "fastmcp"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Overview

Use cases

Search for software engineers or other professionals by skills and location

Find companies matching criteria such as industry and size

Discover leads and contacts within target companies

Integrate people and company search into AI agent workflows

Evaluate candidate profiles with scoring and insights

Key features

Natural-language search for people with optional profile scoring

Search for companies and B2B leads/contacts

Supports masked sample results with test API key

Full results via user API key from Pearch.ai dashboard

Compatible with multiple MCP clients

Can run locally or as a remote HTTP server

Capabilities & Tool Schemas (4)Self-reported

Inspect callable tools, capabilities, and parameters exposed to AI agents by MCP Pearch.

search_people

search_company_leads

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.

Documentation Overview

Pearch.ai MCP

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

Tools

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.

Remote server (recommended)

The hosted server lives at https://mcp.pearch.ai/mcp and supports two auth schemes at once:

OAuth (no key handling)

Terminal

claude mcp add --transport http pearch https://mcp.pearch.ai/mcp

Your 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.

API key

Pass the same Pearch API key as api.pearch.ai:

config.json

{
  "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.

Local (stdio) installation

Requires Python 3.10+ and pip install -r requirements.txt (or pip install fastmcp).

Claude Desktop / Claude Code

bash

fastmcp install claude-desktop pearch_mcp.py --env PEARCH_API_KEY=test_mcp_key

Or manually under mcpServers:

json

"Pearch.ai": {
  "command": "python",
  "args": ["/path/to/mcp_pearch/pearch_mcp.py"],
  "env": { "PEARCH_API_KEY": "test_mcp_key" }
}

Cursor

bash

fastmcp install cursor pearch_mcp.py --env PEARCH_API_KEY=test_mcp_key

Replace test_mcp_key with your dashboard key for full results.

Running your own HTTP server

bash

uvicorn pearch_mcp:app --host 0.0.0.0 --port 8000

Health: GET /health or /healthcheck (reports the auth mode).

Environment variables

Variable	Default	Purpose
`PEARCH_MCP_AUTH`	`api_key`	`oauth` \| `api_key` \| `none`. In `oauth` mode raw API-key bearers are still accepted (dual auth).
`PEARCH_MCP_BASE_URL`	`http://localhost:8000`	Public URL of this server. OAuth metadata, token audience, and the `/auth/callback` redirect URI all derive from it.
`PEARCH_MCP_GOOGLE_CLIENT_ID` / `PEARCH_MCP_GOOGLE_CLIENT_SECRET`	—	Google OAuth 2.0 Web application client (register `<base_url>/auth/callback` as a redirect URI). Required in `oauth` mode.
`PEARCH_MCP_INTERNAL_TOKEN`	—	Shared secret for the Pearch API's internal email→API-key mapping endpoint. Required in `oauth` mode.
`PEARCH_MCP_OAUTH_STORE`	`disk`	`redis` keeps OAuth state (client registrations, tokens — encrypted) in Redis so it survives restarts and allows >1 replica.
`PEARCH_MCP_OAUTH_REDIS_HOST` / `REDIS_ENDPOINT`, `REDIS_PORT`, `PEARCH_MCP_OAUTH_REDIS_DB`, `REDIS_PASSWORD`	—, `6379`, `4`, —	Redis connection for the OAuth store.
`PEARCH_MCP_ALLOWED_CLIENT_REDIRECT_URIS`	built-in list	Comma-separated fnmatch patterns for MCP client redirect URIs (`*` = any).
`PEARCH_MCP_TOKEN_CACHE_TTL_S`	`300`	Verified-identity cache TTL; also the revocation lag.
`PEARCH_API_URL`	`https://api.pearch.ai`	Pearch API base (per-call `base_url` overrides).
`PEARCH_API_KEY`	`test_mcp_key`	Fallback key for stdio/local use.
`MCP_DISABLE_AUTH`	—	`1` is equivalent to `PEARCH_MCP_AUTH=none` (local dev only).

Development

server.ts

export PEARCH_API_KEY='test_mcp_key'   # or your key for full results
fastmcp dev inspector pearch_mcp.py

Privacy Policy

Support

License

MIT — see LICENSE.

Read the full README →View source on GitHub →

Related MCP Servers

View all in Search & Data Extraction View all alternatives

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars

Stargazers on the source repository.

npm downloads

2.1M

Package downloads in the last 30 days.

Last commit

16d ago

Most recent push to the default branch.

Tools exposed

Callable tools this server registers over MCP.

Directory activity

2 views

Config copies, upvotes, and views on AllMCPs.

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about MCP Pearch

Obtain an API key from the Pearch.ai Dashboard and set it as PEARCH_API_KEY in your MCP configuration.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/pearch-ai-mcp-pearch?style=directory)](https://allmcps.com/mcp/pearch-ai-mcp-pearch)

HTML Embed

<a href="https://allmcps.com/mcp/pearch-ai-mcp-pearch"><img src="https://allmcps.com/api/badge/pearch-ai-mcp-pearch?style=directory" alt="MCP Pearch on AllMCPs" /></a>

Technical Specs & Signals

CategorySearch & Data Extraction

PricingFreemium

10/11 checks healthy over the last 33d

51Quality signal: Good · 51/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership4/20

Documentation & tools25/30

Adoption & activity9/15

Community engagement0/10

Supply-chain signal

Critical 1High 4Medium 3Low 6

Scanned 23d ago via OSV.dev · fastmcp (PyPI)

★ Spotlight Slot

Feature Your MCP Server

Get maximum visibility for your server across our directory, search results, and detail pages.

Spotlight Your Server

Own this project?

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 🔎 Search & Data Extraction →Best MCP servers for Web Search & Scraping →Alternatives to MCP Pearch →Install in Claude Desktop Install in Cursor Install in VS Code