¿Qué hace herohunt-mcp?
Servidor MCP para la API de Búsqueda de Personas HeroHunt. Busca talento en LinkedIn, GitHub y StackOverflow desde cualquier agente de IA compatible con MCP.
Inicio rápido
Opción 1: URL remota (recomendada)
Claude Desktop, Cursor y la mayoría de los clientes MCP modernos soportan endpoints HTTP remotos directamente. No se necesita instalación de paquetes.
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"
}
}
}
}
Opción 2: stdio (vía npx)
Para clientes MCP que solo soportan transporte stdio:
{
"mcpServers": {
"herohunt-people-search": {
"command": "npx",
"args": ["-y", "herohunt-mcp"],
"env": {
"HEROHUNT_API_KEY": "YOUR_API_KEY"
}
}
}
}
Obtén tu clave API
Regístrate en herohunt.ai/app/api/sign-up para obtener tu clave API.
Herramientas
| Herramienta | Tipo | Descripción |
|---|---|---|
people_search | Escribir | Busca perfiles de personas usando lenguaje natural. 1 crédito por resultado reservado. |
people_search_paginate | Leer | Obtén más resultados de una búsqueda existente. Gratuito si el enriquecimiento está desactivado. |
account_usage_get | Leer | Obtén información del plan, créditos y límites de velocidad. Gratuito. |
account_searches_list | Leer | Lista las búsquedas anteriores. Gratuito. |
account_upgrade_link | Leer | Obtén la URL de actualización del plan. Gratuito. |
account_billing_portal_link | Leer | Obtén la URL del portal de facturación de Stripe. Gratuito. |
api_keys_list | Leer | Lista los prefijos y alcances de las claves API. Gratuito. |
api_keys_create | Escribir | Crea una nueva clave API. |
api_keys_rotate | Escribir | Rota una clave API existente. |
api_keys_revoke | Escribir | Revoca permanentemente una clave API. |
Ejemplo
Después de conectar, pregúntale a tu agente de IA:
"Usa HeroHunt para encontrarme 5 ingenieros senior de Go en Berlín y resume los 3 mejores."
El agente llamará a people_search con una consulta en lenguaje natural, recibirá datos estructurados del perfil (nombre, cargo, empresa, ubicación, habilidades, enlaces a plataformas) y resumirá los resultados.
Para obtener información de contacto, pregunta:
"Enriquece los resultados con correos electrónicos y números de teléfono."
El agente llamará a people_search_paginate con enrich: true.
Variables de entorno
| Variable | Obligatoria | Valor por defecto | Descripción |
|---|---|---|---|
HEROHUNT_API_KEY | Sí | - | Tu clave de la API de Búsqueda de Personas |
HEROHUNT_MCP_URL | No | https://api.herohunt.ai/api/v1/mcp | Sobrescribe la URL del endpoint MCP |
Enlaces
Licencia
MIT