List Cascade Sites
cascade_list_sitesList all sites accessible with current API credentials, returning identifiers (id, name, type) for each site to enable discovery before reading or editing assets.
Instructions
List all sites accessible with the current API credentials.
Returns identifiers (id, name, type="site") for every site the authenticated user can see. This is typically the first call an agent makes to discover which sites exist before reading or editing assets inside them. The response contains only identifiers — call cascade_read with { type: "site", ... } to fetch a site's full configuration.
Args: (none)
Returns: Cascade OperationResult: { success: true, sites: [ { id, type: "site", path: { path, siteId, siteName } }, ... ] } On failure: { success: false, message: "" }
Examples:
Use when: "What sites do I have access to?" -> {}
Use when: "I need to find a siteId before reading a page" -> call this, then match by name.
Don't use when: You already know the site name/id — skip straight to cascade_read.
Don't use when: You need a site's full config — use cascade_read with type "site".
Error Handling:
"Permission denied" when credentials are invalid
"Authentication failed" when the API key is missing or revoked. Responses are JSON text; structuredContent is authoritative when the response fits. Oversized responses return bounded _cache metadata for cascade_read_response. For cascade_read, read_mode controls preview versus raw Cascade payload shape.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||