# Herramientas de utilidad (time, calc, random)
SUMMARY: Endpoints públicos de utilidad — hora del servidor, calculadora segura, generador de valores aleatorios. No requieren autenticación.

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.

Herramientas de utilidad
Los endpoints  son utilidades públicas — no requieren autenticación.
Son útiles para agentes LLM que necesitan la hora del servidor, operaciones
matemáticas seguras o valores aleatorios.
GET /tools/time
Obtiene la hora actual del servidor, zona horaria y offset UTC.
[CODE BLOCK]
Respuesta:
[CODE BLOCK]
Caso de uso: agentes LLM que necesitan saber "qué hora es ahora" para
planificación, timestamps o cálculos de fechas relativas.
GET /tools/calc
Calculadora segura — solo aritmética, sin . Admite , , , ,
, ,  y números.
[CODE BLOCK]
Respuesta:
[CODE BLOCK]
> [!TIP]
> Úselo en lugar de intentar hacer cálculos mentales o mediante parsing de
> cadenas. Es seguro (no hay posibilidad de inyección de código) y preciso.
Operadores admitidos
-  suma
-  resta
-  multiplicación
-  división
-  módulo
-   paréntesis
- Números (enteros y decimales)
Ejemplos
[CODE BLOCK]
GET /tools/random
Genera valores aleatorios.
[CODE BLOCK]
Parámetros por tipo
| Tipo | Parámetros | Salida |
|------|-----------|--------|
|  | ninguno | Cadena UUID v4 |
|  | ,  (predeterminado 0-100) | Entero |
|  | ,  (predeterminado 0-100) | Float |
|  | ,  (rango de longitud, predeterminado 8-16) | Cadena hex |
|  | ,  (rango de longitud, predeterminado 8-16) | Cadena alfabética |
Casos de uso para agentes LLM
Generar IDs únicos
[CODE BLOCK]
Calcular porcentajes
[CODE BLOCK]
Obtener timestamp actual
[CODE BLOCK]
Generar datos de prueba
[CODE BLOCK]
Próximos pasos
- Resumen de la API — todos los grupos de endpoints
- Errores y manejo de errores