---
title: "annotations list"
description: "List schema annotations"
canonical: "https://pgbeam.com/docs/cli/annotations/list"
last-updated: "2026-09-13T16:16:22.000Z"
---

# annotations list

> List schema annotations

URL: https://pgbeam.com/docs/cli/annotations/list

Lists the project's human-written table and column descriptions. These are surfaced to connected agents through the MCP schema catalog.

## Usage

## Options

Option

Description

Required

Default

`--limit <value>`

Maximum number of items (1-100)

No

-

`--all`

Fetch every page

No

-

All global options (`--token`, `--profile`,
`--project`, `--org`, `--json`, `--no-color`, `--no-trunc`, `--debug`) are
also available on this command.

## Examples

## Output

Renders a human-readable table or detail view by default; pass `--json` for the raw API response.