catalog_list

Browse one authorized project-resource hierarchy level when a parent ref is known. Returned refs are exact stable IDs; a page with hasMore false is complete.

Machine-readable: focused JSON · complete manifest

Contract

Property Value
Authorization RESOURCE_READ
Effect read
Operation manual
Tags catalog, browse
Defaults {"limit":25}
MCP annotations read-only, idempotent, non-destructive, closed-world

Input schema

{
  "additionalProperties": false,
  "properties": {
    "childKinds": {
      "items": {
        "enum": [
          "project",
          "connection",
          "source",
          "model",
          "semantic_model",
          "pipeline",
          "dashboard"
        ],
        "type": "string"
      },
      "type": "array"
    },
    "cursor": {
      "type": "string"
    },
    "domain": {
      "type": "string"
    },
    "limit": {
      "maximum": 50,
      "minimum": 1,
      "type": "integer"
    },
    "parent": {
      "additionalProperties": false,
      "properties": {
        "id": {
          "maxLength": 256,
          "minLength": 1,
          "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
          "type": "string"
        },
        "kind": {
          "enum": [
            "project",
            "connection",
            "source",
            "model",
            "semantic_model",
            "pipeline",
            "dashboard"
          ],
          "type": "string"
        }
      },
      "required": [
        "id",
        "kind"
      ],
      "type": "object"
    }
  },
  "type": "object"
}

Output schema

{
  "additionalProperties": false,
  "properties": {
    "count": {
      "minimum": 0,
      "type": "integer"
    },
    "hasMore": {
      "type": "boolean"
    },
    "items": {
      "items": {
        "additionalProperties": false,
        "properties": {
          "description": {
            "type": "string"
          },
          "displayName": {
            "type": "string"
          },
          "domain": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "owner": {
            "type": "string"
          },
          "ref": {
            "additionalProperties": false,
            "properties": {
              "id": {
                "maxLength": 256,
                "minLength": 1,
                "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
                "type": "string"
              },
              "kind": {
                "enum": [
                  "project",
                  "connection",
                  "source",
                  "model",
                  "semantic_model",
                  "pipeline",
                  "dashboard"
                ],
                "type": "string"
              }
            },
            "required": [
              "id",
              "kind"
            ],
            "type": "object"
          },
          "tags": {
            "items": {
              "type": "string"
            },
            "type": "array"
          }
        },
        "required": [
          "name",
          "ref"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "nextCursor": {
      "type": "string"
    }
  },
  "required": [
    "count",
    "hasMore",
    "items"
  ],
  "type": "object"
}