Was macht herohunt-mcp?
MCP-Server für die HeroHunt People Search API. Suche nach Talenten auf LinkedIn, GitHub und StackOverflow aus jedem MCP-kompatiblen KI-Agenten.
Schnellstart
Option 1: Remote-URL (empfohlen)
Claude Desktop, Cursor und die meisten modernen MCP-Clients unterstützen Remote-HTTP-Endpunkte direkt. Keine Paketinstallation erforderlich.
Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"herohunt-people-search": {
"url": "https://api.herohunt.ai/api/v1/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
Cursor (~/.cursor/mcp.json):
{
"mcpServers": {
"herohunt-people-search": {
"url": "https://api.herohunt.ai/api/v1/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
Option 2: stdio (über npx)
Für MCP-Clients, die nur stdio-Transport unterstützen:
{
"mcpServers": {
"herohunt-people-search": {
"command": "npx",
"args": ["-y", "herohunt-mcp"],
"env": {
"HEROHUNT_API_KEY": "DEIN_API_KEY"
}
}
}
}
API-Key erhalten
Melde dich unter herohunt.ai/app/api/sign-up an, um deinen API-Key zu erhalten.
Werkzeuge
| Werkzeug | Typ | Beschreibung |
|---|---|---|
people_search | Schreiben | Suche nach Personenprofilen mit natürlicher Sprache. 1 Credit pro reservierten Platz. |
people_search_paginate | Lesen | Mehr Ergebnisse für eine vorhandene Suche abrufen. Kostenlos, sofern keine Anreicherung aktiviert ist. |
account_usage_get | Lesen | Tarif, Credits und Ratenlimit-Informationen abrufen. Kostenlos. |
account_searches_list | Lesen | Vergangene Suchen auflisten. Kostenlos. |
account_upgrade_link | Lesen | URL zur Tarif-Upgrade-Seite abrufen. Kostenlos. |
account_billing_portal_link | Lesen | URL zum Stripe-Abrechnungsportal abrufen. Kostenlos. |
api_keys_list | Lesen | API-Key-Präfixe und -Bereiche auflisten. Kostenlos. |
api_keys_create | Schreiben | Einen neuen API-Key erstellen. |
api_keys_rotate | Schreiben | Einen vorhandenen API-Key rotieren. |
api_keys_revoke | Schreiben | Einen API-Key dauerhaft widerrufen. |
Beispiel
Nach dem Verbinden frage deinen KI-Agenten:
„Suche mit HeroHunt 5 leitende Go-Ingenieure in Berlin und fasse die Top 3 zusammen.“
Der Agent ruft people_search mit einer natürlichsprachlichen Abfrage auf, erhält strukturierte Profildaten (Name, Titel, Unternehmen, Ort, Fähigkeiten, Plattform-Links) und fasst die Ergebnisse zusammen.
Um Kontaktdaten zu erhalten, frage:
„Reichere die Ergebnisse mit E-Mail-Adressen und Telefonnummern an.“
Der Agent ruft people_search_paginate mit enrich: true auf.
Umgebungsvariablen
| Variable | Erforderlich | Standard | Beschreibung |
|---|---|---|---|
HEROHUNT_API_KEY | Ja | - | Dein People Search API-Key |
HEROHUNT_MCP_URL | Nein | https://api.herohunt.ai/api/v1/mcp | Überschreibt die MCP-Endpunkt-URL |
Links
Lizenz
MIT