AyHire

Contrata ingenieros por lo que han publicado. Describe un puesto y AyHire encuentra desarrolladores a partir de su trabajo público en GitHub, evalúa a cada uno según tus criterios con enlaces a la evidencia, indica quién está abierto a trabajar y mantiene tus puestos y lista de preseleccionados. Servidor remoto con inicio de sesión OAuth.

Ver en ayhire.com

Servidor MCP alojado

npx add-mcp 'https://ayhire.com/mcp'

Se instala en Claude Code, Codex, Cursor y más

Documentación

Índice de todo lo que AyHire publica para agentes: https://ayhire.com/llms.txt

AyHire para agentes

La mayoría de las aplicaciones de IA se conectan con la dirección de AyHire, https://ayhire.com/mcp, y un inicio de sesión: no hay clave que copiar. Los agentes que pueden ejecutar comandos pueden pegar un solo prompt en su lugar, y los scripts pueden usar la API HTTP con una clave.

Conectar por dirección (iniciar sesión, sin clave)

La dirección de AyHire: https://ayhire.com/mcp. Pégala en tu aplicación de IA e inicia sesión cuando AyHire se abra. https://ayhire.com/mcp y https://ayhire.com/api/mcp son el mismo servidor.

Claude (web, escritorio y móvil)

Añade AyHire como conector personalizado una vez. Luego funciona en la web, en la aplicación de escritorio y en tu teléfono.

  1. En Claude, abre Personalizar › Conectores, haz clic en + Añadir, luego en Añadir conector personalizado.
  2. Nómbralo AyHire, pega esto como URL del servidor y haz clic en Continuar. 
    https://ayhire.com/mcp
  3. Si Claude muestra la configuración de inicio de sesión que encontró, haz clic en Continuar. En Autenticación, elige Iniciar sesión ahora. En Cliente OAuth, elige Registrar automáticamente. Luego haz clic en Añadir.
  4. AyHire se abre. Inicia sesión, elige el espacio de trabajo que debe usar y haz clic en Conectar.
  5. En un chat, haz clic en + › Conectores y activa AyHire.

Comprueba que funciona: Pregunta a Claude: "Usa AyHire para comprobar con quién he iniciado sesión". Responde con tu correo electrónico.

Para desconectar: Pide a Claude que desconecte AyHire, o desconéctalo en AyHire en Integraciones › Aplicaciones conectadas. Para eliminarlo también de Claude: Personalizar › Conectores › AyHire › Eliminar.

  • En un plan de Team o Enterprise, un propietario lo añade primero: Configuración de la organización › Conectores › Añadir › Personalizado › Web. Luego cada persona hace clic en Conectar.
  • El plan gratuito permite un conector personalizado.
  • Si tu diálogo muestra Configuración avanzada en lugar de estas opciones, deja el ID de cliente OAuth vacío.

Pasos verificados contra Centro de ayuda de Claude: conectores personalizados, Documentación de Claude: conectores no incluidos en el directorio y Documentación de Claude: autenticación de conectores el 15 de octubre de 2026. Aún no probado manualmente con AyHire. No verificado: si Claude elige Registrar automáticamente por sí solo para un servidor como AyHire. Las pantallas exactas en los planes Team y Enterprise.

ChatGPT

Añade AyHire como servidor MCP personalizado en chatgpt.com.

  1. Ve a Plugins de ChatGPT, haz clic en +, luego en Añadir servidor MCP personalizado.
  2. Nómbralo AyHire y pega esto como URL del servidor. 
    https://ayhire.com/mcp
  3. Para autenticación elige OAuth. Si pregunta cómo debe registrarse ChatGPT, elige registro dinámico.
  4. Haz clic en Entiendo y quiero continuar, luego en Crear como plugin, e instálalo desde tus plugins personales.
  5. La primera vez que se use, AyHire se abre: inicia sesión, elige un espacio de trabajo y haz clic en Conectar.
  6. En un chat, escribe @ y elige AyHire.

Comprueba que funciona: Pregunta: "@AyHire ¿con quién he iniciado sesión?" Responde con tu correo electrónico.

Para desconectar: Pide a ChatGPT que desconecte AyHire, o desconéctalo en AyHire en Integraciones › Aplicaciones conectadas. Luego elimina el plugin en la configuración de plugins de ChatGPT.

  • ¿No ves Añadir servidor MCP personalizado? Activa Modo desarrollador en la configuración de ChatGPT. En una cuenta de trabajo, tu administrador puede tener que permitirlo.
  • ChatGPT te pregunta antes de la mayoría de búsquedas de AyHire, nuevos análisis y cualquier cosa que cambie un rol o una vigilancia. Leer evidencia, tus roles, tu lista corta y tu lista de vigilancia se ejecuta directamente.
  • Los servidores MCP personalizados funcionan en el sitio web de ChatGPT. Las reglas de tu espacio de trabajo pueden desactivarlos.

Pasos verificados contra OpenAI: Añadir servidor MCP personalizado, OpenAI: Autenticación y OpenAI: Inicio rápido de plugins el 15 de octubre de 2026. Aún no probado manualmente con AyHire. No verificado: si el Modo desarrollador sigue siendo necesario, dónde está su interruptor y qué planes lo tienen. El nombre exacto de la opción de registro. Si AyHire funciona fuera de los chats de Work. Si ChatGPT te pide iniciar sesión en AyHire por sí solo y cuándo: la documentación de OpenAI describe una señal de inicio de sesión que AyHire aún no envía.

Claude Code

Un comando, luego iniciar sesión.

  1. Ejecuta esto en tu terminal: 
    claude mcp add --transport http --scope user ayhire https://ayhire.com/mcp
  2. Inicia sesión: ejecuta claude mcp login ayhire, o escribe /mcp en Claude Code, elige ayhire y sigue el navegador. 
    claude mcp login ayhire
  3. AyHire se abre en tu navegador. Inicia sesión, elige un espacio de trabajo y haz clic en Conectar.

Comprueba que funciona: claude mcp list muestra ayhire como Conectado. O pregunta a Claude: "Usa AyHire para comprobar con quién he iniciado sesión".

Para desconectar: Pide a Claude que desconecte AyHire, luego ejecuta claude mcp remove --scope user ayhire. (claude mcp logout ayhire solo olvida el inicio de sesión en este ordenador.)

  • ¿Ya lo configuraste con el prompt de configuración de AyHire? Entonces AyHire está conectado: omite esto. Para iniciar sesión en su lugar, pide a Claude que desconecte AyHire, luego ejecuta claude mcp remove --scope user ayhire primero.
  • ¿Usas el plugin de AyHire? Se conecta con su propia clave: omite esto. Para iniciar sesión en su lugar, pide a Claude que desconecte AyHire, luego ejecuta /plugin uninstall ayhire@ayhire primero. Sus habilidades se van con él.
  • --scope user hace que AyHire esté disponible en todos los proyectos.

Pasos verificados contra Documentación de Claude Code: MCP el 15 de octubre de 2026. Aún no probado manualmente con AyHire.

Codex

Un comando para añadir AyHire, uno para iniciar sesión.

  1. Ejecuta: 
    codex mcp add ayhire --url https://ayhire.com/mcp
  2. Luego inicia sesión: 
    codex mcp login ayhire
  3. AyHire se abre en tu navegador. Inicia sesión, elige un espacio de trabajo y haz clic en Conectar.

Comprueba que funciona: Escribe /mcp en Codex: ayhire aparece listado con sus herramientas.

Para desconectar: Pide a Codex que desconecte AyHire. Luego elimínalo de Codex (codex mcp --help lista el comando).

  • ¿Ya lo configuraste con el prompt de configuración de AyHire? Entonces AyHire está conectado: omite esto.
  • Codex mantiene AyHire en ~/.codex/config.toml.

Pasos verificados contra Documentación de Codex: MCP el 15 de octubre de 2026. Aún no probado manualmente con AyHire. No verificado: cómo cerrar sesión o eliminar un servidor en Codex: su página de MCP no lo dice. Si codex mcp login abre tu navegador por sí solo: su página de MCP no lo dice.

Cursor

Añade la dirección de AyHire al archivo de configuración de Cursor, luego inicia sesión.

  1. Abre ~/.cursor/mcp.json (críalo si falta) y añade AyHire. Si el archivo ya lista servidores, añade la entrada ayhire dentro de mcpServers. 
    {
  "mcpServers": {
    "ayhire": { "url": "https://ayhire.com/mcp" }
  }
}
  2. Reinicia Cursor.
  3. Abre Personalizar › MCPs e inicia sesión en ayhire cuando Cursor lo pida. AyHire se abre: inicia sesión, elige un espacio de trabajo y haz clic en Conectar.

Comprueba que funciona: En Personalizar › MCPs, ayhire está activado y lista sus herramientas.

Para desconectar: Pide al agente de Cursor que desconecte AyHire, luego elimina ayhire en Personalizar › MCPs (o desde mcp.json).

  • ¿Ya lo configuraste con el prompt de configuración de AyHire? Entonces AyHire está conectado: omite esto.
  • Cursor recibe el inicio de sesión en el puerto 8787 de tu ordenador. Mantén ese puerto libre mientras te conectas.

Pasos verificados contra Documentación de Cursor: MCP y Ayuda de Cursor: MCP el 15 de octubre de 2026. Aún no probado manualmente con AyHire. No verificado: la etiqueta del botón de inicio de sesión de Cursor para un servidor añadido en mcp.json.

VS Code (GitHub Copilot)

Añade AyHire como servidor HTTP, luego permite el inicio de sesión.

  1. Abre la Paleta de comandos y ejecuta MCP: Añadir servidor.
  2. Elige HTTP, pega esta dirección, nómbralo ayhire y guárdalo en Copilot Global para que todos los proyectos lo tengan. 
    https://ayhire.com/mcp
  3. O añádelo manualmente a ~/.copilot/mcp-config.json (críalo si falta). Si el archivo ya lista servidores, añade la entrada ayhire dentro de mcpServers. 
    {
  "mcpServers": {
    "ayhire": {
      "type": "http",
      "url": "https://ayhire.com/mcp"
    }
  }
}
  4. Inicia el servidor cuando VS Code lo pida y permite el inicio de sesión. AyHire se abre: inicia sesión, elige un espacio de trabajo y haz clic en Conectar.

Comprueba que funciona: Ejecuta MCP: Listar servidores: ayhire está en ejecución. En el modo agente de Copilot Chat, sus herramientas están listadas.

Para desconectar: Pide a Copilot que desconecte AyHire, luego ejecuta MCP: Listar servidores, elige ayhire y elimínalo.

  • ¿Ya lo configuraste con el prompt de configuración de AyHire? Eso añadió AyHire solo al .vscode/mcp.json de un proyecto. Estos pasos lo añaden a todos los proyectos.
  • Si configuras COPILOT_HOME, el archivo está en esa carpeta en lugar de ~/.copilot.

Pasos verificados contra Documentación de VS Code: servidores MCP el 15 de octubre de 2026. Aún no probado manualmente con AyHire. No verificado: el prompt de inicio de sesión de VS Code y cómo cerrar sesión de un servidor: su página de MCP no los describe.

Gemini CLI

Un comando, luego inicia sesión desde Gemini CLI.

  1. Ejecuta: 
    gemini mcp add --transport http --scope user ayhire https://ayhire.com/mcp
  2. Inicia Gemini CLI e inicia sesión: 
    /mcp auth ayhire
  3. AyHire se abre en tu navegador. Inicia sesión, elige un espacio de trabajo y haz clic en Conectar.

Comprueba que funciona: Escribe /mcp en Gemini CLI: ayhire aparece listado con sus herramientas.

Para desconectar: Pide a Gemini que desconecte AyHire primero, luego ejecuta gemini mcp remove --scope user ayhire.

  • ¿Ya lo configuraste con el prompt de configuración de AyHire? Entonces AyHire está conectado: omite esto.
  • Sin --scope user, Gemini CLI añade AyHire solo al proyecto actual.

Pasos verificados contra Documentación de Gemini CLI: servidores MCP el 15 de octubre de 2026. Aún no probado manualmente con AyHire. No verificado: si eliminar el servidor también borra el inicio de sesión guardado de Gemini (guarda tokens en ~/.gemini/mcp-oauth-tokens.json).

Configurar con un solo prompt (agentes que ejecutan comandos)

Pega esto en Claude Code, Codex, Cursor o cualquier agente que pueda ejecutar comandos:

Set up AyHire for me: fetch https://ayhire.com/setup.md with curl and follow it step by step.

Los pasos que sigue: https://ayhire.com/setup.md. La clave va del navegador directamente a un archivo en ese ordenador y nunca aparece en el chat.

Plugin de Claude Code

Con acceso al repositorio de AyHire, el plugin hace lo mismo que el prompt:

/plugin marketplace add walidboulanouar/ayhire
/plugin install ayhire@ayhire

Cualquier agente MCP

Los agentes que admiten inicio de sesión MCP abren AyHire en el navegador la primera vez:

{"mcpServers":{"ayhire":{"type":"http","url":"https://ayhire.com/mcp"}}}

O con una clave de API de AyHire:

{
  "mcpServers": {
    "ayhire": {
      "type": "http",
      "url": "https://ayhire.com/api/mcp",
      "headers": { "Authorization": "Bearer YOUR_AYHIRE_API_KEY" }
    }
  }
}

Crea una clave en https://ayhire.com/app/integrations#keys después de iniciar sesión. x-api-key: YOUR_AYHIRE_API_KEY funciona igual que el encabezado Authorization. https://ayhire.com/mcp y https://ayhire.com/api/mcp son el mismo servidor.

Línea de comandos

ayhire login     # sign in in the browser and save a key on this computer
ayhire status    # check the saved key and which account it belongs to
ayhire logout    # revoke the key on AyHire and delete it from this computer

Cerrar sesión

Pide a tu agente que desconecte AyHire (la herramienta disconnect), o ejecuta ayhire logout. Cualquiera de los dos termina el acceso en el lado de AyHire de inmediato. Eliminar ~/.config/ayhire/credentials.json manualmente no lo hace: la clave sigue funcionando hasta que se revoca. Las claves y las aplicaciones conectadas también se pueden revocar en https://ayhire.com/app/integrations.

API HTTP

curl "https://ayhire.com/api/search" \
  -H "x-api-key: YOUR_AYHIRE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "senior Rust backend engineer"}'

Las rutas principales (analizar, buscar, candidatos, listas cortas), con formas de solicitud y respuesta: https://ayhire.com/api/docs. Las herramientas MCP anteriores cubren el resto.

Herramientas

  • whoami: Verifica que AyHire esté conectado y qué cuenta está llamando. Llama a esto primero al configurar o cuando otras herramientas de AyHire fallen con un error de autenticación.
  • disconnect: Termina la conexión de este agente con AyHire: la clave o el inicio de sesión que usa deja de funcionar de inmediato, del lado de AyHire. Úsalo solo cuando el usuario pida cerrar sesión, desconectar, eliminar u olvidar AyHire aquí. El sitio web de AyHire permanece con la sesión iniciada; otros agentes permanecen conectados a menos que usen la misma clave. Después de esto, las herramientas de AyHire dejan de funcionar en este agente: no intentes iniciar sesión de nuevo a menos que el usuario pida reconectar.
  • analyze_github_user: Para alguien en un rol, usa score_role_person en su lugar (también los evalúa contra los criterios del rol). Evalúa el trabajo público de un usuario de GitHub en 4 dimensiones generales (technical_depth, shipping_velocity, communication, gem_score; 0-10 cada una, total sobre 40) con hallazgos (lo que muestra su trabajo) y señales de alerta, cada una con los enlaces de GitHub en los que se basa (las afirmaciones sin fuente se descartan), y habilidades principales. El análisis lee sus propios repositorios y su trabajo en proyectos de otras personas (outside_work: commits y PRs por repositorio, último año). Las puntuaciones son generales: ninguna se evalúa contra un rol, y dónde vive alguien nunca se usa. Devuelve un resultado guardado si el usuario fue analizado en los últimos 30 días (gratis, cached=true); de lo contrario, extrae, puntúa y guarda (tarda 15-25 s). También devuelve activity: su calendario de contribuciones de GitHub del último año, resumido (total, semanas activas, rachas, mes más ocupado, última actividad; null cuando GitHub no tiene ninguna). Establece refresh=true solo cuando el usuario pida un análisis fresco. Parámetros: username (obligatorio), refresh, persist.
  • analyze_github_users: Analiza hasta 25 usuarios de GitHub en una sola llamada y devuélvelos clasificados, mejor total primero (los totales son sobre 40), cada uno con las cuatro puntuaciones generales, un resumen, habilidades principales y señales de alerta. Los análisis guardados de los últimos 30 días son gratis e instantáneos. Hasta 4 análisis nuevos comienzan por llamada (aproximadamente 20-35 s juntos); cualquier otro regresa en pending: llama de nuevo con esos. Los análisis nuevos cuentan para el límite por hora (20); cuando se agota, el resto regresa en limited con limit_resets_at (sin plan: limit_reason lo dice). Úsalo para comparar una lista corta o para puntuar a las personas que find_people_behind_repos devolvió. Parámetros: usernames (obligatorio).
  • score_candidate: Para alguien en un rol, usa score_role_person en su lugar (también los evalúa contra los criterios del rol). Versión ligera de analyze_github_user que nunca escribe en la base de datos. Usa un resultado guardado si está fresco; de lo contrario, extrae y puntúa sin guardar. Parámetros: username (obligatorio), refresh.
  • find_people_behind_repos: Encuentra a los desarrolladores que construyen proyectos de código abierto: busca en GitHub repositorios (más estrellas primero) que coincidan con una consulta, tema o lenguaje, luego lista a las personas que más contribuyeron a ellos, clasificadas por cuántos de esos repositorios construyen y cuánto contribuyeron. Los bots y agentes de codificación de IA están excluidos. Pasa repo ('owner/name') para las personas detrás de un proyecto exacto, u org ('vercel') para las personas detrás de los repositorios de una organización (cada persona tiene public_member; false solo significa que no se muestra como miembro). Extraer varios repositorios semilla uno tras otro suele ser la mejor manera de encontrar personas fuertes. location mantiene a personas cuya ubicación de GitHub está en uno de los lugares, más personas que no listan ubicación, marcadas location_match: 'unknown' (unknown nunca es un desajuste; location_unknown: 'exclude' los deja fuera). page lee el siguiente conjunto de repositorios. Con role_id, las personas que el rol ya ha visto se omiten (a menos que include_seen) y la búsqueda va al historial del rol. Gratis (solo GitHub). Parámetros: query, repo, org, topic, language, min_stars, created_after, pushed_after, repo_limit, people_per_repo, limit, page, location, location_unknown, role_id, include_seen.
  • search_people: Busca perfiles de GitHub: palabras coincidentes con nombre, usuario y biografía (por ejemplo, 'rust database', 'GTM engineer', 'AI adoption'; GitHub necesita que cada palabra coincida, así que usa de una a tres), una ubicación (una ciudad, un país o una región como Europa), el lenguaje de sus repositorios, seguidores mínimos o repositorios. Cada persona regresa con biografía, ubicación, empresa, seguidores, el indicador hireable y sus 3 mejores repositorios propios. Bueno para roles donde los perfiles dicen más que los repositorios, y para una restricción de ubicación; para ingenieros, extraer los contribuyentes de repositorios semilla (find_people_behind_repos) suele ser más fuerte. Devuelve la consulta exacta ejecutada y el total; pasa next_cursor como cursor para más. Con role_id, las personas que el rol ya ha visto se omiten (a menos que include_seen) y la búsqueda va al historial del rol. Gratis. Parámetros: query, location, language, min_followers, min_repos, sort, cursor, limit, role_id, include_seen.
  • search_repos: Busca repositorios de GitHub por palabras, tema, lenguaje, organización propietaria, estrellas y fechas, más estrellas (o más recientemente actualizados) primero, 30 por página, cada uno con descripción, estrellas, temas, tipo de propietario y fechas. Úsalo para encontrar listas semilla (listas impresionantes, directorios de comunidades), los proyectos en los que un rol trabajaría, o repositorios pequeños y serios (sin mínimo de estrellas por defecto), luego extrae sus personas con find_people_behind_repos(repo=...). Las búsquedas por tema suelen ser más limpias que las palabras clave; cada palabra debe coincidir, así que usa pocas. Devuelve la consulta exacta ejecutada. Gratis. Parámetros: query, topic, language, org, min_stars, created_after, pushed_after, sort, page.
  • search_commits: Encuentra quién escribió realmente commits que coinciden con algunas palabras, por ejemplo, 'smartlead webhook', 'hubspot sync', 'mvcc snapshot isolation', opcionalmente dentro de un repositorio u organización. Las personas regresan agrupadas, más commits coincidentes primero, cada una con hasta 3 commits de ejemplo (repositorio, asunto, día UTC, enlace) y en cuántos repositorios están sus commits coincidentes. Los commits en forks se omiten (contados como in_forks) a menos que nombres el repositorio. Bueno para encontrar practicantes cuyo trabajo está repartido en muchos repositorios pequeños. Los commits cuyo correo no está vinculado a una cuenta de GitHub solo se cuentan (unattributed). Con role_id, las personas que el rol ya ha visto se omiten (a menos que include_seen) y la búsqueda va al historial del rol. Gratis; usa la búsqueda de GitHub (aproximadamente 30 por minuto). Parámetros: query (obligatorio), repo, org, page, role_id, include_seen.
  • get_person_evidence: Todo lo que un reclutador haría clic en GitHub para juzgar a alguien, en una llamada, cada elemento con su enlace: perfil y README del perfil, sus repositorios (código, prosa como playbooks y listas, o forks) con descripciones, cómo trabajaron en sus mejores repositorios (commits, días activos, cuántos hechos con un agente de codificación de IA), su trabajo en proyectos de otras personas del gráfico de contribuciones (último año), pull requests que abrieron a otros repositorios (agrupados, recuentos de fusionados, títulos), organizaciones, actividad mes a mes, y, con role_id, los repositorios a través de los cuales la búsqueda del rol los encontró y su historial allí. Leído en vivo de GitHub, gratis, aproximadamente 5 s. Úsalo para verificar una afirmación o juzgar el ajuste tú mismo; unknown lista lo que GitHub no pudo mostrar esta vez (unknown no es una debilidad). Compacto por defecto (solo repositorios propios, forks contados; listas más cortas); detalle: 'full' para todo. READMEs completos: read_readme. Todos los PRs o commits: list_pull_requests, list_commits. Parámetros: username (obligatorio), role_id, detail.
  • read_readme: El README completo de cualquier repositorio público de GitHub (hasta 30,000 caracteres, con truncated=true más allá), con su enlace. Lee el trabajo en sí antes de juzgarlo: qué hace el proyecto, qué tan serio es, qué tan bien está explicado. Gratis. Parámetros: repo (obligatorio).
  • contribution_profile: Lo que un desarrollador hizo realmente en un repositorio, en una llamada: pull requests fusionadas (recuento, primera y última, las 10 más recientes con tamaño y enlaces), las áreas de código que esos PRs tocaron (por ejemplo, core/mvcc 22, core/translate 9), PRs aún abiertos, PRs de otros que revisaron, sus commits allí (captura a personas que hacen commits directamente), y su rango entre sus contribuyentes. Úsalo para verificar una afirmación como 'contribuyente principal del motor de almacenamiento' o para ver el área real de alguien en un proyecto grande. Gratis, en vivo, aproximadamente 3 s. Parámetros: username (obligatorio), repo (obligatorio).
  • list_pull_requests: Pull requests que un desarrollador abrió, más recientes primero, 30 por página, cada una con su repositorio, título, enlace, estado, si fue fusionada y el inicio de su descripción. Limita a un repositorio ('owner/name') o un estado (open, closed, merged). Úsalo para ver lo que realmente cambiaron en proyectos que no poseen. Gratis; usa la búsqueda de GitHub, que permite aproximadamente 30 búsquedas por minuto. Parámetros: username (obligatorio), repo, state, page.
  • list_commits: Los commits de un desarrollador en un repositorio (suyo o de cualquiera), más recientes primero, 30 por página: asunto, fecha, enlace, coautores nombrados en el commit, y si fue hecho con un agente de codificación de IA. Úsalo para ver lo que hicieron en un proyecto y cómo trabajan. Gratis. Parámetros: username (obligatorio), repo (obligatorio), page.
  • enrich_person: Para un usuario de GitHub: URL de LinkedIn, titular y empresas actuales, un correo de trabajo, y su perfil de X, con la fuente y confianza de cada uno. Usa GitHub primero (gratis), luego búsquedas pagadas (generalmente $0.001-0.015, hasta ~$0.03 con deep=true). Guardado y reutilizado durante 30 días (cached=true es gratis). Úsalo en personas que el usuario está considerando seriamente, no en cada nombre de una lista. deep=true también busca la biografía de X y por nombre + empresa. Parámetros: username (obligatorio), deep, find_email, refresh.
  • check_availability: ¿Este usuario de GitHub ya está empleado o abierto a trabajar? Combina su rol actual de LinkedIn, la empresa en su perfil de GitHub y el indicador 'available for hire' de GitHub. Devuelve un veredicto cauteloso (employed, employed_but_open, open_to_work, likely_employed, unknown) con la evidencia. Ejecuta las mismas búsquedas que enrich_person (y las guarda), así que llamar a ambos no cuesta nada extra. Parámetros: username (obligatorio), deep.
  • search_candidates: Búsqueda en lenguaje natural sobre desarrolladores que AyHire ya ha analizado (similitud semántica más clasificación por puntuación), por ejemplo, 'senior Rust backend engineer with distributed systems experience'. Solo encuentra personas analizadas antes; usa analyze_github_user para agregar a alguien. Parámetros: query (obligatorio), limit, threshold, filters.
  • list_roles: Los roles (posiciones abiertas) en tu espacio de trabajo actual (o workspace), más recientes primero, cada uno con recuentos de seleccionados, apartados, no vistos aún y preseleccionados. Parámetros: workspace.
  • create_role: Crea un rol (una posición abierta) para buscar personas. AyHire sugiere sus criterios del título y resumen (lo que el rol necesita, cada uno con una importancia: must, important o nice; las personas se evalúan contra ellos) a menos que pases criteria, y convierte el título y resumen en una búsqueda inicial de GitHub a menos que pases query/language. El rol va en tu espacio de trabajo actual (o workspace) y también aparece en la aplicación web de AyHire. Parámetros: title (obligatorio), brief, query, language, created_after, criteria, workspace.
  • set_role_criteria: Reemplazar los criterios de un rol: qué necesita el rol, cada uno juzgado a partir del trabajo público de alguien, con una importancia (must, important o nice). Usa las palabras del usuario; lo específico supera a lo genérico ('Storage engine internals', no 'Strong engineer'). Las personas evaluadas con los criterios antiguos aparecen como desactualizadas hasta que score_role_person las evalúe de nuevo. La aplicación web muestra los mismos criterios. Parámetros: role_id (obligatorio), criteria (obligatorio).
  • suggest_role_criteria: Sugerir criterios para un rol a partir de su título y descripción breve, sin guardarlos: muéstralos al usuario y luego guárdalos con set_role_criteria (tal como están o modificados). Útil cuando la descripción breve cambió o los criterios actuales no parecen adecuados. Parámetros: role_id (obligatorio).
  • get_role: Un rol y todos los que están en él, clasificados: primero los elegidos (personas evaluadas según los criterios del rol por la evidencia de ajuste, luego el resto por la fortaleza general de su trabajo público; ranking_basis indica cuál), luego los apartados (evidencia pública en contra de un requisito imprescindible), y luego las personas aún no revisadas. Este es el orden final: llámalo después de puntuar. Cada persona tiene la recomendación de AyHire (titular, por qué en una línea, una cosa a verificar), su veredicto por criterio con enlaces, tu decisión, notas, disponibilidad y puntuación total. Compacto por defecto (razones más cortas, hasta 2 enlaces por veredicto, como máximo 25 personas aún no revisadas); detalle: 'full' para todo. Úsalo para responder '¿a quién debería hablar primero?'. Parámetros: role_id (obligatorio), include, detail.
  • find_people_for_role: Ejecutar la búsqueda propia del rol y guardar a todos los que encuentre en el rol. Un rol con un plan de búsqueda (search_plan en get_role: la combinación del rol, herramientas y 3-6 búsquedas leídas de su descripción breve) ejecuta cada búsqueda: repositorios sobre el trabajo, repositorios que usan las herramientas, perfiles que mencionan el puesto y los mantenedores de las propias herramientas (mantenidos aparte como builders). Cada búsqueda se responde primero desde el índice propio de AyHire de personas y se busca en vivo en GitHub solo donde el índice es escaso o tiene más de un mes. Cada persona viene con why_found, source (índice o GitHub ahora mismo) y una relevancia (ajuste de área, similitud de la descripción breve, calidad, retroalimentación). Los roles más antiguos ejecutan una búsqueda: personas detrás de los mejores repositorios que coinciden con sus palabras e idioma. Las personas que el rol ya ha visto se omiten, así que cada ronda trae gente nueva (include_seen para traerlas de vuelta); la página 2 y siguientes leen los siguientes repositorios. Devuelve a todos los encontrados con nombre, empresa, ubicación, indicador 'hireable' de GitHub, seguidores, los repositorios coincidentes que construyen y cuánto. Para elegir personas tú mismo, usa las herramientas de búsqueda con role_id (search_people, find_people_behind_repos, search_commits) y add_people_to_role. Nada se puntúa aún: llama a score_role_person para las personas que valga la pena examinar más de cerca. Gratis (solo GitHub). Pasa query/language para buscar de manera diferente esta vez. Parámetros: role_id (obligatorio), query, language, page, location, location_unknown, include_seen.
  • add_people_to_role: Añadir personas que elegiste (de cualquier búsqueda, o que conozcas) a un rol, cada una con una razón de una línea en palabras simples: por qué encajan en este rol, a partir de su trabajo (p. ej. 'Escribió la capa MVCC de turso: 103 PRs fusionados titulados mvcc'). El rol conserva la razón y cómo fueron encontradas, mostrado en la aplicación web y en get_role. Hasta 25 a la vez. Las personas ya en el rol conservan su decisión y notas; una razón nueva reemplaza a la anterior. Luego score_role_person las puntúa. Parámetros: role_id (obligatorio), people (obligatorio), found_via.
  • score_role_person: Analizar a una persona (4 puntuaciones generales, resumen, banderas rojas; lee sus propios repositorios, su trabajo en proyectos de otros y los repositorios a través de los cuales la búsqueda del rol la encontró), evaluarla según los criterios del rol (cada veredicto con enlaces a su evidencia; unknown nunca es negativo) y comprobar si está disponible, luego devolverla con la recomendación de AyHire y su lugar entre los elegidos hasta ahora. Alguien que aún no está en el rol se añade primero (pasa reason). Un análisis guardado es gratis e instantáneo; uno nuevo tarda 15-25 segundos y cuenta para el límite por hora (20 análisis), así que puntúa a quienes valga la pena, no a todos. El orden cambia a medida que puntúas más personas: llama a get_role para la clasificación final. Si una llamada agota el tiempo, llámala una vez más: cuando el análisis terminó mientras tanto, el reintento es instantáneo y gratis. Parámetros: role_id (obligatorio), username (obligatorio), reason.
  • decide: Registrar una decisión sobre alguien en un rol: shortlisted, not_now o none (deshacer). Opcionalmente añade una nota. Las decisiones se comparten con todos en el espacio de trabajo del rol. Las personas preseleccionadas aparecen en get_shortlist y en la Shortlist de la aplicación web. Parámetros: role_id (obligatorio), username (obligatorio), decision (obligatorio), note.
  • get_shortlist: Todos los preseleccionados en tu espacio de trabajo actual (o workspace), en todos sus roles (la misma lista que la Shortlist de la aplicación web), los más recientes primero, con la recomendación de AyHire y las notas. Parámetros: workspace.
  • watch_person: Vigilar a alguien en tu espacio de trabajo actual (o workspace), con o sin rol. Aproximadamente una vez al día AyHire vuelve a revisar su perfil público de GitHub y su actividad, y cada cambio sobre el que preguntaste aparece en Home y en list_watches con el enlace donde se vio. rules (por defecto: all): open_to_work (el indicador “available for hire” de GitHub se activa, o la biografía/el titular de LinkedIn dice #OpenToWork), job_change (la empresa en su perfil de GitHub cambia; su empleador de LinkedIn cuando AyHire lo lee), says_looking (la biografía/el titular dice looking for, seeking o available for new work), new_work (actividad pública después de 30+ días de silencio, un nuevo repositorio público o un lanzamiento). paid_checks=true también vuelve a leer su LinkedIn cada 14 días cuando AyHire ya lo tiene: una consulta de pago, alrededor de $0.005 cada una, dentro de los límites de AyHire. Pregunta al usuario antes de activarlo. Las vigilancias se comparten con el equipo del espacio de trabajo. AyHire no puede vigilar publicaciones (p. ej. sobre dejar un trabajo): no las lee. Parámetros: username (obligatorio), rules, paid_checks, role_id, workspace.
  • unwatch_person: Dejar de vigilar a alguien en tu espacio de trabajo actual (o workspace). Sus comprobaciones diarias se detienen para este espacio de trabajo. Parámetros: username (obligatorio), workspace.
  • list_watches: Todos los vigilados en tu espacio de trabajo actual (o workspace): para qué es cada vigilancia, cuándo AyHire comprobó por última vez y el cambio más reciente con su enlace. El may_fit de cada vigilancia lista los roles abiertos en este espacio de trabajo para los que la persona también podría encajar, desde el índice de AyHire de su trabajo público (sin modelo, nunca ubicación), con la razón y su enlace; added es true una vez que están en ese rol (no los añadas de nuevo). Añade a alguien con add_people_to_role. Parámetros: workspace.
  • list_workspaces: Tus espacios de trabajo de AyHire y cuál es el actual. Un espacio de trabajo contiene roles y su lista de preseleccionados: uno por empresa para la que contratas, compartido con el equipo de esa empresa. Cada cuenta tiene uno personal. Cada uno muestra el dominio de correo de su empresa y su logotipo cuando lo tiene, y waiting_to_join lista los espacios de trabajo a los que pediste unirte y que un propietario aún no te ha permitido.
  • switch_workspace: Hacer que uno de tus espacios de trabajo sea el actual, para este agente y la aplicación web. Las herramientas de roles entonces listan y crean allí. Para actuar en otro espacio de trabajo en una sola llamada, pasa workspace a esa herramienta en su lugar. Parámetros: workspace (obligatorio).
  • create_workspace: Crear un espacio de trabajo para otra empresa para la que contratas y cambiar a él. Sus roles y lista de preseleccionados se mantienen separados de tus otros espacios de trabajo. Parámetros: name (obligatorio).
  • list_workspace_members: Quién está en tu espacio de trabajo actual (o workspace), con su rol (owner o member) y, si lo posees, las invitaciones aún abiertas. Parámetros: workspace.
  • invite_to_workspace: Invitar a un compañero por correo a un espacio de trabajo que posees (no tu Personal): recibe un correo de AyHire con un enlace, inicia sesión con esa dirección y se une, luego ve sus roles, selecciones y lista de preseleccionados. El enlace también se devuelve para que puedas compartirlo de otra manera; funciona durante 7 días. Pasa send_email=false para obtener solo el enlace. Invitar a la misma dirección de nuevo envía un enlace nuevo. Parámetros: email (obligatorio), workspace, role, send_email.

Tarjetas en el chat

En las aplicaciones que muestran MCP Apps (Claude, ChatGPT, VS Code), score_role_person, analyze_github_user, get_role y get_shortlist también dibujan una pequeña tarjeta: la persona o las llamadas clasificadas, con enlaces. La respuesta de texto es la misma en todas partes; la tarjeta es un extra. Viaja en los metadatos del resultado, que la especificación de MCP Apps dice que no son para el modelo.

Cómo usar bien las herramientas

  • Para buscar personas: find_people_behind_repos primero, luego analyze_github_user solo en las pocas que valga la pena examinar de cerca.
  • enrich_person y check_availability gastan un saldo pagado; úsalos en personas que se estén considerando seriamente.
  • Presenta los datos de contacto con su fuente. Un LinkedIn con confianza "guess" fue emparejado por nombre y empresa y puede ser la persona equivocada; dilo.
  • Los resultados guardados de los últimos 30 días son gratuitos. Los nuevos análisis están limitados a 20 por hora.