Recruta

Use this when the user asks what product help or actions are available to their connected account. Returns only the authenticated role, effective MCP scopes, stored permission matrix, and accessible guide IDs; it never grants access.

get_my_permissions

Use this after search_product_help when the user needs the complete deterministic procedure for one returned guide. Access is rechecked from the authenticated role and stored permissions.

get_product_guide

Candidatos da empresa (sem dados de saúde/laudo). Sem filtro = lista; `query` = busca por texto (nome/resumo); `job_id` = candidatos de uma vaga; `candidate_id` = detalhe de um candidato. A lista/busca retorna nome, skills, experiência e resumo; e-mail e telefone só no detalhe e quando a conta possui permissão PII efetiva.

list_candidates

Candidaturas (pipeline) de uma vaga, por etapa (status), sem dados de saúde. Passe `application_id` para o detalhe de uma candidatura. Paginação na listagem.

list_applications

Lista entrevistas (agenda) por vaga, candidato e/ou intervalo de datas. Paginação obrigatória.

list_interviews

Lista as vagas da empresa do usuário (isoladas por RLS). Filtros opcionais por status e por texto (título/descrição). Passe `job_id` para obter o DETALHE de uma vaga específica. Paginação na listagem.

list_jobs

Retorna a identidade do usuário conectado: empresa, papel e escopos concedidos ao conector. Útil para testar a conexão.

whoami

Ranqueia os candidatos de uma vaga por match_score (decrescente). Retorna posição, nome, score e etapa.

get_candidate_ranking

Métricas agregadas do pipeline (contagem por etapa e tempo médio na esteira). Não retorna candidatos individuais.

get_pipeline_summary

Use this when the user asks how to use Recruta or complete a product workflow. Returns at most three role-safe catalog guides and never returns the free-text query.

search_product_help