Skip to main content
Glama

Ziel archivieren

archive_business_goal
DestructiveIdempotent

Archive one explicitly selected goal from active tracking. These lifecycle tools cannot restore an archived goal. Read get_business_goals(goalId) first; use update_business_goal for definition changes.

Request:

  • A new intent needs the current expectedRevision and a fresh requestKey, unique across this actor/workspace’s goal create/update/archive operations, not merely per goal.

  • An exact replay keeps its original requestKey and expectedRevision even after the stored revision changes. Substituting a newer revision under that key is a conflict.

  • A receipt describes the original result, not current goal/proposal state. After uncertainty or replay, read get_business_goals(goalId), which includes archived records.

Results:

  • Non-money: status=archived and activates=false; the output schema describes the retained goal/revision.

  • Money goal: owner_approval_required and the existing human-card continuation; never call confirm_business_change.

  • Rejected: no change; read the reason.

Requires current operator:prepare, accounting:read and operations:read authority. History and references remain; archiving does not delete the goal or cancel work orders, steering baselines, budgets or provider actions.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "goalId": "<goalId>",
      "expectedRevision": "<expectedRevision>",
      "requestKey": "<requestKey>"
    },
    "name": "archive_business_goal"
  }
}

Input Schema

NameRequiredDescriptionDefault
goalIdYesExact opaque goalId returned by get_business_goals in this workspace; never a proposal ID or another tenant's identifier.
requestKeyYesCaller-generated request UUID. Keep it with the same exact operation, actor and payload; a reused key with changed contents is rejected. After an uncertain result read the goal, never invent another key.
expectedRevisionYesExact revision from the same goalId read. A changed goal requires a fresh read and renewed user intent, not automatic revision replacement.

Output Schema

NameRequiredDescriptionDefault
goalNoFlat stored goal definition and identity/revision metadata; no measured actual, progress or pace.
goalIdNoStored goal identity, present with active/archived results.
reasonNoRejection reason; no goal change was applied.
statusYesRead before reporting success: stored active/archived goal, unactivated Owner request, or rejected change.
replayedNoOriginal receipt replay, not proof of current goal or request state.
revisionNoRevision of the returned active/archived goal, not a measured-progress revision.
activatesYesTrue only for an active non-money result; an Owner request never activates the goal.
nextActionNoExact existing card/read continuation for an unactivated Owner request; models never confirm.
proposalIdNoStored Owner-request identity, present with owner_approval_required; not a goal ID.
presentationNoThe request receipt is retained even if its card could not be displayed. Read the same proposal; never prepare again.
lifecycleStatusNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "$schema": "https://json-schema.org/draft/2020-12/schema",
      +  "additionalProperties": false,
      +  "properties": {
      +    "activates": {
      +      "description": "True only for an active non-money result; an Owner request never activates the goal.",
      +      "type": "boolean"
      +    },
      +    "goal": {
      +      "additionalProperties": false,
      +      "description": "Flat stored goal definition and identity/revision metadata; no measured actual, progress or pace.",
      +      "properties": {
      +        "accountId": {
      +          "type": "string"
      +        },
      +        "cadence": {
      +          "enum": [
      +            "once",
      +            "weekly"
      +          ],
      +          "type": "string"
      +        },
      +        "comparator": {
      +          "enum": [
      +            "at_least",
      +            "at_most"
      +          ],
      +          "type": "string"
      +        },
      +        "createdAt": {
      +          "type": "string"
      +        },
      +        "deadlineOn": {
      +          "type": "string"
      +        },
      +        "goalId": {
      +          "type": "string"
      +        },
      +        "id": {
      +          "type": "string"
      +        },
      +        "lifecycleStatus": {
      +          "enum": [
      +            "active",
      +            "archived"
      +          ],
      +          "type": "string"
      +        },
      +        "metric": {
      +          "enum": [
      +            "paid_revenue",
      +            "inquiries",
      +            "bookings",
      +            "booking_rate"
      +          ],
      +          "type": "string"
      +        },
      +        "revision": {
      +          "type": "string"
      +        },
      +        "segmentKey": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "segmentLabel": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "startsOn": {
      +          "type": "string"
      +        },
      +        "status": {
      +          "enum": [
      +            "active",
      +            "archived"
      +          ],
      +          "type": "string"
      +        },
      +        "targetValue": {
      +          "type": "number"
      +        },
      +        "title": {
      +          "type": "string"
      +        },
      +        "unit": {
      +          "enum": [
      +            "eur_cents",
      +            "count",
      +            "basis_points"
      +          ],
      +          "type": "string"
      +        },
      +        "updatedAt": {
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "id",
      +        "accountId",
      +        "goalId",
      +        "revision",
      +        "metric",
      +        "comparator",
      +        "targetValue",
      +        "unit",
      +        "startsOn",
      +        "deadlineOn",
      +        "cadence",
      +        "segmentKey",
      +        "segmentLabel",
      +        "title",
      +        "status",
      +        "lifecycleStatus"
      +      ],
      +      "type": "object"
      +    },
      +    "goalId": {
      +      "description": "Stored goal identity, present with active/archived results.",
      +      "type": "string"
      +    },
      +    "lifecycleStatus": {
      +      "enum": [
      +        "active",
      +        "archived"
      +      ],
      +      "type": "string"
      +    },
      +    "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"
      +    },
      +    "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": "Rejection reason; no goal change was applied.",
      +      "type": "string"
      +    },
      +    "replayed": {
      +      "description": "Original receipt replay, not proof of current goal or request state.",
      +      "type": "boolean"
      +    },
      +    "revision": {
      +      "description": "Revision of the returned active/archived goal, not a measured-progress revision.",
      +      "type": "string"
      +    },
      +    "status": {
      +      "description": "Read before reporting success: stored active/archived goal, unactivated Owner request, or rejected change.",
      +      "enum": [
      +        "active",
      +        "archived",
      +        "owner_approval_required",
      +        "rejected"
      +      ],
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "status",
      +    "activates"
      +  ],
      +  "type": "object"
      +}
  2. Added

TDQS

A4.9/5.0
Behavior5/5

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

Beyond the annotations, the description explains that archived goals cannot be restored, that history and references remain, and that archiving does not delete the goal or cancel work orders or related provider actions. It also discloses the money-goal approval continuation path and required authority. These are exactly the behavioral details an agent needs for a destructive, idempotent lifecycle operation.

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 structured into Request and Results sections. Every sentence carries operational value for a high-consequence lifecycle tool, including preconditions, replay rules, and failure handling. There is no filler.

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?

Given a destructive lifecycle tool with required revision concurrency, idempotency keys, authority requirements, approval paths, and an output schema, the description covers what an agent must know before calling it. It also explains result categories without re-documenting the output schema.

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 coverage is 100%, so parameter definitions are already strong. The description still adds meaningful cross-parameter semantics: requestKey uniqueness spans create/update/archive operations for this actor/workspace, and exact replay preserves both requestKey and expectedRevision even after the stored revision changes. That goes beyond the schema, though somewhat overlaps it.

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 description states a specific verb and resource: archive one explicitly selected goal from active tracking. It clearly distinguishes this from related lifecycle operations by noting the goal cannot be restored and by routing definition changes to update_business_goal. An agent can identify the operation without opening sibling schemas.

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?

It explicitly says to read get_business_goals(goalId) first, use update_business_goal for definition changes, and never call confirm_business_change for a money goal. It also explains what happens for non-money, money, and rejected cases. This is clear when-to-use, when-not-to-use, and alternative guidance.

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