catalog_get

Resolve one exact authorized project resource ID and return compact metadata. For a semantic_model ref, details.metadata.definition contains the bounded active definition (datasets, dimensions, and metrics); use it to explain metric formulas before exporting dashboards or searching documentation.

Machine-readable: focused JSON · complete manifest

Contract

Property Value
Authorization RESOURCE_READ
Effect read
Operation manual
Tags catalog, describe
Defaults {}
MCP annotations read-only, idempotent, non-destructive, closed-world

Input schema

{
  "additionalProperties": false,
  "properties": {
    "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"
    }
  },
  "required": [
    "ref"
  ],
  "type": "object"
}

Output schema

{
  "additionalProperties": false,
  "properties": {
    "details": {
      "additionalProperties": false,
      "properties": {
        "kind": {
          "enum": [
            "project",
            "connection",
            "source",
            "model",
            "semantic_model",
            "pipeline",
            "dashboard"
          ],
          "type": "string"
        },
        "metadata": {
          "additionalProperties": {},
          "type": "object"
        }
      },
      "required": [
        "kind",
        "metadata"
      ],
      "type": "object"
    },
    "item": {
      "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"
    }
  },
  "required": [
    "details",
    "item"
  ],
  "type": "object"
}