# CLI: public datasets and support

Source: https://mostlyright.md/docs/reference/cli/public/

## Discover without signing in

```sh
mr-data public search "weather" --limit 10 --json
mr-data public show DATASET_SLUG --json
mr-data public tables DATASET_SLUG --json
mr-data public schema PUBLIC_TABLE_ID --json
mr-data public sample PUBLIC_TABLE_ID --json
mr-data public fetch DATASET_SLUG --json
```

`search` finds published datasets, `show` reads an overview, `tables` returns table identifiers, `schema` describes columns, and `sample` reads published preview rows. `fetch` returns the dataset's Markdown. `lookup "QUERY"` returns the connector search shape. These seven commands need no login.

Use `--topic`, `--limit` and `--cursor` with catalog search. A catalog match does not mean a row matched: use [`search query`](/docs/reference/cli/search/) to search inside a table. A preview is a sample, not the complete dataset.

## Read with your workspace

```sh
mr-data login
mr-data public query PUBLIC_TABLE_ID --body-file query.json --json
mr-data public download-url PUBLIC_TABLE_ID --json
```

`query.json` uses the [Public Dataset API query grammar](/docs/reference/public-dataset-api/). Inline JSON can be passed with `--body` instead. `download-url` returns download instructions; it does not stream table bytes through the CLI. Treat returned authorized URLs as credentials.

## Connect a dataset

```sh
mr-data connected list --json
mr-data connected add DATASET_SLUG --json
```

Both use the active workspace and require login. `add` changes the workspace's connected dataset list; it does not copy or rebuild the dataset.

## Ask for support

```sh
mr-data ask "Why did this run fail?" --run RUN_ID --json
mr-data ask "What does this refusal mean?" --failure-code CODE --no-wait --json
mr-data ask status QUESTION_ID --json
```

The support agent must be enabled for the workspace. `THIN_CLOUD_SUPPORT_AGENT_DISABLED` is a final refusal, not a reason to keep retrying. The agent may file a problem and return an `SR-N` reference. Keep that reference with the run ID when reporting a platform fault.