> ## Documentation Index
> Fetch the complete documentation index at: https://acm-aa28ebf6.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# superbox logs

> Print wrangler tail instructions for a deployed MCP server

The `logs` command prints instructions for streaming live logs from the SuperBox Cloudflare Worker. It does not stream logs directly - it outputs the `wrangler tail` command you should run.

## Usage

```bash theme={null}
superbox logs --name <server> [--follow|-f]
```

## Options

<ParamField path="--name" type="string" required>
  MCP server name. The command verifies the server exists in the R2 registry before printing instructions.
</ParamField>

<ParamField path="--follow" type="boolean" default={false}>
  Changes output mode. Shorthand: `-f`.
</ParamField>

## Behavior

| Mode                    | Output                                                                           |
| ----------------------- | -------------------------------------------------------------------------------- |
| Default (no `--follow`) | Prints both the `wrangler tail` CLI command **and** the Cloudflare dashboard URL |
| With `--follow`         | Prints only: `wrangler tail superbox-executor --format pretty`                   |

The command verifies the server exists in R2 via `s3.get_server(bucket, name)` and exits with an error if not found.

## Examples

```bash theme={null}
# Get instructions for weather-server
superbox logs --name weather-server
```

Example output (no `--follow`):

```
Logs for weather-server:

  CLI: wrangler tail superbox-executor --format pretty
  Dashboard: https://dash.cloudflare.com/<account>/workers/superbox-executor
```

```bash theme={null}
# Get the follow command
superbox logs --name weather-server --follow
```

Example output:

```
wrangler tail superbox-executor --format pretty
```

## Streaming logs with wrangler

Once you have the command, run it in a terminal:

```bash theme={null}
# Stream all Worker logs
wrangler tail superbox-executor --format pretty

# Filter to errors only
wrangler tail superbox-executor --status error

# JSON output (pipe to jq)
wrangler tail superbox-executor --format json | jq .
```

## Prerequisites

`wrangler` must be installed and authenticated:

```bash theme={null}
npm install -g wrangler
wrangler login
```

## Troubleshooting

* **Server not found**: Run `superbox search` to confirm the server name, then `superbox push` if it is missing.
* **wrangler: command not found**: Install with `npm install -g wrangler`.
* **Authentication error in wrangler**: Run `wrangler login` and complete the browser OAuth flow.