catalog_search

Search authorized project resources by stable ID, name, description, or domain metadata. Use an exact ref from a unique result; do not repeat broad searches when hasMore is false.

Machine-readable: focused JSON · complete manifest

Contract

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

Input schema

{
  "additionalProperties": false,
  "properties": {
    "cursor": {
      "type": "string"
    },
    "domain": {
      "type": "string"
    },
    "kinds": {
      "items": {
        "enum": [
          "project",
          "connection",
          "source",
          "model",
          "semantic_model",
          "pipeline",
          "dashboard"
        ],
        "type": "string"
      },
      "type": "array"
    },
    "limit": {
      "maximum": 25,
      "minimum": 1,
      "type": "integer"
    },
    "query": {
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [
    "query"
  ],
  "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"
}