Logging & Observability

The server automatically logs all tool calls to help with debugging and usage analysis.

Log Location

Logs are written to ~/.unblu-mcp/logs/ with daily rotation:

~/.unblu-mcp/logs/
├── unblu-mcp.log              # Current log
├── unblu-mcp.log.2025-01-14   # Yesterday
├── unblu-mcp.log.2025-01-13   # Day before
└── ...

Configuration

Environment Variable	Description
UNBLU_MCP_LOG_DIR	Custom log directory (default: ~/.unblu-mcp/logs)
UNBLU_MCP_LOG_DISABLE	Set to 1, true, or yes to disable file logging

Log Format

2025-01-15 14:30:22 | INFO     | fastmcp | tools/call request: call_api(operation_id="conversationsGetById", ...)

Logs include:

• Timestamp (UTC)
• Log level (DEBUG, INFO, WARNING, ERROR)
• Tool name and arguments
• Response summaries
• Request duration (duration_ms) for performance analysis

Retention

Logs are retained for 30 days and automatically rotated at midnight UTC.

Viewing Logs

macOS/Linux

# Follow logs in real-time
tail -f ~/.unblu-mcp/logs/unblu-mcp.log

# Search for errors
grep -i error ~/.unblu-mcp/logs/unblu-mcp.log

# View logs from a specific date
cat ~/.unblu-mcp/logs/unblu-mcp.log.2025-01-14

Windows

# View recent logs
Get-Content $env:USERPROFILE\.unblu-mcp\logs\unblu-mcp.log -Tail 100

# Follow logs in real-time
Get-Content $env:USERPROFILE\.unblu-mcp\logs\unblu-mcp.log -Wait

Feedback