Pearch.ai

The most accurate people search API/MCP. Natural language in, high-quality candidates out. Built for ATSs and AI Agents.

python

6

GitHub Stars

python

Language

4 months ago

First Indexed

3 weeks ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "pearch-ai-mcp_pearch": {
      "command": "fastmcp",
      "args": [
        "install",
        "pearch_mcp.py",
        "--name",
        "Pearch.ai",
        "--env-var",
        "PARCH_API_KEY=pearch_mcp_key"
      ],
      "env": {
        "PEARCH_API_KEY": "your-api-key-here"
      }
    }
  }
}

You can run and integrate the Pearch.ai MCP to power precise people-search capabilities from your own applications. This MCP is designed to work with your preferred MCP client, letting you start and develop locally with an API key to access the Pearch.ai service.

How to use

You run the MCP as a local stdio server using your MCP client. Start the server in development mode so you can test and iterate quickly. Before you start, ensure your API key is available as an environment variable. Then start the MCP with the runtime command and script provided for development.

How to install

Prerequisites you need before installing and running the MCP:

Python 3.7 or newer
Pearch.ai API key
FastMCP package

Set up your API key for use by the MCP client.

export PEARCH_API_KEY='your-api-key-here'

Option 1 macOS[uv]

Install the required tools and set up a Python virtual environment. Then install FastMCP to run and develop your MCP.

# Install Python and uv
brew install python
brew install uv

# Create and activate virtual environment
uv venv
source .venv/bin/activate

# Install FastMCP
uv pip install fastmcp

Option 2 Linux[pip]

On Linux, prepare a Python virtual environment and install FastMCP to run the MCP locally.

# Install system dependencies
sudo apt update
sudo apt install python3 python3-venv python3-pip

# Create and activate virtual environment
python3 -m venv .venv
source .venv/bin/activate

# Install FastMCP
pip install fastmcp

Usage in standard installation and development mode

After you have the prerequisites, you can install and run the MCP server. The standard installation uses the FastMCP runner to register and start your MCP script. In development mode, you can start the MCP server directly for testing.

fastmcp install pearch_mcp.py --name "Pearch.ai" --env-var PEARCH_API_KEY=pearch_mcp_key

Development mode

For local development and testing, ensure your API key is set and start the development server. This helps you verify behavior while building features for production.

# Set your API key
export PEARCH_API_KEY='your-api-key-here'

# Start development server
fastmcp dev pearch_mcp.py