> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ezforge.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# ezforge logs

> Stream logs from a deployed MCP server

## Usage

```bash theme={null}
ezforge logs <server-name> [flags]
```

Streams real-time logs from the server via Server-Sent Events.

## Flags

| Flag              | Description                                                                  |
| ----------------- | ---------------------------------------------------------------------------- |
| `--level <level>` | Filter by log level: `debug`, `info`, `warn`, `error`                        |
| `--since <time>`  | Show logs since a specific time (e.g., `1h`, `30m`, `2026-01-15T10:00:00Z`)  |
| `--lines <n>`     | Number of historical lines to show before streaming live logs (default: 100) |
| `--no-follow`     | Print historical logs and exit (don't stream)                                |
| `--project <id>`  | Target project                                                               |

## Examples

**Stream all logs:**

```bash theme={null}
ezforge logs my-server
```

**Show only errors:**

```bash theme={null}
ezforge logs my-server --level error
```

**Show logs from the last hour:**

```bash theme={null}
ezforge logs my-server --since 1h
```

**Print last 50 lines and exit:**

```bash theme={null}
ezforge logs my-server --lines 50 --no-follow
```

## Output format

```
2026-01-15T12:00:00Z  INFO   MCP server listening on port 8080
2026-01-15T12:00:01Z  INFO   Tool called: get_weather {"city":"chicago"}
2026-01-15T12:00:01Z  INFO   Tool response: chicago: 22°C, partly cloudy
2026-01-15T12:01:33Z  WARN   Slow tool execution: get_weather (1234ms)
```
