# `list_statements`

Reads current and removed statements for one person in your own Rolodex, or your own self statements. This resource contains capability statements. Private notes are appended through [`add_notes`](/docs/mcp/tools/add_notes), with pending notes included in person and self-profile reads. No source bodies, revision history, or derived readings are loaded.

Annotations: `readOnlyHint: true` · `destructiveHint: false` · `idempotentHint: true` · `openWorldHint: false`

## Inputs

| Input | Required | Description |
| --- | --- | --- |
| `personId` | yes | An owned person UUID, or null for self. |
| `pageSize` | no | Nonnegative integer. Default 20; zero uses the default; values above 100 cap at 100. |
| `pageToken` | no | Opaque continuation from the previous page. Omit or pass empty to start. |

## Returns

`{ personId, version, statements, nextPageToken }`. Each statement includes `id`, `personId`, `text`, `destination`, `state` (`active` or `removed`), `position`, nullable `scope` and `uncertainty`, `revision`, `createdAt`, and `updatedAt`. Preserve qualifiers when presenting them. Removed statements remain visible to prevent accidental restoration; only active statements inform effective profiles.

Results follow retained position, creation time, and ID. Only an empty `nextPageToken` establishes completion. Tokens are bound to the member and subject, expire after one hour, and become invalid if the subject changes between pages. Restart the list after invalidation. The implementation reads a complete subject snapshot before paging; it makes no database pagination performance guarantee.

The opaque subject version covers current and removed statements. A missing or unowned person returns the same `unavailable` error. Another member's match identity never authorizes reading their statements. Reads schedule no refresh or search.

## Example

```json list_statements
{
  "personId": "00000000-0000-4000-a000-000000000005"
}
```

Result (synthetic data):

```json result:list_statements
{
  "personId": "00000000-0000-4000-a000-000000000005",
  "version": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
  "statements": [
    {
      "id": "00000000-0000-4000-a000-000000000006",
      "personId": "00000000-0000-4000-a000-000000000005",
      "text": "Builds research software",
      "destination": "currentWork",
      "state": "active",
      "position": 0,
      "scope": null,
      "uncertainty": null,
      "revision": 1,
      "createdAt": "2026-10-21T00:00:00.000Z",
      "updatedAt": "2026-10-21T00:00:00.000Z"
    }
  ],
  "nextPageToken": ""
}
```

## Related

Use [`add_notes`](/docs/mcp/tools/add_notes) to submit a correction.
