Skip to main content
Glama

Ziele und Tempo lesen

get_business_goals
Read-onlyIdempotent

Read a goal’s definition, current progress or recorded definition changes. Use get_business_change to locate activity across resources or recover approval requests; use this tool once the goal is known.

Choose the evidence

  • To find active goals, call without selectors. includeArchived extends discovery to retired goals.

  • To inspect one goal before editing, copy its goalId into an exact read; that read also finds archived goals.

  • To compare recorded definitions, use view=history with goalId. A historical target is not a stored historical progress measurement.

Complete the task

For a duplicate check, traverse every active page while hasMore. For inspecting a known goal, use its ID rather than repeatedly listing. Smaller list pages calculate progress for fewer goals, so a partial page cannot prove no other goal exists. Live inserts can shift pages.

Progress is recomputed within the reporting span. Missing sources or unsupported segments leave started periods unknown. Additive metrics read zero before the span begins, meaning no in-period events yet. Storage/evidence failures are errors.

Read the current revision before update_business_goal/archive_business_goal; create_business_goal creates a separate goal. get_business_funnel supplies source evidence and get_business_budgets spending controls. Requires accounting:read, operations:read and current access.

Input Schema

NameRequiredDescriptionDefault
viewNoOpt-in recorded lifecycle receipts for one exact goalId. Not complete retrospective history, measured progress or current goal/request state.
limitNoMaximum goals or recorded history receipts in one page, 1–100; omitted means 50. Exact current-goal reads reject this field.
cursorNoUnchanged pagination.nextCursor for the same view and query. History cursors bind the current actor, tenant and exact goalId; list cursors retain includeArchived. Exact current-goal reads reject this field.
goalIdNoExact opaque goalId returned by get_business_goals in this workspace; never a proposal ID or another tenant's identifier.
includeArchivedNoList option: include archived goals as well as active goals; omitted means active only. Exact goalId reads include either lifecycle state.

Output Schema

NameRequiredDescriptionDefault
viewNo
goalsNoCurrent selected goals; an absent/foreign goal ID yields an empty array.
goalIdNo
reasonNoUnavailable reason, not evidence of no goals.
statusYesCurrent goal or retained lifecycle read availability.
historyNo
coverageNo
paginationNo
suggestionNoOptional inquiry-count suggestion, not an active target or permission to create one.
revenueSuggestionNoOptional unactivated paid-revenue suggestion; target/actual/expected use EUR cents. Actual may be unknown.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed6 schema fields changed
    • removedOutput schema / properties / expiresAt
      Removed value: -{
      -  "description": "Only the legacy FULL stored-request response; never a current goal deadline.",
      -  "type": "string"
      -}
    • removedOutput schema / properties / nextAction
      Removed value: -{
      -  "additionalProperties": false,
      -  "description": "Exact existing card/read continuation for an unactivated Owner request; models never confirm.",
      -  "properties": {
      -    "arguments": {
      -      "additionalProperties": false,
      -      "properties": {
      -        "proposalId": {
      -          "type": "string"
      -        }
      -      },
      -      "required": [
      -        "proposalId"
      -      ],
      -      "type": "object"
      -    },
      -    "capability": {
      -      "description": "Exact server-provided continuation in this connection; copy it rather than infer another tool.",
      -      "type": "string"
      -    },
      -    "requiresHumanClick": {
      -      "const": true,
      -      "type": "boolean"
      -    }
      -  },
      -  "required": [
      -    "capability",
      -    "requiresHumanClick",
      -    "arguments"
      -  ],
      -  "type": "object"
      -}
    • removedOutput schema / properties / presentation
      Removed value: -{
      -  "const": "unavailable_read_same_proposal",
      -  "description": "The request receipt is retained even if its card could not be displayed. Read the same proposal; never prepare again.",
      -  "type": "string"
      -}
    • removedOutput schema / properties / proposalId
      Removed value: -{
      -  "description": "Request ID echoed by the legacy FULL proposalId read, including not_found; never a goal ID.",
      -  "type": "string"
      -}
    • changedOutput schema / properties / status / description
      Previous value: -"Current/history reads: ok or unavailable. Request statuses belong only to the legacy FULL proposalId mode."New value: +"Current goal or retained lifecycle read availability."
    • changedOutput schema / properties / status / enum
      Previous value: -[
      -  "ok",
      -  "unavailable",
      -  "pending_owner",
      -  "approved",
      -  "expired",
      -  "not_found"
      -]New value: +[
      +  "ok",
      +  "unavailable"
      +]
  2. Changed1 schema field changed
    • changedOutput schema / properties / proposalId / description
      Previous value: -"Stored Owner-request identity, present with owner_approval_required; not a goal ID."New value: +"Request ID echoed by the legacy FULL proposalId read, including not_found; never a goal ID."
  3. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "$schema": "https://json-schema.org/draft/2020-12/schema",
      +  "additionalProperties": false,
      +  "properties": {
      +    "coverage": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "completeRetrospectiveHistory": {
      +          "const": false,
      +          "type": "boolean"
      +        },
      +        "currentStateIncluded": {
      +          "const": false,
      +          "type": "boolean"
      +        },
      +        "measuredProgressIncluded": {
      +          "const": false,
      +          "type": "boolean"
      +        },
      +        "recordedLifecycleOnly": {
      +          "const": true,
      +          "type": "boolean"
      +        }
      +      },
      +      "required": [
      +        "recordedLifecycleOnly",
      +        "completeRetrospectiveHistory",
      +        "measuredProgressIncluded",
      +        "currentStateIncluded"
      +      ],
      +      "type": "object"
      +    },
      +    "expiresAt": {
      +      "description": "Only the legacy FULL stored-request response; never a current goal deadline.",
      +      "type": "string"
      +    },
      +    "goalId": {
      +      "type": "string"
      +    },
      +    "goals": {
      +      "description": "Current selected goals; an absent/foreign goal ID yields an empty array.",
      +      "items": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "actual": {
      +            "description": "Measured value in unit. Null is unknown source/segment coverage, never zero.",
      +            "type": [
      +              "number",
      +              "null"
      +            ]
      +          },
      +          "actualLabel": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "cadence": {
      +            "enum": [
      +              "once",
      +              "weekly"
      +            ],
      +            "type": "string"
      +          },
      +          "comparator": {
      +            "enum": [
      +              "at_least",
      +              "at_most"
      +            ],
      +            "type": "string"
      +          },
      +          "createdAt": {
      +            "type": "string"
      +          },
      +          "deadlineLabel": {
      +            "type": "string"
      +          },
      +          "deadlineOn": {
      +            "type": "string"
      +          },
      +          "definition": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "cadence": {
      +                "enum": [
      +                  "once",
      +                  "weekly"
      +                ],
      +                "type": "string"
      +              },
      +              "comparator": {
      +                "enum": [
      +                  "at_least",
      +                  "at_most"
      +                ],
      +                "type": "string"
      +              },
      +              "deadlineOn": {
      +                "type": "string"
      +              },
      +              "metric": {
      +                "enum": [
      +                  "paid_revenue",
      +                  "inquiries",
      +                  "bookings",
      +                  "booking_rate"
      +                ],
      +                "type": "string"
      +              },
      +              "segmentKey": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "segmentLabel": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "startsOn": {
      +                "type": "string"
      +              },
      +              "targetValue": {
      +                "type": "number"
      +              },
      +              "title": {
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "metric",
      +              "comparator",
      +              "targetValue",
      +              "startsOn",
      +              "deadlineOn",
      +              "cadence",
      +              "segmentKey",
      +              "segmentLabel",
      +              "title"
      +            ],
      +            "type": "object"
      +          },
      +          "expectedLabel": {
      +            "type": "string"
      +          },
      +          "expectedValue": {
      +            "description": "Rounded linear threshold for elapsed time, in unit; not predicted final performance.",
      +            "type": "number"
      +          },
      +          "goalId": {
      +            "type": "string"
      +          },
      +          "lifecycleStatus": {
      +            "enum": [
      +              "active",
      +              "archived"
      +            ],
      +            "type": "string"
      +          },
      +          "measurement": {
      +            "additionalProperties": false,
      +            "description": "Actual's measured interval and native source basis. Paid revenue uses original primary paid-at records, including now-refunded payments.",
      +            "properties": {
      +              "basis": {
      +                "type": "string"
      +              },
      +              "from": {
      +                "type": "string"
      +              },
      +              "until": {
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "from",
      +              "until",
      +              "basis"
      +            ],
      +            "type": "object"
      +          },
      +          "measurementLabel": {
      +            "type": "string"
      +          },
      +          "metric": {
      +            "enum": [
      +              "paid_revenue",
      +              "inquiries",
      +              "bookings",
      +              "booking_rate"
      +            ],
      +            "type": "string"
      +          },
      +          "metricLabel": {
      +            "type": "string"
      +          },
      +          "pace": {
      +            "description": "Pace ratio against elapsed expected value, not percent or forecast. Zero expected value uses 1 for zero actual, otherwise 0. Null before start or when actual is unknown.",
      +            "type": [
      +              "number",
      +              "null"
      +            ]
      +          },
      +          "progressPercent": {
      +            "description": "Uncapped actual/target percentage, not directional success or pace. Null for unknown actual or nonpositive target.",
      +            "type": [
      +              "number",
      +              "null"
      +            ]
      +          },
      +          "recurrence": {
      +            "enum": [
      +              "once",
      +              "weekly",
      +              "monthly"
      +            ],
      +            "type": "string"
      +          },
      +          "revision": {
      +            "type": "string"
      +          },
      +          "segmentKey": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "segmentLabel": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "settingsUrl": {
      +            "type": "string"
      +          },
      +          "startsLabel": {
      +            "type": "string"
      +          },
      +          "startsOn": {
      +            "type": "string"
      +          },
      +          "status": {
      +            "description": "Measured directional progress, separate from lifecycleStatus active/archived.",
      +            "enum": [
      +              "ahead",
      +              "on_track",
      +              "behind",
      +              "done",
      +              "not_started",
      +              "unknown"
      +            ],
      +            "type": "string"
      +          },
      +          "statusLabel": {
      +            "type": "string"
      +          },
      +          "targetLabel": {
      +            "type": "string"
      +          },
      +          "targetValue": {
      +            "type": "number"
      +          },
      +          "title": {
      +            "type": "string"
      +          },
      +          "unit": {
      +            "enum": [
      +              "eur_cents",
      +              "count",
      +              "basis_points"
      +            ],
      +            "type": "string"
      +          },
      +          "updatedAt": {
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "goalId",
      +          "revision",
      +          "lifecycleStatus",
      +          "unit",
      +          "definition",
      +          "title",
      +          "metric",
      +          "metricLabel",
      +          "segmentLabel",
      +          "targetLabel",
      +          "actualLabel",
      +          "deadlineLabel",
      +          "startsLabel",
      +          "status",
      +          "statusLabel",
      +          "cadence",
      +          "progressPercent",
      +          "pace",
      +          "expectedValue",
      +          "expectedLabel",
      +          "measurementLabel",
      +          "measurement",
      +          "actual",
      +          "targetValue",
      +          "comparator",
      +          "startsOn",
      +          "deadlineOn",
      +          "segmentKey"
      +        ],
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "history": {
      +      "items": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "applied": {
      +            "description": "True: this receipt records an applied definition. False: only the original pending request, even if a later receipt approved it.",
      +            "type": "boolean"
      +          },
      +          "goal": {
      +            "additionalProperties": false,
      +            "description": "Recorded definition/revision only for applied receipts; never current measured progress.",
      +            "properties": {
      +              "createdAt": {
      +                "type": "string"
      +              },
      +              "definition": {
      +                "additionalProperties": false,
      +                "properties": {
      +                  "cadence": {
      +                    "enum": [
      +                      "once",
      +                      "weekly"
      +                    ],
      +                    "type": "string"
      +                  },
      +                  "comparator": {
      +                    "enum": [
      +                      "at_least",
      +                      "at_most"
      +                    ],
      +                    "type": "string"
      +                  },
      +                  "deadlineOn": {
      +                    "type": "string"
      +                  },
      +                  "metric": {
      +                    "enum": [
      +                      "paid_revenue",
      +                      "inquiries",
      +                      "bookings",
      +                      "booking_rate"
      +                    ],
      +                    "type": "string"
      +                  },
      +                  "segmentKey": {
      +                    "type": [
      +                      "string",
      +                      "null"
      +                    ]
      +                  },
      +                  "segmentLabel": {
      +                    "type": [
      +                      "string",
      +                      "null"
      +                    ]
      +                  },
      +                  "startsOn": {
      +                    "type": "string"
      +                  },
      +                  "targetValue": {
      +                    "type": "number"
      +                  },
      +                  "title": {
      +                    "type": "string"
      +                  }
      +                },
      +                "required": [
      +                  "metric",
      +                  "comparator",
      +                  "targetValue",
      +                  "startsOn",
      +                  "deadlineOn",
      +                  "cadence",
      +                  "segmentKey",
      +                  "segmentLabel",
      +                  "title"
      +                ],
      +                "type": "object"
      +              },
      +              "goalId": {
      +                "type": "string"
      +              },
      +              "lifecycleStatus": {
      +                "enum": [
      +                  "active",
      +                  "archived"
      +                ],
      +                "type": "string"
      +              },
      +              "revision": {
      +                "type": "string"
      +              },
      +              "unit": {
      +                "enum": [
      +                  "eur_cents",
      +                  "count",
      +                  "basis_points"
      +                ],
      +                "type": "string"
      +              },
      +              "updatedAt": {
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "goalId",
      +              "revision",
      +              "lifecycleStatus",
      +              "unit",
      +              "definition"
      +            ],
      +            "type": "object"
      +          },
      +          "proposalId": {
      +            "description": "Original pending request identity, not an applied goal revision.",
      +            "type": "string"
      +          },
      +          "receiptId": {
      +            "type": "string"
      +          },
      +          "recordedAt": {
      +            "type": "string"
      +          },
      +          "status": {
      +            "enum": [
      +              "active",
      +              "archived",
      +              "approved",
      +              "owner_approval_required"
      +            ],
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "receiptId",
      +          "recordedAt",
      +          "status",
      +          "applied"
      +        ],
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "nextAction": {
      +      "additionalProperties": false,
      +      "description": "Exact existing card/read continuation for an unactivated Owner request; models never confirm.",
      +      "properties": {
      +        "arguments": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "proposalId": {
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "proposalId"
      +          ],
      +          "type": "object"
      +        },
      +        "capability": {
      +          "description": "Exact server-provided continuation in this connection; copy it rather than infer another tool.",
      +          "type": "string"
      +        },
      +        "requiresHumanClick": {
      +          "const": true,
      +          "type": "boolean"
      +        }
      +      },
      +      "required": [
      +        "capability",
      +        "requiresHumanClick",
      +        "arguments"
      +      ],
      +      "type": "object"
      +    },
      +    "pagination": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "hasMore": {
      +          "type": "boolean"
      +        },
      +        "nextCursor": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        }
      +      },
      +      "required": [
      +        "hasMore",
      +        "nextCursor"
      +      ],
      +      "type": "object"
      +    },
      +    "presentation": {
      +      "const": "unavailable_read_same_proposal",
      +      "description": "The request receipt is retained even if its card could not be displayed. Read the same proposal; never prepare again.",
      +      "type": "string"
      +    },
      +    "proposalId": {
      +      "description": "Stored Owner-request identity, present with owner_approval_required; not a goal ID.",
      +      "type": "string"
      +    },
      +    "reason": {
      +      "description": "Unavailable reason, not evidence of no goals.",
      +      "type": "string"
      +    },
      +    "revenueSuggestion": {
      +      "anyOf": [
      +        {
      +          "additionalProperties": false,
      +          "properties": {
      +            "actual": {
      +              "type": [
      +                "number",
      +                "null"
      +              ]
      +            },
      +            "deadlineLabel": {
      +              "type": "string"
      +            },
      +            "deadlineOn": {
      +              "type": "string"
      +            },
      +            "expectedValue": {
      +              "type": "number"
      +            },
      +            "label": {
      +              "type": "string"
      +            },
      +            "sentence": {
      +              "type": "string"
      +            },
      +            "startsOn": {
      +              "type": "string"
      +            },
      +            "targetCents": {
      +              "type": "number"
      +            },
      +            "title": {
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "targetCents",
      +            "actual",
      +            "expectedValue",
      +            "startsOn",
      +            "deadlineOn",
      +            "deadlineLabel",
      +            "label",
      +            "title",
      +            "sentence"
      +          ],
      +          "type": "object"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ],
      +      "description": "Optional unactivated paid-revenue suggestion; target/actual/expected use EUR cents. Actual may be unknown."
      +    },
      +    "status": {
      +      "description": "Current/history reads: ok or unavailable. Request statuses belong only to the legacy FULL proposalId mode.",
      +      "enum": [
      +        "ok",
      +        "unavailable",
      +        "pending_owner",
      +        "approved",
      +        "expired",
      +        "not_found"
      +      ],
      +      "type": "string"
      +    },
      +    "suggestion": {
      +      "anyOf": [
      +        {
      +          "additionalProperties": false,
      +          "properties": {
      +            "sentence": {
      +              "type": "string"
      +            },
      +            "target": {
      +              "type": "number"
      +            }
      +          },
      +          "required": [
      +            "target",
      +            "sentence"
      +          ],
      +          "type": "object"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ],
      +      "description": "Optional inquiry-count suggestion, not an active target or permission to create one."
      +    },
      +    "view": {
      +      "const": "history",
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "status"
      +  ],
      +  "type": "object"
      +}
  4. Changed4 schema fields changed
    • changedInput schema / allOf
      Previous value: -[
      -  {
      -    "if": {
      -      "required": [
      -        "goalId"
      -      ]
      -    },
      -    "then": {
      -      "not": {
      -        "anyOf": [
      -          {
      -            "required": [
      -              "includeArchived"
      -            ]
      -          },
      -          {
      -            "required": [
      -              "limit"
      -            ]
      -          },
      -          {
      -            "required": [
      -              "cursor"
      -            ]
      -          }
      -        ]
      -      }
      -    }
      -  }
      -]New value: +[
      +  {
      +    "if": {
      +      "not": {
      +        "required": [
      +          "view"
      +        ]
      +      },
      +      "required": [
      +        "goalId"
      +      ]
      +    },
      +    "then": {
      +      "not": {
      +        "anyOf": [
      +          {
      +            "required": [
      +              "includeArchived"
      +            ]
      +          },
      +          {
      +            "required": [
      +              "limit"
      +            ]
      +          },
      +          {
      +            "required": [
      +              "cursor"
      +            ]
      +          }
      +        ]
      +      }
      +    }
      +  },
      +  {
      +    "if": {
      +      "required": [
      +        "view"
      +      ]
      +    },
      +    "then": {
      +      "not": {
      +        "required": [
      +          "includeArchived"
      +        ]
      +      },
      +      "required": [
      +        "goalId"
      +      ]
      +    }
      +  }
      +]
    • changedInput schema / properties / cursor / description
      Previous value: -"Unchanged pagination.nextCursor from the previous list with the same includeArchived filter. Follow until hasMore=false; not used with goalId."New value: +"Unchanged pagination.nextCursor for the same view and query. History cursors bind the current actor, tenant and exact goalId; list cursors retain includeArchived. Exact current-goal reads reject this field."
    • changedInput schema / properties / limit / description
      Previous value: -"Maximum goals in one list page, 1–100; omitted means 50. Not used with goalId."New value: +"Maximum goals or recorded history receipts in one page, 1–100; omitted means 50. Exact current-goal reads reject this field."
    • addedInput schema / properties / view
      Added value: +{
      +  "const": "history",
      +  "description": "Opt-in recorded lifecycle receipts for one exact goalId. Not complete retrospective history, measured progress or current goal/request state.",
      +  "type": "string"
      +}
  5. Changed2 schema fields changed
    • changedInput schema / allOf
      Previous value: -[
      -  {
      -    "if": {
      -      "required": [
      -        "proposalId"
      -      ]
      -    },
      -    "then": {
      -      "not": {
      -        "anyOf": [
      -          {
      -            "required": [
      -              "goalId"
      -            ]
      -          },
      -          {
      -            "required": [
      -              "includeArchived"
      -            ]
      -          },
      -          {
      -            "required": [
      -              "limit"
      -            ]
      -          },
      -          {
      -            "required": [
      -              "cursor"
      -            ]
      -          }
      -        ]
      -      }
      -    }
      -  },
      -  {
      -    "if": {
      -      "required": [
      -        "goalId"
      -      ]
      -    },
      -    "then": {
      -      "not": {
      -        "anyOf": [
      -          {
      -            "required": [
      -              "includeArchived"
      -            ]
      -          },
      -          {
      -            "required": [
      -              "limit"
      -            ]
      -          },
      -          {
      -            "required": [
      -              "cursor"
      -            ]
      -          }
      -        ]
      -      }
      -    }
      -  }
      -]New value: +[
      +  {
      +    "if": {
      +      "required": [
      +        "goalId"
      +      ]
      +    },
      +    "then": {
      +      "not": {
      +        "anyOf": [
      +          {
      +            "required": [
      +              "includeArchived"
      +            ]
      +          },
      +          {
      +            "required": [
      +              "limit"
      +            ]
      +          },
      +          {
      +            "required": [
      +              "cursor"
      +            ]
      +          }
      +        ]
      +      }
      +    }
      +  }
      +]
    • removedInput schema / properties / proposalId
      Removed value: -{
      -  "description": "Exact stored goal approval request ID from a preparation receipt. Reads pending_owner/approved/expired/not_found; an eligible pending request can restore its same card. Requires operator:prepare plus read access; exclusive with goalId/list options.",
      -  "format": "uuid",
      -  "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      -  "type": "string"
      -}
  6. Changed1 schema field changed
    • addedInput schema / allOf
      Added value: +[
      +  {
      +    "if": {
      +      "required": [
      +        "proposalId"
      +      ]
      +    },
      +    "then": {
      +      "not": {
      +        "anyOf": [
      +          {
      +            "required": [
      +              "goalId"
      +            ]
      +          },
      +          {
      +            "required": [
      +              "includeArchived"
      +            ]
      +          },
      +          {
      +            "required": [
      +              "limit"
      +            ]
      +          },
      +          {
      +            "required": [
      +              "cursor"
      +            ]
      +          }
      +        ]
      +      }
      +    }
      +  },
      +  {
      +    "if": {
      +      "required": [
      +        "goalId"
      +      ]
      +    },
      +    "then": {
      +      "not": {
      +        "anyOf": [
      +          {
      +            "required": [
      +              "includeArchived"
      +            ]
      +          },
      +          {
      +            "required": [
      +              "limit"
      +            ]
      +          },
      +          {
      +            "required": [
      +              "cursor"
      +            ]
      +          }
      +        ]
      +      }
      +    }
      +  }
      +]
  7. Changed1 schema field changed
    • changedInput schema / properties / proposalId / description
      Previous value: -"Exact pending goal proposal ID from a preparation receipt. Restores that same human card without another write; requires operator:prepare in addition to read access. Exclusive with goalId/list options."New value: +"Exact stored goal approval request ID from a preparation receipt. Reads pending_owner/approved/expired/not_found; an eligible pending request can restore its same card. Requires operator:prepare plus read access; exclusive with goalId/list options."
  8. Changed1 schema field changed
    • addedInput schema / properties / proposalId
      Added value: +{
      +  "description": "Exact pending goal proposal ID from a preparation receipt. Restores that same human card without another write; requires operator:prepare in addition to read access. Exclusive with goalId/list options.",
      +  "format": "uuid",
      +  "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      +  "type": "string"
      +}
  9. Changed4 schema fields changed
    • addedInput schema / properties / cursor
      Added value: +{
      +  "description": "Unchanged pagination.nextCursor from the previous list with the same includeArchived filter. Follow until hasMore=false; not used with goalId.",
      +  "maxLength": 1024,
      +  "minLength": 1,
      +  "type": "string"
      +}
    • addedInput schema / properties / goalId
      Added value: +{
      +  "description": "Exact opaque goalId returned by get_business_goals in this workspace; never a proposal ID or another tenant's identifier.",
      +  "maxLength": 160,
      +  "minLength": 1,
      +  "type": "string"
      +}
    • addedInput schema / properties / includeArchived
      Added value: +{
      +  "description": "List option: include archived goals as well as active goals; omitted means active only. Exact goalId reads include either lifecycle state.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / limit
      Added value: +{
      +  "description": "Maximum goals in one list page, 1–100; omitted means 50. Not used with goalId.",
      +  "maximum": 100,
      +  "minimum": 1,
      +  "type": "integer"
      +}
  10. First observed

TDQS

A4.9/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Beyond the read-only and non-destructive annotations, the description discloses important behavior: partial pages cannot prove no other goal exists, live inserts can shift pages, missing sources leave started periods unknown, additive metrics read zero before the span begins, and storage/evidence failures are errors. It also states the required permissions.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The purpose is front-loaded, then organized under clear sections for choosing evidence and completing the task. Although detailed, every block supports a specific mode, pitfall, or prerequisite, so the length is justified.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The description covers all three usage modes, pagination caveats, progress semantics, permission requirements, and relevant next-step tools. Since an output schema exists and annotations cover safety, no essential invocation context is missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is already 100%, so the baseline is 3. The description adds operational meaning by mapping selector combinations to list, exact-read, and history modes, including that includeArchived extends discovery and that view=history requires goalId.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The opening sentence states a specific verb, 'read', and names the resources: goal definition, current progress, and recorded definition changes. The next sentence explicitly distinguishes this tool from get_business_change and says to use this tool once the goal is known. The purpose is clear enough to select it correctly without opening the schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description gives explicit branching guidance: call without selectors for active goals, use includeArchived for retired goals, copy goalId for an exact read, and use view=history with goalId for comparisons. It also names alternatives such as get_business_change for locating activity and says to read the current revision before update_business_goal or archive_business_goal.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources