# Utility Tools (time, calc, random)
SUMMARY: Public utility endpoints — server time, safe calculator, random value generator. No auth required.

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.

Utility Tools
The  endpoints are public utilities — no authentication required.
They're useful for LLM agents that need server-side time, safe math, or random
values.
GET /tools/time
Get the current server time, timezone, and UTC offset.
[CODE BLOCK]
Response:
[CODE BLOCK]
Use case: LLM agents that need to know "what time is it now" for scheduling,
timestamps, or relative date calculations.
GET /tools/calc
Safe calculator — arithmetic only, no . Supports , , , ,
, , , and numbers.
[CODE BLOCK]
Response:
[CODE BLOCK]
> [!TIP]
> Use this instead of trying to do math in your head or via string parsing.
> It's safe (no code injection possible) and accurate.
Supported operators
-  addition
-  subtraction
-  multiplication
-  division
-  modulo
-   parentheses
- Numbers (integers and decimals)
Examples
[CODE BLOCK]
GET /tools/random
Generate random values.
[CODE BLOCK]
Type parameters
| Type | Parameters | Output |
|------|-----------|--------|
|  | none | UUID v4 string |
|  | ,  (default 0-100) | Integer |
|  | ,  (default 0-100) | Float |
|  | ,  (length range, default 8-16) | Hex string |
|  | ,  (length range, default 8-16) | Alphabetic string |
Use Cases for LLM Agents
Generate unique IDs
[CODE BLOCK]
Calculate percentages
[CODE BLOCK]
Get current timestamp
[CODE BLOCK]
Generate test data
[CODE BLOCK]
Next Steps
- API Overview — all endpoint groups
- Errors & Error Handling