Recruiter Roles

Servidor MCP de Recruiter Roles

Consulta el tablón de empleo de Recruiter Roles desde cualquier cliente de IA compatible con MCP (Claude, Cursor, ChatGPT, VS Code, …). Pregunta en lenguaje natural y obtén empleos en vivo de reclutamiento y adquisición de talento, perfiles de empresas, sectores, ubicaciones y estadísticas de mercado, directamente desde el tablón.

Solo lectura. Autenticado con una clave API gratuita de Recruiter Roles.

• Alojado (recomendado): https://recruiterroles.com/api/mcp (Streamable HTTP)
• Local (este paquete): npx recruiter-roles-mcp (stdio, para clientes solo stdio)
• Obtén una clave API gratuita: https://recruiterroles.com/api-access
• Documentación: https://recruiterroles.com/mcp · API REST: https://recruiterroles.com/api-docs

Herramientas

Herramienta	Descripción
search_jobs	Busca y filtra empleos en vivo (sector, ubicación, salario, remoto, actualidad, texto completo).
get_job	Detalle completo de un empleo: descripción, requisitos, beneficios, contacto de aplicación.
list_companies	Explora agencias de reclutamiento y empleadores con recuentos de empleos activos.
get_company	Un perfil de empresa junto con sus empleos activos.
list_sectors	Todos los sectores de reclutamiento con recuentos de empleos en vivo.
list_locations	Países, regiones y ciudades con recuentos de empleos en vivo.
market_stats	Resumen agregado del mercado: totales, velocidad de publicación y desgloses.

Todas las herramientas están anotadas con readOnlyHint: true, destructiveHint: false, openWorldHint: false y exponen un outputSchema.

Conexión

Servidor remoto alojado (recomendado)

La mayoría de los clientes pueden conectarse directamente al endpoint alojado Streamable HTTP con tu clave API en el encabezado Authorization (o como un parámetro de consulta ?key= para clientes que no pueden configurar encabezados).

Cursor — ~/.cursor/mcp.json:

{
  "mcpServers": {
    "recruiter-roles": {
      "url": "https://recruiterroles.com/api/mcp",
      "headers": { "Authorization": "Bearer rr_live_YOUR_KEY" }
    }
  }
}

VS Code — .vscode/mcp.json:

{
  "servers": {
    "recruiter-roles": {
      "type": "http",
      "url": "https://recruiterroles.com/api/mcp",
      "headers": { "Authorization": "Bearer rr_live_YOUR_KEY" }
    }
  }
}

Conector personalizado de Claude / ChatGPT — añade la URL con tu clave adjunta:

https://recruiterroles.com/api/mcp?key=rr_live_YOUR_KEY

Servidor local stdio (este paquete npm)

Para clientes solo stdio o desarrollo local. Configura tu clave API mediante la variable de entorno RECRUITER_ROLES_API_KEY:

{
  "mcpServers": {
    "recruiter-roles": {
      "command": "npx",
      "args": ["-y", "recruiter-roles-mcp"],
      "env": { "RECRUITER_ROLES_API_KEY": "rr_live_YOUR_KEY" }
    }
  }
}

Ejecútalo directamente:

RECRUITER_ROLES_API_KEY=rr_live_YOUR_KEY npx recruiter-roles-mcp

Cómo funciona

Esta es una capa delgada, de solo lectura, sobre la API REST v1 pública de Recruiter Roles. Cada herramienta reenvía tu clave API a un endpoint GET /api/v1/*, por lo que el uso de MCP comparte el mismo límite de velocidad (1,000 solicitudes/día por clave), el almacenamiento en caché y el registro de solicitudes que la API REST. El servidor no mantiene conexión de base de datos ni secretos propios.

Desarrollo

npm install
npm run build
RECRUITER_ROLES_API_KEY=rr_live_YOUR_KEY node dist/index.js

Opcional: apunta a un origen diferente durante el desarrollo con RECRUITER_ROLES_BASE_URL (por defecto https://recruiterroles.com).

Política de enlaces de retroceso

Cualquier página o producto que publique datos obtenidos a través de este servidor debe incluir un enlace visible y rastreable de vuelta a Recruiter Roles. Las claves pueden suspenderse si se elimina el enlace de retroceso.

Licencia

MIT — consulta LICENSE.