Pearch

Pearch.ai MCP

MCP-Server für Pearch.AI: natürlichsprachliche Suche nach Personen und Unternehmen/Leads (B2B). Nutzbar mit Claude, Cursor, VS Code oder jedem MCP-kompatiblen Client.

Evaluierung von KI-Recruiting-Sourcing-Tools durch menschliche Präferenz

Tools

Tool	Beschreibung
search_people	Natürlichsprachliche Personensuche (z. B. "Softwareentwickler in Kalifornien mit 5+ Jahren Python"). Unterstützt schnelle/pro/superschnelle Suchtypen, Kontaktfreigabe und Kontaktfilter, Echtzeit-Profilaktualisierung, Einblicke sowie thread-basierte Paginierung/Nachfragen.
search_company_leads	Unternehmen und Leads/Kontakte innerhalb dieser finden (B2B). Beispiel: Unternehmen "KI-Startups in SF, 50–200 Mitarbeiter" + Leads "CTOs und Engineering-Manager", mit optionalen personalisierten Outreach-Nachrichten.
get_profile	Einzelne Person per LinkedIn-Slug oder E-Mail nachschlagen und anreichern (Kontaktfreigabe, Echtzeit-Aktualisierung, GitHub-Anreicherung).
get_user_info	Informationen zum authentifizierten Benutzer: E-Mail, verbleibende Credits, Preisplan. Kostenlos.

Benutzerdefinierte strukturierte Filter (custom_filters / search_requirements) sind bewusst nicht verfügbar — beschreiben Sie alles in der natürlichsprachlichen Abfrage.

Remote-Server (empfohlen)

Der gehostete Server läuft unter https://mcp.pearch.ai/mcp und unterstützt gleichzeitig zwei Authentifizierungsschemata:

OAuth (keine Schlüsselverwaltung)

Fügen Sie den Server ohne Header hinzu — OAuth-fähige Clients (Claude, Cursor, VS Code) erkennen den Ablauf automatisch und öffnen eine Google-Anmeldung. Melden Sie sich mit dem Google-Konto an, dessen E-Mail mit Ihrem Pearch-Konto übereinstimmt:

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

Ihre Suchen belasten Credits auf Ihrem eigenen Pearch-Konto. Falls Ihr Pearch-Konto noch keinen API-Schlüssel hat, erstellen Sie zuerst einen im Pearch.ai-Dashboard.

API-Schlüssel

Übergeben Sie denselben Pearch-API-Schlüssel als api.pearch.ai:

{
  "mcpServers": {
    "Pearch.ai": {
      "url": "https://mcp.pearch.ai/mcp",
      "headers": {
        "Authorization": "Bearer ${env:PEARCH_API_KEY}"
      }
    }
  }
}

Verwenden Sie test_mcp_key für maskierte (Beispiel-)Ergebnisse — keine Registrierung erforderlich.

Lokale (stdio) Installation

Erfordert Python 3.10+ und pip install -r requirements.txt (oder pip install fastmcp).

Claude Desktop / Claude Code

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

Oder manuell unter mcpServers:

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

Cursor

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

Ersetzen Sie test_mcp_key durch Ihren Dashboard-Schlüssel für vollständige Ergebnisse.

Eigener HTTP-Server

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

Health: GET /health oder /healthcheck (meldet den Authentifizierungsmodus).

Umgebungsvariablen

Variable	Standard	Zweck
PEARCH_MCP_AUTH	api_key	oauth | api_key | none. Im oauth-Modus werden rohe API-Schlüssel-Träger weiterhin akzeptiert (duale Authentifizierung).
PEARCH_MCP_BASE_URL	http://localhost:8000	Öffentliche URL dieses Servers. OAuth-Metadaten, Token-Audience und die /auth/callback-Redirect-URI werden daraus abgeleitet.
PEARCH_MCP_GOOGLE_CLIENT_ID / PEARCH_MCP_GOOGLE_CLIENT_SECRET	—	Google OAuth 2.0 Webanwendungs-Client (registrieren Sie <base_url>/auth/callback als Redirect-URI). Erforderlich im oauth-Modus.
PEARCH_MCP_INTERNAL_TOKEN	—	Gemeinsames Geheimnis für den internen E-Mail→API-Schlüssel-Zuordnungs-Endpunkt der Pearch-API. Erforderlich im oauth-Modus.
PEARCH_MCP_OAUTH_STORE	disk	redis speichert den OAuth-Zustand (Client-Registrierungen, Token — verschlüsselt) in Redis, sodass er Neustarts übersteht und mehr als 1 Replikat ermöglicht.
PEARCH_MCP_OAUTH_REDIS_HOST / REDIS_ENDPOINT, REDIS_PORT, PEARCH_MCP_OAUTH_REDIS_DB, REDIS_PASSWORD	—, 6379, 4, —	Redis-Verbindung für den OAuth-Speicher.
PEARCH_MCP_ALLOWED_CLIENT_REDIRECT_URIS	eingebaute Liste	Kommagetrennte fnmatch-Muster für MCP-Client-Redirect-URIs (* = beliebig).
PEARCH_MCP_TOKEN_CACHE_TTL_S	300	TTL des Cache für verifizierte Identitäten; auch die Sperrverzögerung.
PEARCH_API_URL	https://api.pearch.ai	Pearch-API-Basis (pro Aufruf überschreibbar durch base_url).
PEARCH_API_KEY	test_mcp_key	Fallback-Schlüssel für stdio/lokale Nutzung.
MCP_DISABLE_AUTH	—	1 entspricht PEARCH_MCP_AUTH=none (nur lokale Entwicklung).

Im oauth-Modus muss der Ingress/Reverse-Proxy den gesamten Host an den Server weiterleiten, nicht nur /mcp: Der Ablauf fügt /.well-known/oauth-*, /authorize, /token, /register, /revoke, /consent und /auth/callback hinzu.

Entwicklung

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

Datenschutzerklärung

Die Datenschutzerklärung von Pearch.AI: https://pearch.ai/privacy-policy — deckt Datenerfassung, Nutzung, Speicherung, Weitergabe an Dritte, Aufbewahrung und Kontaktinformationen ab. Datenlöschung / Opt-out: https://pearch.ai/opt-out. Nutzungsbedingungen: https://pearch.ai/tos.

Support

• Ein Issue eröffnen
• f@pearch.ai

Lizenz

MIT — siehe LICENSE.