AyHire

Contrate engenheiros pelo que eles entregaram. Descreva uma vaga e a AyHire encontra desenvolvedores a partir do trabalho público deles no GitHub, avalia cada um de acordo com seus critérios com links para as evidências, indica quem está aberto a oportunidades e mantém suas vagas e lista de selecionados. Servidor remoto com login via OAuth.

Ver em ayhire.com

Servidor MCP hospedado

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

Instala no Claude Code, Codex, Cursor e outros

Documentação

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

AyHire para agentes

A maioria dos aplicativos de IA se conecta ao endereço da AyHire, https://ayhire.com/mcp, e a um login: sem chave para copiar. Agentes que podem executar comandos podem colar um prompt, e scripts podem usar a API HTTP com uma chave.

Conectar por endereço (login, sem chave)

Endereço da AyHire: https://ayhire.com/mcp. Cole no seu aplicativo de IA e faça login quando a AyHire abrir. https://ayhire.com/mcp e https://ayhire.com/api/mcp são o mesmo servidor.

Claude (web, desktop e mobile)

Adicione a AyHire como um conector personalizado uma vez. Ele funciona na web, no aplicativo desktop e no celular.

  1. No Claude, abra Personalizar › Conectores, clique em + Adicionar e depois em Adicionar conector personalizado.
  2. Nomeie como AyHire, cole isto como URL do servidor e clique em Continuar. 
    https://ayhire.com/mcp
  3. Se o Claude mostrar as configurações de login que encontrou, clique em Continuar. Em Autenticação, escolha Entrar agora. Em Cliente OAuth, escolha Registrar automaticamente. Depois clique em Adicionar.
  4. A AyHire abre. Faça login, escolha o workspace que ela deve usar e clique em Conectar.
  5. Em um chat, clique em + › Conectores e ative AyHire.

Verifique se funcionou: Pergunte ao Claude: "Use a AyHire para verificar quem sou eu conectado." Ele responde com seu e-mail.

Para desconectar: Peça ao Claude para desconectar a AyHire, ou desconecte-a na AyHire em Integrações › Aplicativos conectados. Para removê-la também do Claude: Personalizar › Conectores › AyHire › Remover.

  • Em um plano Team ou Enterprise, um proprietário adiciona primeiro: Configurações da organização › Conectores › Adicionar › Personalizado › Web. Depois cada pessoa clica em Conectar.
  • O plano gratuito permite um conector personalizado.
  • Se a sua janela mostrar Configurações avançadas em vez dessas opções, deixe o ID do cliente OAuth vazio.

Etapas verificadas em Central de Ajuda do Claude: conectores personalizados, Documentação do Claude: conectores fora do diretório e Documentação do Claude: autenticação de conectores em 15 de outubro de 2026. Ainda não testado manualmente com a AyHire. Não verificado: se o Claude escolhe "Registrar automaticamente" por conta própria para um servidor como a AyHire. As telas exatas nos planos Team e Enterprise.

ChatGPT

Adicione a AyHire como um servidor MCP personalizado em chatgpt.com.

  1. Vá para Plugins do ChatGPT, clique em + e depois em Adicionar servidor MCP personalizado.
  2. Nomeie como AyHire e cole isto como URL do servidor. 
    https://ayhire.com/mcp
  3. Para autenticação, escolha OAuth. Se perguntar como o ChatGPT deve registrar, escolha registro dinâmico.
  4. Clique em Entendo e quero continuar, depois em Criar como plugin e instale-o nos seus plugins pessoais.
  5. Na primeira vez que for usado, a AyHire abre: faça login, escolha um workspace e clique em Conectar.
  6. Em um chat, digite @ e escolha AyHire.

Verifique se funcionou: Pergunte: "@AyHire quem sou eu conectado?" Ele responde com seu e-mail.

Para desconectar: Peça ao ChatGPT para desconectar a AyHire, ou desconecte-a na AyHire em Integrações › Aplicativos conectados. Depois remova o plugin nas configurações de plugins do ChatGPT.

  • Não vê Adicionar servidor MCP personalizado? Ative o Modo desenvolvedor nas configurações do ChatGPT. Em uma conta de trabalho, seu administrador pode precisar permitir.
  • O ChatGPT pergunta antes da maioria das buscas da AyHire, novas análises e qualquer coisa que mude um papel ou uma observação. Ler evidências, seus papéis, sua lista de candidatos e sua lista de observação é feito imediatamente.
  • Servidores MCP personalizados funcionam no site do ChatGPT. As regras do seu workspace podem desativá-los.

Etapas verificadas em OpenAI: Adicionar servidor MCP personalizado, OpenAI: Autenticação e OpenAI: Guia rápido de plugins em 15 de outubro de 2026. Ainda não testado manualmente com a AyHire. Não verificado: se o Modo desenvolvedor ainda é necessário, onde fica o interruptor e quais planos o têm. O nome exato da opção de registro. Se a AyHire funciona fora de chats Work. Se o ChatGPT pede para você entrar na AyHire por conta própria e quando: a documentação da OpenAI descreve um sinal de login que a AyHire ainda não envia.

Claude Code

Um comando, depois login.

  1. Execute isto no seu terminal: 
    claude mcp add --transport http --scope user ayhire https://ayhire.com/mcp
  2. Faça login: execute claude mcp login ayhire, ou digite /mcp no Claude Code, escolha ayhire e siga o navegador. 
    claude mcp login ayhire
  3. A AyHire abre no seu navegador. Faça login, escolha um workspace e clique em Conectar.

Verifique se funcionou: claude mcp list mostra ayhire como Conectado. Ou pergunte ao Claude: "Use a AyHire para verificar quem sou eu conectado."

Para desconectar: Peça ao Claude para desconectar a AyHire, depois execute claude mcp remove --scope user ayhire. (claude mcp logout ayhire apenas esquece o login neste computador.)

  • Já configurou com o prompt de configuração da AyHire? Então a AyHire está conectada: pule isto. Para fazer login, peça ao Claude para desconectar a AyHire e execute claude mcp remove --scope user ayhire primeiro.
  • Usando o plugin da AyHire? Ele conecta com sua própria chave: pule isto. Para fazer login, peça ao Claude para desconectar a AyHire e execute /plugin uninstall ayhire@ayhire primeiro. As habilidades dele vão junto.
  • --scope user torna a AyHire disponível em todos os projetos.

Etapas verificadas em Documentação do Claude Code: MCP em 15 de outubro de 2026. Ainda não testado manualmente com a AyHire.

Codex

Um comando para adicionar a AyHire, um para fazer login.

  1. Execute: 
    codex mcp add ayhire --url https://ayhire.com/mcp
  2. Depois faça login: 
    codex mcp login ayhire
  3. A AyHire abre no seu navegador. Faça login, escolha um workspace e clique em Conectar.

Verifique se funcionou: Digite /mcp no Codex: ayhire está listado com suas ferramentas.

Para desconectar: Peça ao Codex para desconectar a AyHire. Depois remova-a do Codex (codex mcp --help lista o comando).

  • Já configurou com o prompt de configuração da AyHire? Então a AyHire está conectada: pule isto.
  • O Codex mantém a AyHire em ~/.codex/config.toml.

Etapas verificadas em Documentação do Codex: MCP em 15 de outubro de 2026. Ainda não testado manualmente com a AyHire. Não verificado: como sair ou remover um servidor no Codex: a página MCP dele não diz. Se "codex mcp login" abre seu navegador por conta própria: a página MCP dele não diz.

Cursor

Adicione o endereço da AyHire ao arquivo de configurações do Cursor e depois faça login.

  1. Abra ~/.cursor/mcp.json (crie se estiver faltando) e adicione a AyHire. Se o arquivo já listar servidores, adicione a entrada ayhire dentro de mcpServers. 
    {
  "mcpServers": {
    "ayhire": { "url": "https://ayhire.com/mcp" }
  }
}
  2. Reinicie o Cursor.
  3. Abra Personalizar › MCPs e faça login em ayhire quando o Cursor pedir. A AyHire abre: faça login, escolha um workspace e clique em Conectar.

Verifique se funcionou: Em Personalizar › MCPs, ayhire está ativo e lista suas ferramentas.

Para desconectar: Peça ao agente do Cursor para desconectar a AyHire, depois remova ayhire em Personalizar › MCPs (ou de mcp.json).

  • Já configurou com o prompt de configuração da AyHire? Então a AyHire está conectada: pule isto.
  • O Cursor recebe o login na porta 8787 do seu computador. Mantenha essa porta livre enquanto conecta.

Etapas verificadas em Documentação do Cursor: MCP e Ajuda do Cursor: MCP em 15 de outubro de 2026. Ainda não testado manualmente com a AyHire. Não verificado: o rótulo do botão de login do Cursor para um servidor adicionado em mcp.json.

VS Code (GitHub Copilot)

Adicione a AyHire como um servidor HTTP e depois permita o login.

  1. Abra a Paleta de Comandos e execute MCP: Adicionar Servidor.
  2. Escolha HTTP, cole este endereço, nomeie como ayhire e salve em Copilot Global para que todos os projetos tenham. 
    https://ayhire.com/mcp
  3. Ou adicione manualmente em ~/.copilot/mcp-config.json (crie se estiver faltando). Se o arquivo já listar servidores, adicione a entrada ayhire dentro de mcpServers. 
    {
  "mcpServers": {
    "ayhire": {
      "type": "http",
      "url": "https://ayhire.com/mcp"
    }
  }
}
  4. Inicie o servidor quando o VS Code pedir e permita o login. A AyHire abre: faça login, escolha um workspace e clique em Conectar.

Verifique se funcionou: Execute MCP: Listar Servidores: ayhire está em execução. No modo agente do Copilot Chat, suas ferramentas estão listadas.

Para desconectar: Peça ao Copilot para desconectar a AyHire, depois execute MCP: Listar Servidores, escolha ayhire e remova.

  • Já configurou com o prompt de configuração da AyHire? Isso adicionou a AyHire apenas ao .vscode/mcp.json de um projeto. Estas etapas adicionam a todos os projetos.
  • Se você definir COPILOT_HOME, o arquivo está nessa pasta em vez de ~/.copilot.

Etapas verificadas em Documentação do VS Code: servidores MCP em 15 de outubro de 2026. Ainda não testado manualmente com a AyHire. Não verificado: o prompt de login do VS Code e como sair de um servidor: a página MCP dele não descreve.

Gemini CLI

Um comando, depois login pelo Gemini CLI.

  1. Execute: 
    gemini mcp add --transport http --scope user ayhire https://ayhire.com/mcp
  2. Inicie o Gemini CLI e faça login: 
    /mcp auth ayhire
  3. A AyHire abre no seu navegador. Faça login, escolha um workspace e clique em Conectar.

Verifique se funcionou: Digite /mcp no Gemini CLI: ayhire está listado com suas ferramentas.

Para desconectar: Peça ao Gemini para desconectar a AyHire primeiro, depois execute gemini mcp remove --scope user ayhire.

  • Já configurou com o prompt de configuração da AyHire? Então a AyHire está conectada: pule isto.
  • Sem --scope user, o Gemini CLI adiciona a AyHire apenas ao projeto atual.

Etapas verificadas em Documentação do Gemini CLI: servidores MCP em 15 de outubro de 2026. Ainda não testado manualmente com a AyHire. Não verificado: se remover o servidor também exclui o login salvo do Gemini (ele mantém tokens em ~/.gemini/mcp-oauth-tokens.json).

Configurar com um prompt (agentes que executam comandos)

Cole isto no Claude Code, Codex, Cursor ou qualquer agente que possa executar comandos:

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

As etapas que ele segue: https://ayhire.com/setup.md. A chave vai do navegador direto para um arquivo nesse computador e nunca aparece no chat.

Plugin do Claude Code

Com acesso ao repositório da AyHire, o plugin faz o mesmo que o prompt:

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

Qualquer agente MCP

Agentes que suportam login MCP abrem a AyHire no navegador na primeira vez:

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

Ou com uma chave de API da AyHire:

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

Crie uma chave em https://ayhire.com/app/integrations#keys após fazer login. x-api-key: YOUR_AYHIRE_API_KEY funciona tão bem quanto o cabeçalho Authorization. https://ayhire.com/mcp e https://ayhire.com/api/mcp são o mesmo servidor.

Linha de comando

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

Sair

Peça ao seu agente para desconectar a AyHire (a ferramenta disconnect), ou execute ayhire logout. Qualquer um encerra o acesso no lado da AyHire imediatamente. Excluir ~/.config/ayhire/credentials.json manualmente não: a chave continua funcionando até ser revogada. Chaves e aplicativos conectados também podem ser revogados em 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"}'

As rotas principais (analisar, buscar, candidatos, listas de candidatos), com formatos de requisição e resposta: https://ayhire.com/api/docs. As ferramentas MCP acima cobrem o resto.

Ferramentas

  • whoami: Verifique se o AyHire está conectado e qual conta está chamando. Chame isso primeiro ao configurar ou quando outras ferramentas do AyHire falharem com erro de autenticação.
  • disconnect: Encerre a conexão deste agente com o AyHire: a chave ou login que ele usa para de funcionar imediatamente, no lado do AyHire. Use apenas quando o usuário pedir para sair, deslogar, desconectar, remover ou esquecer o AyHire aqui. O site do AyHire permanece conectado; outros agentes permanecem conectados, a menos que usem a mesma chave. Depois disso, as ferramentas do AyHire param de funcionar neste agente: não tente entrar novamente, a menos que o usuário peça para reconectar.
  • analyze_github_user: Para alguém em uma função, use score_role_person em vez disso (também avalia a pessoa contra os critérios da função). Avalie o trabalho público de um usuário do GitHub em 4 dimensões gerais (technical_depth, shipping_velocity, communication, gem_score; 0-10 cada, total de 40) com descobertas (o que o trabalho mostra) e bandeiras vermelhas, cada uma com os links do GitHub em que se baseia (afirmações sem fonte são descartadas), e principais habilidades. A análise lê os próprios repositórios e o trabalho em projetos de outras pessoas (outside_work: commits e PRs por repositório, último ano). As pontuações são gerais: nenhuma é julgada contra uma função, e onde a pessoa mora nunca é usado. Retorna um resultado salvo se o usuário foi analisado nos últimos 30 dias (grátis, cached=true); caso contrário, faz scraping, pontua e salva (leva 15-25s). Também retorna activity: o calendário de contribuições do GitHub da pessoa no último ano, resumido (total, semanas ativas, sequências, mês mais movimentado, última atividade; null quando o GitHub não tem nenhum). Defina refresh=true apenas quando o usuário pedir uma análise nova. Parâmetros: username (obrigatório), refresh, persist.
  • analyze_github_users: Analise até 25 usuários do GitHub em uma chamada e receba-os classificados, melhor total primeiro (totais de 40), cada um com as quatro pontuações gerais, um resumo, principais habilidades e bandeiras vermelhas. Análises salvas dos últimos 30 dias são grátis e instantâneas. Até 4 novas análises começam por chamada (cerca de 20-35 s juntas); qualquer outro retorna em pending: chame novamente com esses. Novas análises contam para o limite horário (20); quando esgotado, o restante retorna em limited com limit_resets_at (sem plano: limit_reason diz isso). Use para comparar uma lista curta ou para pontuar as pessoas que find_people_behind_repos retornou. Parâmetros: usernames (obrigatório).
  • score_candidate: Para alguém em uma função, use score_role_person em vez disso (também avalia a pessoa contra os critérios da função). Versão leve de analyze_github_user que nunca grava no banco de dados. Usa um resultado salvo se estiver recente; caso contrário, faz scraping e pontua sem salvar. Parâmetros: username (obrigatório), refresh.
  • find_people_behind_repos: Encontre os desenvolvedores que constroem projetos de código aberto: pesquisa no GitHub por repositórios (mais estrelas primeiro) que correspondem a uma consulta, tópico ou linguagem, depois lista as pessoas que mais contribuíram para eles, classificadas por quantos desses repositórios constroem e quanto contribuíram. Bots e agentes de IA de codificação são excluídos. Passe repo ('owner/name') para as pessoas por trás de um projeto exato, ou org ('vercel') para as pessoas por trás dos repositórios de uma organização (cada pessoa tem public_member; false apenas significa que não é mostrado como membro). Minerar vários repositórios-semente um após o outro é muitas vezes a melhor maneira de encontrar pessoas fortes. location mantém pessoas cuja localização no GitHub está em um dos lugares, além de pessoas que não listam localização, marcadas location_match: 'unknown' (unknown nunca é uma incompatibilidade; location_unknown: 'exclude' as deixa de fora). page lê o próximo conjunto de repositórios. Com role_id, pessoas que a função já viu são deixadas de fora (a menos que include_seen) e a busca vai para o histórico da função. Grátis (somente 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: Pesquise perfis do GitHub: palavras comparadas com nome, login e bio (ex.: 'rust database', 'GTM engineer', 'AI adoption'; o GitHub exige que cada palavra corresponda, então use de uma a três), uma localização (uma cidade, um país ou uma região como Europa), linguagem dos repositórios, mínimo de seguidores ou repositórios. Cada pessoa retorna com bio, localização, empresa, seguidores, o sinalizador hireable e seus 3 principais repositórios próprios. Bom para funções onde perfis dizem mais que repositórios, e para uma restrição de localização; para engenheiros, minerar os contribuidores de repositórios-semente (find_people_behind_repos) é muitas vezes mais forte. Retorna a consulta exata executada e o total; passe next_cursor como cursor para mais. Com role_id, pessoas que a função já viu são deixadas de fora (a menos que include_seen) e a busca vai para o histórico da função. Grátis. Parâmetros: query, location, language, min_followers, min_repos, sort, cursor, limit, role_id, include_seen.
  • search_repos: Pesquise repositórios do GitHub por palavras, tópico, linguagem, organização proprietária, estrelas e datas, mais estrelas (ou atualizados mais recentemente) primeiro, 30 por página, cada um com descrição, estrelas, tópicos, tipo de proprietário e datas. Use para encontrar listas-semente (awesome lists, diretórios de comunidade), os projetos em que uma função trabalharia, ou repositórios pequenos e sérios (sem piso de estrelas por padrão), depois mine as pessoas com find_people_behind_repos(repo=...). Pesquisas por tópico são geralmente mais limpas que palavras-chave; cada palavra deve corresponder, então use poucas. Retorna a consulta exata executada. Grátis. Parâmetros: query, topic, language, org, min_stars, created_after, pushed_after, sort, page.
  • search_commits: Encontre quem realmente escreveu commits que correspondem a algumas palavras, ex.: 'smartlead webhook', 'hubspot sync', 'mvcc snapshot isolation', opcionalmente dentro de um repositório ou organização. As pessoas retornam agrupadas, mais commits correspondentes primeiro, com até 3 exemplos de commits cada (repositório, assunto, dia UTC, link) e em quantos repositórios seus commits correspondentes estão. Commits em forks são ignorados (contados como in_forks) a menos que você nomeie o repositório. Bom para encontrar profissionais cujo trabalho está espalhado por muitos repositórios pequenos. Commits cujo e-mail não está vinculado a uma conta GitHub são apenas contados (unattributed). Com role_id, pessoas que a função já viu são deixadas de fora (a menos que include_seen) e a busca vai para o histórico da função. Grátis; usa a busca do GitHub (cerca de 30 por minuto). Parâmetros: query (obrigatório), repo, org, page, role_id, include_seen.
  • get_person_evidence: Tudo o que um recrutador clicaria no GitHub para avaliar alguém, em uma chamada, cada item com seu link: perfil e README do perfil, repositórios (código, prosa como playbooks e listas, ou forks) com descrições, como trabalharam em seus principais repositórios (commits, dias ativos, quantos feitos com agente de IA de codificação), trabalho em projetos de outras pessoas a partir do gráfico de contribuições (último ano), pull requests abertos para outros repositórios (agrupados, contagens de merge, títulos), organizações, atividade mês a mês e, com role_id, os repositórios pelos quais a busca da função os encontrou e seu histórico lá. Leia ao vivo do GitHub, grátis, cerca de 5 s. Use para verificar uma afirmação ou julgar adequação você mesmo; unknown lista o que o GitHub não pôde mostrar desta vez (unknown não é uma fraqueza). Compacto por padrão (apenas repositórios próprios, forks contados; listas mais curtas); detail: 'full' para tudo. READMEs inteiros: read_readme. Todos os PRs ou commits: list_pull_requests, list_commits. Parâmetros: username (obrigatório), role_id, detail.
  • read_readme: O README inteiro de qualquer repositório público do GitHub (até 30.000 caracteres, com truncated=true além disso), com seu link. Leia o trabalho em si antes de julgá-lo: o que o projeto faz, quão sério é, quão bem é explicado. Grátis. Parâmetros: repo (obrigatório).
  • contribution_profile: O que um desenvolvedor realmente fez em um repositório, em uma chamada: pull requests mesclados (contagem, primeiro e último, os 10 mais recentes com tamanho e links), as áreas de código que esses PRs tocaram (ex.: core/mvcc 22, core/translate 9), PRs ainda abertos, PRs de outros que revisaram, seus commits lá (captura pessoas que commitam diretamente) e sua classificação entre os contribuidores. Use para verificar uma afirmação como 'contribuidor principal do mecanismo de armazenamento' ou para ver a área real de alguém em um projeto grande. Grátis, ao vivo, cerca de 3 s. Parâmetros: username (obrigatório), repo (obrigatório).
  • list_pull_requests: Pull requests que um desenvolvedor abriu, mais recentes primeiro, 30 por página, cada um com repositório, título, link, estado, se foi mesclado e o início da descrição. Restrinja a um repositório ('owner/name') ou a um estado (open, closed, merged). Use para ver o que realmente mudaram em projetos que não possuem. Grátis; usa a busca do GitHub, que permite cerca de 30 buscas por minuto. Parâmetros: username (obrigatório), repo, state, page.
  • list_commits: Commits de um desenvolvedor em um repositório (deles ou de qualquer um), mais recentes primeiro, 30 por página: assunto, data, link, co-autores nomeados no commit e se foi feito com agente de IA de codificação. Use para ver o que fizeram em um projeto e como trabalham. Grátis. Parâmetros: username (obrigatório), repo (obrigatório), page.
  • enrich_person: Para um usuário do GitHub: URL do LinkedIn, título e empresas atuais, um e-mail de trabalho e o perfil X, com a fonte e confiança de cada um. Usa GitHub primeiro (grátis), depois buscas pagas (geralmente $0,001-0,015, até ~$0,03 com deep=true). Salvo e reutilizado por 30 dias (cached=true é grátis). Use em pessoas que o usuário está considerando seriamente, não em cada nome de uma lista. deep=true também busca na bio do X e por nome + empresa. Parâmetros: username (obrigatório), deep, find_email, refresh.
  • check_availability: Este usuário do GitHub já está empregado ou aberto a trabalho? Combina o cargo atual no LinkedIn, a empresa no perfil do GitHub e o sinalizador 'disponível para contratação' do GitHub. Retorna um veredito cauteloso (employed, employed_but_open, open_to_work, likely_employed, unknown) com as evidências. Executa as mesmas buscas que enrich_person (e as salva), então chamar ambos não custa nada extra. Parâmetros: username (obrigatório), deep.
  • search_candidates: Busca em linguagem natural sobre desenvolvedores que o AyHire já analisou (similaridade semântica mais classificação por pontuação), ex.: 'engenheiro backend sênior de Rust com experiência em sistemas distribuídos'. Só encontra pessoas analisadas antes; use analyze_github_user para adicionar alguém. Parâmetros: query (obrigatório), limit, threshold, filters.
  • list_roles: As funções (posições abertas) no seu workspace atual (ou workspace), mais recentes primeiro, cada uma com contagens de escolhidos, separados, ainda não vistos e pré-selecionados. Parâmetros: workspace.
  • create_role: Crie uma função (uma posição aberta) para buscar pessoas. O AyHire sugere seus critérios a partir do título e resumo (o que a função precisa, cada um com uma importância: must, important ou nice; as pessoas são julgadas contra eles) a menos que você passe criteria, e transforma o título e resumo em uma busca inicial no GitHub a menos que você passe query/language. A função vai para o seu workspace atual (ou workspace) e também aparece no aplicativo web do AyHire. Parâmetros: title (obrigatório), brief, query, language, created_after, criteria, workspace.
  • set_role_criteria: Substituir os critérios de uma função: o que a função precisa, cada item julgado a partir do trabalho público de alguém, com uma importância (obrigatório, importante ou opcional). Use as palavras do usuário; específico vence genérico ('Internos do mecanismo de armazenamento', não 'Engenheiro forte'). Pessoas avaliadas com os critérios antigos aparecem como desatualizadas até que score_role_person as avalie novamente. O aplicativo web mostra os mesmos critérios. Parâmetros: role_id (obrigatório), criteria (obrigatório).
  • suggest_role_criteria: Sugerir critérios para uma função a partir do título e da descrição, sem salvá-los: mostre-os ao usuário e depois salve com set_role_criteria (como estão ou alterados). Útil quando a descrição mudou ou os critérios atuais parecem inadequados. Parâmetros: role_id (obrigatório).
  • get_role: Uma função e todos nela, classificados: primeiros (pessoas avaliadas contra os critérios da função pela evidência de adequação, depois as demais pela força geral do trabalho público; ranking_basis indica qual), depois separados (evidência pública contra um requisito obrigatório), depois pessoas ainda não analisadas. Esta é a ordem final: chame após a pontuação. Cada pessoa tem a avaliação da AyHire (resumo, motivo em uma linha, algo para verificar), o veredito por critério com links, sua decisão, notas, disponibilidade e pontuação total. Compacto por padrão (motivos mais curtos, até 2 links por veredito, no máximo 25 pessoas ainda não analisadas); detalhe: 'full' para tudo. Use para responder 'com quem devo falar primeiro?'. Parâmetros: role_id (obrigatório), include, detail.
  • find_people_for_role: Executar a busca própria da função e salvar todos os encontrados na função. Uma função com um plano de busca (search_plan em get_role: a combinação da função, ferramentas e 3-6 buscas lidas da descrição) executa cada busca: repositórios sobre o trabalho, repositórios que usam as ferramentas, perfis que mencionam o cargo e os mantenedores das próprias ferramentas (mantidos separados como construtores). Cada busca é respondida primeiro pelo índice próprio da AyHire de pessoas e pesquisada ao vivo no GitHub apenas onde o índice é escasso ou mais antigo que um mês. Cada pessoa vem com why_found, fonte (índice ou GitHub agora) e relevância (adequação da área, similaridade da descrição, qualidade, feedback). Funções mais antigas executam uma busca: pessoas por trás dos principais repositórios que correspondem às palavras e ao idioma da função. Pessoas que a função já viu são deixadas de fora, então cada rodada traz novas pessoas (include_seen para trazê-las de volta); página 2 em diante lê os próximos repositórios. Retorna todos os encontrados com nome, empresa, localização, sinalizador 'hireable' do GitHub, seguidores, os repositórios correspondentes que constroem e quanto. Para escolher pessoas você mesmo, use as ferramentas de busca com role_id (search_people, find_people_behind_repos, search_commits) e add_people_to_role. Nada é pontuado ainda: chame score_role_person para as pessoas que valem uma análise mais próxima. Grátis (somente GitHub). Passe query/language para buscar de forma diferente desta vez. Parâmetros: role_id (obrigatório), query, language, page, location, location_unknown, include_seen.
  • add_people_to_role: Adicionar pessoas que você escolheu (de qualquer busca, ou que você conhece) a uma função, cada uma com um motivo em uma linha em palavras simples: por que se encaixam nesta função, a partir do trabalho delas (ex.: 'Escreveu a camada MVCC do turso: 103 PRs mesclados intitulados mvcc'). A função mantém o motivo e como foram encontradas, mostrados no aplicativo web e em get_role. Até 25 por vez. Pessoas já na função mantêm sua decisão e notas; um novo motivo substitui o antigo. Depois, score_role_person as pontua. Parâmetros: role_id (obrigatório), people (obrigatório), found_via.
  • score_role_person: Analisar uma pessoa (4 pontuações gerais, resumo, sinais de alerta; lê os próprios repositórios, o trabalho em projetos de outras pessoas e os repositórios pelos quais a busca da função a encontrou), julgá-la contra os critérios da função (cada veredito com links para as evidências; desconhecido nunca é negativo) e verificar se está disponível, depois retorná-la com a avaliação da AyHire e seu lugar entre as escolhas até agora. Alguém ainda não na função é adicionado primeiro (passe reason). Uma análise salva é gratuita e instantânea; uma nova leva 15-25 segundos e conta para o limite horário (20 análises), então pontue as pessoas que valem, não todas. A ordem muda conforme você pontua mais pessoas: chame get_role para a classificação final. Se uma chamada expirar, chame-a mais uma vez: quando a análise terminar nesse meio tempo, a nova tentativa é instantânea e gratuita. Parâmetros: role_id (obrigatório), username (obrigatório), reason.
  • decide: Registrar uma decisão sobre alguém em uma função: shortlisted, not_now ou none (desfazer). Opcionalmente, adicione uma nota. Decisões são compartilhadas com todos no espaço de trabalho da função. Pessoas na lista curta aparecem em get_shortlist e na Lista Curta do aplicativo web. Parâmetros: role_id (obrigatório), username (obrigatório), decision (obrigatório), note.
  • get_shortlist: Todos na lista curta do seu espaço de trabalho atual (ou workspace), em todas as suas funções (a mesma lista da Lista Curta do aplicativo web), mais recentes primeiro, com a avaliação da AyHire e as notas. Parâmetros: workspace.
  • watch_person: Observar alguém no seu espaço de trabalho atual (ou workspace), com ou sem função. Cerca de uma vez por dia, a AyHire reavalia o perfil público do GitHub e a atividade, e cada mudança sobre a qual você perguntou aparece em Início e em list_watches com o link onde foi vista. rules (padrão: all): open_to_work (o "disponível para contratação" do GitHub é ativado, ou bio/título do LinkedIn diz #OpenToWork), job_change (a empresa no perfil do GitHub muda; o empregador no LinkedIn quando a AyHire o lê), says_looking (bio/título diz procurando, buscando ou disponível para novo trabalho), new_work (atividade pública após 30+ dias de silêncio, um novo repositório público ou um lançamento). paid_checks=true também relê o LinkedIn a cada 14 dias quando a AyHire já o tem: uma consulta paga, cerca de $0,005 cada, dentro dos limites da AyHire. Pergunte ao usuário antes de ativar. As observações são compartilhadas com a equipe do espaço de trabalho. A AyHire não pode observar postagens (ex.: sobre sair de um emprego): ela não as lê. Parâmetros: username (obrigatório), rules, paid_checks, role_id, workspace.
  • unwatch_person: Parar de observar alguém no seu espaço de trabalho atual (ou workspace). As verificações diárias param para este espaço de trabalho. Parâmetros: username (obrigatório), workspace.
  • list_watches: Todos os observados no seu espaço de trabalho atual (ou workspace): para que serve cada observação, quando a AyHire verificou pela última vez e a mudança mais recente com seu link. O may_fit de cada observação lista funções abertas neste espaço de trabalho que a pessoa também pode se encaixar, a partir do índice da AyHire do trabalho público dela (sem modelo, nunca localização), com o motivo e seu link; added é true uma vez que ela está nessa função (não a adicione novamente). Adicione alguém com add_people_to_role. Parâmetros: workspace.
  • list_workspaces: Seus espaços de trabalho da AyHire e qual é o atual. Um espaço de trabalho contém funções e sua lista curta: um por empresa para a qual você contrata, compartilhado com a equipe dessa empresa. Cada conta tem um pessoal. Cada um mostra o domínio de e-mail da empresa e o logotipo quando tem um, e waiting_to_join lista espaços de trabalho aos quais você pediu para entrar que um proprietário ainda não permitiu.
  • switch_workspace: Tornar um dos seus espaços de trabalho o atual, para este agente e o aplicativo web. As ferramentas de função então listam e criam lá. Para agir em outro espaço de trabalho em uma única chamada, passe workspace para essa ferramenta. Parâmetros: workspace (obrigatório).
  • create_workspace: Criar um espaço de trabalho para outra empresa para a qual você contrata e mudar para ele. Suas funções e lista curta são mantidas separadas dos seus outros espaços de trabalho. Parâmetros: name (obrigatório).
  • list_workspace_members: Quem está no seu espaço de trabalho atual (ou workspace), com sua função (proprietário ou membro) e, se você o possui, os convites ainda abertos. Parâmetros: workspace.
  • invite_to_workspace: Convidar um colega por e-mail para um espaço de trabalho que você possui (não o seu Pessoal): ele recebe um e-mail da AyHire com um link, entra com esse endereço e se junta, depois vê as funções, escolhas e lista curta. O link também é retornado para você compartilhar de outra forma; funciona por 7 dias. Passe send_email=false para obter apenas o link. Convidar o mesmo endereço novamente envia um novo link. Parâmetros: email (obrigatório), workspace, role, send_email.

Cards no chat

Em apps que mostram MCP Apps (Claude, ChatGPT, VS Code), score_role_person, analyze_github_user, get_role e get_shortlist também desenham um pequeno card: a pessoa ou as chamadas ranqueadas, com links. A resposta em texto é a mesma em todos os lugares; o card é um extra. Ele viaja nos metadados do resultado, que a especificação do MCP Apps diz que não são para o modelo.

Como usar bem as ferramentas

  • Para encontrar pessoas: find_people_behind_repos primeiro, depois analyze_github_user apenas nas poucas que valem uma análise mais detalhada.
  • enrich_person e check_availability gastam um saldo pago; use-os em pessoas que estão sendo seriamente consideradas.
  • Apresente os dados de contato com sua fonte. Um LinkedIn com confiança "guess" foi correspondido por nome e empresa e pode ser a pessoa errada; diga isso.
  • Resultados salvos dos últimos 30 dias são gratuitos. Novas análises são limitadas a 20 por hora.