Skip to main content
Glama
cydgxbriel

hr-agent-mcp

by cydgxbriel

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
APP_PASSWORDNoOptional password to protect the Streamlit app when deployed publicly
GCP_PROJECT_IDNoGoogle Cloud Project ID for BigQuery (optional)
OPENAI_API_KEYYesOpenAI API key for the LLM
GCP_SERVICE_ACCOUNT_JSONNoContent of the GCP service account JSON key (for cloud deployment)
GOOGLE_APPLICATION_CREDENTIALSNoPath 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

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
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

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A4.4/5.0

Scored across 5 tools

Disambiguation5/5

Each tool targets a distinct aspect: aggregate analytics, individual punch queries, policy lookup, listing adjustments, and approving adjustments. There is no functional overlap.

Naming Consistency4/5

All names follow snake_case and imperative verb_noun pattern, but 'analytics_rh' mixes English verb with Portuguese noun, while others are fully Portuguese.

Tool Count5/5

Five tools cover the core HR agent tasks concisely without being too sparse or overwhelming. The count fits the scope well.

Completeness4/5

Covers analytics, individual queries, policy lookup, and adjustment workflow (list and approve). Missing a reject action for adjustments but otherwise complete for manager tasks.

Maintenance

ActivitySlowing
ResponsivenessNo issues