# Ferramentas utilitárias (time, calc, random)
SUMMARY: Endpoints utilitários públicos — hora do servidor, calculadora segura, gerador de valores aleatórios. Sem auth necessária.

KEY CONTEXT:
No auth required for any /tools/* endpoint.
GET /tools/time → { time, timezone, offset }
GET /tools/calc?expr=(10+5)*3 → { result, expr } (safe, no eval, arithmetic only)
GET /tools/random?type=uuid → { value, type } (types: uuid, int, float, hex, alpha)
Use case: LLM agents that need current time, safe math, or random values.

Ferramentas utilitárias
Os endpoints  são utilitários públicos — sem autenticação necessária.
São úteis para agentes LLM que precisam de hora do servidor, matemática segura
ou valores aleatórios.
GET /tools/time
Obtém a hora atual do servidor, fuso horário e offset UTC.
[CODE BLOCK]
Resposta:
[CODE BLOCK]
Caso de uso: agentes LLM que precisam saber "que horas são agora" para
agendamento, timestamps ou cálculos de datas relativas.
GET /tools/calc
Calculadora segura — apenas aritmética, sem . Suporta , , ,
, , ,  e números.
[CODE BLOCK]
Resposta:
[CODE BLOCK]
> [!TIP]
> Use isso em vez de tentar fazer matemática mentalmente ou via parsing de
> strings. É seguro (sem possibilidade de injeção de código) e preciso.
Operadores suportados
-  adição
-  subtração
-  multiplicação
-  divisão
-  módulo
-   parênteses
- Números (inteiros e decimais)
Exemplos
[CODE BLOCK]
GET /tools/random
Gera valores aleatórios.
[CODE BLOCK]
Parâmetros por tipo
| Tipo | Parâmetros | Saída |
|------|-----------|-------|
|  | nenhum | String UUID v4 |
|  | ,  (padrão 0-100) | Inteiro |
|  | ,  (padrão 0-100) | Float |
|  | ,  (intervalo de comprimento, padrão 8-16) | String hex |
|  | ,  (intervalo de comprimento, padrão 8-16) | String alfabética |
Casos de uso para agentes LLM
Gerar IDs únicos
[CODE BLOCK]
Calcular porcentagens
[CODE BLOCK]
Obter timestamp atual
[CODE BLOCK]
Gerar dados de teste
[CODE BLOCK]
Próximos passos
- Visão geral da API — todos os grupos de endpoints
- Erros e tratamento de erros