Skip to content
Tools/Spec Introspection/list_type_labels

list_type_labels

List canonical `UPGTypeLabel` entries: each entity type's display label, alt-labels (synonyms), per-framework labels, and designation labels where applicable. Paginated (default 100, max 500). Cursor is opaque base64 (`offset:N`), same convention as `list_frameworks`. External MCP apps need labels for rendering.

Spec Introspectionatomic (read-only)

Arguments

limitnumberoptional

Page size (default 100, max 500).

cursorstringoptional

Opaque pagination cursor. Pass next_cursor from a previous response.

Returns

Shape
{ total, count, next_cursor?, labels: UPGTypeLabel[] }

Examples

Live call against the Notion example graph.

Output

{
  "total": 312,
  "count": 100,
  "labels": [
    {
      "id": "product",
      "canonical_label": "Product",
      "alt_labels": [
        "offering",
        "app",
        "service",
        "platform",
        "product"
      ],
      "framework_labels": {
        "three-horizons": "Product",
        "marketing-mix-4ps": "Product"
      }
    },
    {
      "id": "outcome",
      "canonical_label": "Outcome",
      "alt_labels": [
        "desired outcome",
        "product outcome",
        "business outcome",
        "target outcome",
        "root outcome",
        "consequences",
        "what went well",
        "outcome"
      ],
      "framework_labels": {
        "opportunity-solution-tree": "Root Outcome",
        "adr-log": "Consequences",
        "retrospective": "What Went Well",
        "metrics-tree": "Outcome",
        "ost": "Desired Outcome",
        "okr_tree": "Outcome"
      }
    },
    {
      "id": "objective",
      "canonical_label": "Objective",
      "alt_labels": [
        "goal",
        "strategic goal",
        "team goal",
        "objective"
      ],
      "framework_labels": {
        "okr-framework": "Objective",
        "okr_tree": "Objective"
      }
    },
    {
      "id": "key_result",
      "canonical_label": "Key Result",
      "alt_labels": [
        "kr",
        "measurable result",
        "target",
        "key result 1",
… (truncated)

See Also