catalog_search

Search authorized project resources by stable ID, name, description, semantic metric or dimension names and labels, or domain metadata. The domain filter requires domain metadata in the active project. 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"
}