Skip to main content
Glama

Workflow Seal

workflow_seal
Idempotent

Seals a closed workflow for durable export. Requires the matching job session and an active pass. Never spends, captures, or starts a payment. The export remains a Zambo claim, not issuer authentication. Required arguments: workflow_id, _session_id.

Input Schema

NameRequiredDescriptionDefault
_refNoOptional handover referral ID from your install link.
actionNosave with proof the paid snapshot or edit its post-save with proof branding.
brandingNoOptional display name and logo settings for the saved workflow page.
_zambo_keyNoOptional active Day Pass key bound to this exact job. Never place it in a URL or public log.
_session_idYesRequired owning job ID, identical to the ID used when the workflow was closed.
workflow_idYesRequired workflow_id returned by workflow_close.
_caller_labelNoOptional caller label recorded as a caller-reported claim in the receipt.zambo-starter
_caller_handleNoOpaque anonymous continuity handle returned during initialize. Reuse it across MCP sessions; it is not payment authorization.
receipt_visibilityNoReceipt visibility for this call. Public is the default. Private returns a bearer link; anyone with that link can read it, so keep it secret. The raw token is not stored.public
_continuity_ai_labelNoOptional self-reported AI client label for the private continuity timeline. Zambo does not independently verify the client.
workflow_manage_tokenNoOptional private capability returned once by workflow_close. Never share it in public.

Output Schema

NameRequiredDescriptionDefault
okYes
idsYes
nextNo
tierNo
urlsYes
errorNo
graphNo
activeNo
resultYes
intentsNo
next_upNo
paymentNo
day_passNo
today_urlNo
expires_atNo
human_lineYes
next_stepsNo
daily_recapNo
renew_nudgeNo
unlock_linkNo
seconds_leftNo
resume_statusNo
resumed_resultNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • addedInput schema / properties / receipt_visibility
      Added value: +{
      +  "default": "public",
      +  "description": "Receipt visibility for this call. Public is the default. Private returns a bearer link; anyone with that link can read it, so keep it secret. The raw token is not stored.",
      +  "enum": [
      +    "public",
      +    "private"
      +  ],
      +  "type": "string"
      +}
    • changedOutput schema / required
      Previous value: -[
      -  "result",
      -  "ok",
      -  "human_line",
      -  "next",
      -  "ids",
      -  "urls"
      -]New value: +[
      +  "result",
      +  "ok",
      +  "human_line",
      +  "ids",
      +  "urls"
      +]
  2. Changed10 schema fields changed
    • changedOutput schema / properties / daily_recap / type
      Previous value: -"object"New value: +[
      +  "object",
      +  "null"
      +]
    • changedOutput schema / properties / error / anyOf
      Previous value: -[
      -  {
      -    "required": [
      -      "next_call"
      -    ]
      -  },
      -  {
      -    "required": [
      -      "next_url"
      -    ]
      -  }
      -]New value: +[
      +  {
      +    "properties": {
      +      "next_call": {}
      +    },
      +    "required": [
      +      "next_call"
      +    ]
      +  },
      +  {
      +    "properties": {
      +      "next_url": {}
      +    },
      +    "required": [
      +      "next_url"
      +    ]
      +  }
      +]
    • addedOutput schema / properties / graph / properties / edges
      Added value: +{
      +  "items": {
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedOutput schema / properties / graph / properties / nodes
      Added value: +{
      +  "items": {
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedOutput schema / properties / graph / properties / retries
      Added value: +{
      +  "properties": {
      +    "max": {
      +      "minimum": 0,
      +      "type": "integer"
      +    },
      +    "used": {
      +      "minimum": 0,
      +      "type": "integer"
      +    }
      +  },
      +  "required": [
      +    "used",
      +    "max"
      +  ],
      +  "type": "object"
      +}
    • addedOutput schema / properties / graph / properties / sources
      Added value: +{
      +  "properties": {
      +    "not_checked": {
      +      "minimum": 0,
      +      "type": "integer"
      +    },
      +    "not_resolved": {
      +      "minimum": 0,
      +      "type": "integer"
      +    },
      +    "resolved": {
      +      "minimum": 0,
      +      "type": "integer"
      +    }
      +  },
      +  "required": [
      +    "resolved",
      +    "not_resolved",
      +    "not_checked"
      +  ],
      +  "type": "object"
      +}
    • addedOutput schema / properties / graph / properties / summary
      Added value: +{
      +  "type": "string"
      +}
    • removedOutput schema / properties / next_steps / minItems
      Removed value: -1
    • removedOutput schema / properties / result / description
      Removed value: -"The tool's observed JSON value or plain-text result."
    • addedOutput schema / properties / result / oneOf
      Added value: +[
      +  {
      +    "additionalProperties": true,
      +    "properties": {
      +      "issuer_authenticated": {
      +        "type": "boolean"
      +      },
      +      "sealed_at": {
      +        "format": "date-time",
      +        "type": "string"
      +      },
      +      "status": {
      +        "const": "sealed"
      +      },
      +      "verification_status": {
      +        "type": "string"
      +      },
      +      "workflow_id": {
      +        "format": "uuid",
      +        "type": "string"
      +      },
      +      "workflow_url": {
      +        "format": "uri",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "status",
      +      "workflow_id",
      +      "workflow_url",
      +      "sealed_at"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": true,
      +    "properties": {
      +      "next": {
      +        "items": {
      +          "enum": [
      +            "day_pass_activate",
      +            "day_pass_checkout_link"
      +          ]
      +        },
      +        "minItems": 2,
      +        "type": "array"
      +      },
      +      "status": {
      +        "const": "day_pass_required"
      +      },
      +      "workflow_id": {
      +        "format": "uuid",
      +        "type": "string"
      +      },
      +      "workflow_url": {
      +        "format": "uri",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "status",
      +      "workflow_id",
      +      "workflow_url",
      +      "next"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": true,
      +    "properties": {
      +      "next_step": {
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "status": {
      +        "const": "day_pass_already_active"
      +      },
      +      "workflow_id": {
      +        "format": "uuid",
      +        "type": "string"
      +      },
      +      "workflow_url": {
      +        "format": "uri",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "status",
      +      "workflow_id",
      +      "workflow_url",
      +      "next_step"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": true,
      +    "properties": {
      +      "error": {
      +        "additionalProperties": true,
      +        "properties": {
      +          "code": {
      +            "type": "string"
      +          },
      +          "message": {
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "code",
      +          "message"
      +        ],
      +        "type": "object"
      +      },
      +      "status": {
      +        "const": "error"
      +      }
      +    },
      +    "required": [
      +      "status",
      +      "error"
      +    ],
      +    "type": "object"
      +  }
      +]
  3. Changed3 schema fields changed
    • addedInput schema / properties / branding / properties / display_name / description
      Added value: +"Display name shown on the save with proof workflow."
    • addedInput schema / properties / branding / properties / logo_asset_id / description
      Added value: +"Uploaded logo asset ID to use, or null to clear the logo."
    • changedOutput schema / properties / human_line / maxLength
      Previous value: -200New value: +512
  4. Changed1 schema field changed
    • addedInput schema / properties / branding / description
      Added value: +"Optional display name and logo settings for the saved workflow page."
  5. Changed1 schema field changed
    • changedInput schema / properties / action / description
      Previous value: -"Seal the paid snapshot or edit its post-seal branding."New value: +"save with proof the paid snapshot or edit its post-save with proof branding."
  6. Changed2 schema fields changed
    • addedInput schema / properties / _caller_handle
      Added value: +{
      +  "description": "Opaque anonymous continuity handle returned during initialize. Reuse it across MCP sessions; it is not payment authorization.",
      +  "maxLength": 64,
      +  "type": "string"
      +}
    • addedInput schema / properties / _caller_label / default
      Added value: +"zambo-starter"
  7. Changed1 schema field changed
    • changedOutput schema / properties / graph / properties / aer / const
      Previous value: -"draft-zambo-aer1-25"New value: +"draft-zambo-aer1-26"
  8. Changed1 schema field changed
    • changedOutput schema / properties / graph / properties / aer / const
      Previous value: -"draft-zambo-aer1-24"New value: +"draft-zambo-aer1-25"
  9. Changed1 schema field changed
    • changedOutput schema / properties / graph / properties / aer / const
      Previous value: -"draft-zambo-aer1-23"New value: +"draft-zambo-aer1-24"
  10. Changed1 schema field changed
    • changedOutput schema / properties / graph / properties / aer / const
      Previous value: -"draft-zambo-aer1-22"New value: +"draft-zambo-aer1-23"
  11. Changed1 schema field changed
    • changedOutput schema / properties / graph / properties / aer / const
      Previous value: -"draft-zambo-aer1-21"New value: +"draft-zambo-aer1-22"
  12. Changed1 schema field changed
    • changedOutput schema / properties / graph / properties / aer / const
      Previous value: -"draft-zambo-aer1-20"New value: +"draft-zambo-aer1-21"
  13. Changed1 schema field changed
    • addedOutput schema / properties / next_steps
      Added value: +{
      +  "items": {},
      +  "minItems": 1,
      +  "type": "array"
      +}
  14. Changed26 schema fields changed
    • addedInput schema / properties / _ref
      Added value: +{
      +  "description": "Optional handover referral ID from your install link.",
      +  "format": "uuid",
      +  "type": "string"
      +}
    • changedOutput schema / additionalProperties
      Previous value: -falseNew value: +true
    • addedOutput schema / properties / active
      Added value: +{
      +  "type": "boolean"
      +}
    • addedOutput schema / properties / daily_recap
      Added value: +{
      +  "type": "object"
      +}
    • addedOutput schema / properties / day_pass
      Added value: +{
      +  "type": "object"
      +}
    • addedOutput schema / properties / error
      Added value: +{
      +  "additionalProperties": true,
      +  "anyOf": [
      +    {
      +      "required": [
      +        "next_call"
      +      ]
      +    },
      +    {
      +      "required": [
      +        "next_url"
      +      ]
      +    }
      +  ],
      +  "properties": {
      +    "code": {
      +      "type": "string"
      +    },
      +    "next_call": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "args": {
      +          "type": "object"
      +        },
      +        "tool": {
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "tool",
      +        "args"
      +      ],
      +      "type": "object"
      +    },
      +    "next_step": {
      +      "type": "string"
      +    },
      +    "next_url": {
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "code",
      +    "next_step"
      +  ],
      +  "type": "object"
      +}
    • addedOutput schema / properties / expires_at
      Added value: +{
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / graph
      Added value: +{
      +  "properties": {
      +    "aer": {
      +      "const": "draft-zambo-aer1-20"
      +    },
      +    "schema": {
      +      "const": "zambo.graph/1"
      +    }
      +  },
      +  "required": [
      +    "schema",
      +    "aer",
      +    "nodes",
      +    "edges",
      +    "retries",
      +    "sources",
      +    "summary"
      +  ],
      +  "type": "object"
      +}
    • addedOutput schema / properties / human_line
      Added value: +{
      +  "maxLength": 200,
      +  "pattern": "^[^\\r\\n]*$",
      +  "type": "string"
      +}
    • addedOutput schema / properties / ids
      Added value: +{
      +  "additionalProperties": {
      +    "type": "string"
      +  },
      +  "type": "object"
      +}
    • addedOutput schema / properties / intents
      Added value: +{
      +  "items": {
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedOutput schema / properties / next
      Added value: +{
      +  "minLength": 1,
      +  "type": "string"
      +}
    • addedOutput schema / properties / next_up
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / ok
      Added value: +{
      +  "type": "boolean"
      +}
    • addedOutput schema / properties / payment
      Added value: +{
      +  "type": "object"
      +}
    • addedOutput schema / properties / renew_nudge
      Added value: +{
      +  "type": "object"
      +}
    • addedOutput schema / properties / result / description
      Added value: +"The tool's observed JSON value or plain-text result."
    • removedOutput schema / properties / result / oneOf
      Removed value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "already_sealed": {
      -        "type": "boolean"
      -      },
      -      "badge_url": {
      -        "type": "string"
      -      },
      -      "branding": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "display_name": {
      -            "type": "string"
      -          },
      -          "logo_asset_id": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          }
      -        },
      -        "required": [
      -          "display_name",
      -          "logo_asset_id"
      -        ],
      -        "type": "object"
      -      },
      -      "issuer_authenticated": {
      -        "const": false,
      -        "type": "boolean"
      -      },
      -      "pass": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "active": {
      -            "type": "boolean"
      -          },
      -          "expires_at": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "session_bound": {
      -            "const": true,
      -            "type": "boolean"
      -          }
      -        },
      -        "required": [
      -          "active",
      -          "expires_at",
      -          "session_bound"
      -        ],
      -        "type": "object"
      -      },
      -      "pdf_url": {
      -        "type": "string"
      -      },
      -      "sealed_at": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "sealed_snapshot": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "closed_receipt_id": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "count": {
      -            "minimum": 0,
      -            "type": "integer"
      -          },
      -          "merkle_root": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "receipts": {
      -            "items": {
      -              "additionalProperties": false,
      -              "properties": {
      -                "contextual_url": {
      -                  "type": "string"
      -                },
      -                "id": {
      -                  "type": "string"
      -                },
      -                "receipt_url": {
      -                  "type": "string"
      -                }
      -              },
      -              "required": [
      -                "id",
      -                "receipt_url",
      -                "contextual_url"
      -              ],
      -              "type": "object"
      -            },
      -            "type": "array"
      -          }
      -        },
      -        "required": [
      -          "count",
      -          "merkle_root",
      -          "closed_receipt_id",
      -          "receipts"
      -        ],
      -        "type": "object"
      -      },
      -      "status": {
      -        "const": "sealed",
      -        "type": "string"
      -      },
      -      "verification_status": {
      -        "const": "not_verified",
      -        "type": "string"
      -      },
      -      "workflow_id": {
      -        "type": "string"
      -      },
      -      "workflow_url": {
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "status",
      -      "already_sealed",
      -      "workflow_id",
      -      "workflow_url",
      -      "sealed_at",
      -      "sealed_snapshot",
      -      "pass",
      -      "branding",
      -      "badge_url",
      -      "pdf_url",
      -      "verification_status",
      -      "issuer_authenticated"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "next": {
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "status": {
      -        "const": "day_pass_required",
      -        "type": "string"
      -      },
      -      "workflow_id": {
      -        "type": "string"
      -      },
      -      "workflow_url": {
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "status",
      -      "workflow_id",
      -      "workflow_url",
      -      "next"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "error": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "code": {
      -            "type": "string"
      -          },
      -          "message": {
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "code",
      -          "message"
      -        ],
      -        "type": "object"
      -      },
      -      "status": {
      -        "const": "error",
      -        "type": "string"
      -      },
      -      "workflow_id": {
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "status",
      -      "error"
      -    ],
      -    "type": "object"
      -  }
      -]
    • addedOutput schema / properties / resume_status
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / resumed_result
      Added value: +{
      +  "type": "object"
      +}
    • addedOutput schema / properties / seconds_left
      Added value: +{
      +  "type": [
      +    "number",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / tier
      Added value: +{
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / today_url
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / unlock_link
      Added value: +{
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / urls
      Added value: +{
      +  "additionalProperties": {
      +    "type": "string"
      +  },
      +  "type": "object"
      +}
    • changedOutput schema / required
      Previous value: -[
      -  "result"
      -]New value: +[
      +  "result",
      +  "ok",
      +  "human_line",
      +  "next",
      +  "ids",
      +  "urls"
      +]
  15. Changed3 schema fields changed
    • addedInput schema / allOf
      Added value: +[
      +  {
      +    "if": {
      +      "properties": {
      +        "action": {
      +          "const": "branding"
      +        }
      +      },
      +      "required": [
      +        "action"
      +      ]
      +    },
      +    "then": {
      +      "required": [
      +        "workflow_manage_token"
      +      ]
      +    }
      +  }
      +]
    • changedInput schema / properties / workflow_manage_token / maxLength
      Previous value: -128New value: +2048
    • removedInput schema / properties / workflow_manage_token / minLength
      Removed value: -32
  16. Changed2 schema fields changed
    • addedInput schema / properties / action
      Added value: +{
      +  "description": "Seal the paid snapshot or edit its post-seal branding.",
      +  "enum": [
      +    "seal",
      +    "branding"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / branding
      Added value: +{
      +  "properties": {
      +    "display_name": {
      +      "maxLength": 80,
      +      "type": "string"
      +    },
      +    "logo_asset_id": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    }
      +  },
      +  "type": "object"
      +}
  17. Changed5 schema fields changed
    • removedOutput schema / properties / result / additionalProperties
      Removed value: -false
    • addedOutput schema / properties / result / oneOf
      Added value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "already_sealed": {
      +        "type": "boolean"
      +      },
      +      "badge_url": {
      +        "type": "string"
      +      },
      +      "branding": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "display_name": {
      +            "type": "string"
      +          },
      +          "logo_asset_id": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          }
      +        },
      +        "required": [
      +          "display_name",
      +          "logo_asset_id"
      +        ],
      +        "type": "object"
      +      },
      +      "issuer_authenticated": {
      +        "const": false,
      +        "type": "boolean"
      +      },
      +      "pass": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "active": {
      +            "type": "boolean"
      +          },
      +          "expires_at": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "session_bound": {
      +            "const": true,
      +            "type": "boolean"
      +          }
      +        },
      +        "required": [
      +          "active",
      +          "expires_at",
      +          "session_bound"
      +        ],
      +        "type": "object"
      +      },
      +      "pdf_url": {
      +        "type": "string"
      +      },
      +      "sealed_at": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "sealed_snapshot": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "closed_receipt_id": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "count": {
      +            "minimum": 0,
      +            "type": "integer"
      +          },
      +          "merkle_root": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "receipts": {
      +            "items": {
      +              "additionalProperties": false,
      +              "properties": {
      +                "contextual_url": {
      +                  "type": "string"
      +                },
      +                "id": {
      +                  "type": "string"
      +                },
      +                "receipt_url": {
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "id",
      +                "receipt_url",
      +                "contextual_url"
      +              ],
      +              "type": "object"
      +            },
      +            "type": "array"
      +          }
      +        },
      +        "required": [
      +          "count",
      +          "merkle_root",
      +          "closed_receipt_id",
      +          "receipts"
      +        ],
      +        "type": "object"
      +      },
      +      "status": {
      +        "const": "sealed",
      +        "type": "string"
      +      },
      +      "verification_status": {
      +        "const": "not_verified",
      +        "type": "string"
      +      },
      +      "workflow_id": {
      +        "type": "string"
      +      },
      +      "workflow_url": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "status",
      +      "already_sealed",
      +      "workflow_id",
      +      "workflow_url",
      +      "sealed_at",
      +      "sealed_snapshot",
      +      "pass",
      +      "branding",
      +      "badge_url",
      +      "pdf_url",
      +      "verification_status",
      +      "issuer_authenticated"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "next": {
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "status": {
      +        "const": "day_pass_required",
      +        "type": "string"
      +      },
      +      "workflow_id": {
      +        "type": "string"
      +      },
      +      "workflow_url": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "status",
      +      "workflow_id",
      +      "workflow_url",
      +      "next"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "error": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "code": {
      +            "type": "string"
      +          },
      +          "message": {
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "code",
      +          "message"
      +        ],
      +        "type": "object"
      +      },
      +      "status": {
      +        "const": "error",
      +        "type": "string"
      +      },
      +      "workflow_id": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "status",
      +      "error"
      +    ],
      +    "type": "object"
      +  }
      +]
    • removedOutput schema / properties / result / properties
      Removed value: -{
      -  "already_sealed": {
      -    "type": "boolean"
      -  },
      -  "badge_url": {
      -    "format": "uri",
      -    "type": "string"
      -  },
      -  "branding": {
      -    "additionalProperties": false,
      -    "properties": {
      -      "display_name": {
      -        "type": "string"
      -      },
      -      "logo_asset_id": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      }
      -    },
      -    "required": [
      -      "display_name",
      -      "logo_asset_id"
      -    ],
      -    "type": "object"
      -  },
      -  "issuer_authenticated": {
      -    "const": false,
      -    "type": "boolean"
      -  },
      -  "pass": {
      -    "additionalProperties": false,
      -    "properties": {
      -      "active": {
      -        "type": "boolean"
      -      },
      -      "expires_at": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "session_bound": {
      -        "const": true,
      -        "type": "boolean"
      -      }
      -    },
      -    "required": [
      -      "active",
      -      "expires_at",
      -      "session_bound"
      -    ],
      -    "type": "object"
      -  },
      -  "pdf_url": {
      -    "format": "uri",
      -    "type": "string"
      -  },
      -  "sealed_at": {
      -    "format": "date-time",
      -    "type": "string"
      -  },
      -  "sealed_snapshot": {
      -    "additionalProperties": false,
      -    "properties": {
      -      "closed_receipt_id": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "count": {
      -        "minimum": 0,
      -        "type": "integer"
      -      },
      -      "merkle_root": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "receipts": {
      -        "items": {
      -          "additionalProperties": false,
      -          "properties": {
      -            "contextual_url": {
      -              "format": "uri",
      -              "type": "string"
      -            },
      -            "id": {
      -              "type": "string"
      -            },
      -            "receipt_url": {
      -              "format": "uri",
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "id",
      -            "receipt_url",
      -            "contextual_url"
      -          ],
      -          "type": "object"
      -        },
      -        "type": "array"
      -      }
      -    },
      -    "required": [
      -      "count",
      -      "merkle_root",
      -      "closed_receipt_id",
      -      "receipts"
      -    ],
      -    "type": "object"
      -  },
      -  "status": {
      -    "const": "sealed",
      -    "type": "string"
      -  },
      -  "verification_status": {
      -    "const": "not_verified",
      -    "type": "string"
      -  },
      -  "workflow_id": {
      -    "format": "uuid",
      -    "type": "string"
      -  },
      -  "workflow_url": {
      -    "format": "uri",
      -    "type": "string"
      -  }
      -}
    • removedOutput schema / properties / result / required
      Removed value: -[
      -  "status",
      -  "already_sealed",
      -  "workflow_id",
      -  "workflow_url",
      -  "sealed_at",
      -  "sealed_snapshot",
      -  "pass",
      -  "branding",
      -  "badge_url",
      -  "pdf_url",
      -  "verification_status",
      -  "issuer_authenticated"
      -]
    • removedOutput schema / properties / result / type
      Removed value: -"object"
  18. Added

TDQS

A3.9/5.0
Behavior4/5

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

Beyond the annotations, it discloses financial semantics (never spends, captures, or starts a payment) and scope-of-trust caveats (the export is a Zambo claim, not issuer authentication), which the annotations cannot convey. It does not describe what "seal" does to the underlying workflow state or whether sealing is reversible, leaving some behavioral gaps.

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

Conciseness4/5

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

Four short sentences with the purpose and safety caveats front-loaded, no filler. The closing "Required arguments" sentence repeats what the schema already marks as required and is the one line that does not earn its place.

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

Completeness4/5

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

With an output schema present and full parameter documentation, the description only needs to carry prerequisites and trust semantics, which it does. It omits mention of the alternate branding action and its conditional token requirement, but that is fully specified in the schema.

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

Parameters3/5

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

Schema description coverage is 100%, so the schema already documents every parameter including the conditional workflow_manage_token for the branding action. The description only restates the two required argument names, adding no meaning beyond the schema, so the baseline 3 applies.

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

Purpose4/5

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

"Seals a closed workflow for durable export" gives a specific verb and resource and implies the prerequisite state (already closed), which separates it from the sibling workflow_close. It stops short of explicitly naming workflow_close as the prior step, so differentiation is implied rather than stated.

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

Usage Guidelines4/5

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

It states the conditions required to call it (matching job session, active pass) and that the workflow must already be closed, which is genuinely useful routing context. It does not name an alternative or state when not to use it, so it lands at clear-context-without-exclusions.

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