hr-agent-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| APP_PASSWORD | No | Optional password to protect the Streamlit app when deployed publicly | |
| GCP_PROJECT_ID | No | Google Cloud Project ID for BigQuery (optional) | |
| OPENAI_API_KEY | Yes | OpenAI API key for the LLM | |
| GCP_SERVICE_ACCOUNT_JSON | No | Content of the GCP service account JSON key (for cloud deployment) | |
| GOOGLE_APPLICATION_CREDENTIALS | No | Path to the GCP service account JSON key file (for local use) |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| consultar_batidasA | Consulta as batidas de ponto de um colaborador da equipe num período. Use para perguntas sobre horários, atrasos, horas extras ou batidas faltantes de uma pessoa específica. Aceita nome parcial (ex.: 'Bruno'). Datas no formato YYYY-MM-DD. O período dos dados vai de maio a julho de 2026. |
| listar_ajustes_pendentesA | Lista os ajustes de ponto aguardando aprovação da gestora. Use quando a gestora perguntar o que está pendente, o que precisa aprovar, ou pedir a fila de ajustes. Retorna id, colaborador, data, campo a corrigir, valor proposto e motivo. |
| aprovar_ajusteA | Aprova um ajuste de ponto pendente. AÇÃO DE ESCRITA com auditoria. Use somente quando a gestora pedir explicitamente para aprovar um ajuste. Exige o id do ajuste (veja listar_ajustes_pendentes) e uma justificativa. A aprovação corrige a batida e registra na trilha de auditoria. |
| consultar_politicaA | Busca trechos relevantes das políticas internas de RH (RAG). Use para dúvidas sobre regras: tolerância de atraso, banco de horas, ajuste de batida, home office, advertências. Retorna trechos literais com a fonte; responda com base neles, citando a política. |
| analytics_rhA | Executa uma consulta analítica SELECT no data warehouse (BigQuery). Use para perguntas agregadas sobre a equipe: total de horas extras por mês, evolução de atrasos, batidas incompletas por equipe. Escreva SQL padrão BigQuery usando exclusivamente esta tabela: rh_analytics.agregados_mensais — colunas: equipe STRING (Produto, Engenharia, Comercial), mes STRING 'YYYY-MM', total_atraso_minutos INT64, total_hora_extra_minutos INT64, batidas_incompletas INT64, colaboradores INT64. Somente SELECT é aceito; a consulta passa por validação de governança. Não use WITH/CTE, ponto e vírgula nem comentários — apenas um SELECT direto. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 5 tools
Each tool targets a distinct aspect: aggregate analytics, individual punch queries, policy lookup, listing adjustments, and approving adjustments. There is no functional overlap.
All names follow snake_case and imperative verb_noun pattern, but 'analytics_rh' mixes English verb with Portuguese noun, while others are fully Portuguese.
Five tools cover the core HR agent tasks concisely without being too sparse or overwhelming. The count fits the scope well.
Covers analytics, individual queries, policy lookup, and adjustment workflow (list and approve). Missing a reject action for adjustments but otherwise complete for manager tasks.