{
  "descriptorVersion": "1.0.0",
  "name": "estimate_severance_long_service_payment",
  "title": "Severance and long service payment estimator",
  "description": "Estimate a Hong Kong statutory severance payment or long service payment for a monthly-rated employee on this page, with the page's own calculation (HK$22,500 monthly wage cap, HK$390,000 total cap, MPF offsetting split at the 1 May 2025 transition). Replaces every input on the page and shows the same result on screen. Does not decide eligibility by reason of leaving; not legal advice. Calculation or source matching runs in this page; arguments and results are not uploaded to Agoodeal servers or to Google Analytics, and the result is returned only to the calling agent. Non-sensitive usage metadata (tool name, outcome, execution mode, error code, duration; predefined source IDs for source matching) is reported through the site’s existing Google Analytics 4.",
  "execution": {
    "environment": "browser",
    "interface": "WebMCP imperative API: document.modelContext.registerTool (experimental)",
    "executionMode": "local_calculation",
    "pageUrls": [
      "https://www.agoodeal.com/tools/severance-long-service-payment-calculator/"
    ],
    "requirement": "Open one of pageUrls in a browser that exposes document.modelContext. As of October 2026 this is experimental: Chrome 149+ with chrome://flags/#enable-webmcp-testing, or an origin trial that Agoodeal has not joined. Without it the page works normally for people and no tool is registered.",
    "serverEndpoint": null,
    "argumentsEncoding": "JSON object (some browser versions require callers to pass it as a JSON string).",
    "returns": "A JSON string matching outputSchema."
  },
  "annotations": {
    "readOnlyHint": false,
    "untrustedContentHint": false,
    "consequentialHint": false
  },
  "annotationNotes": "readOnlyHint is false because the tool replaces every input on the page and shows the same result the visitor would see. It submits, stores and books nothing.",
  "inputSchema": {
    "type": "object",
    "additionalProperties": false,
    "required": [
      "employmentStartDate",
      "lastEmploymentDate",
      "finalMonthlyWage"
    ],
    "properties": {
      "employmentStartDate": {
        "type": "string",
        "format": "date",
        "description": "Start of the continuous contract, YYYY-MM-DD."
      },
      "lastEmploymentDate": {
        "type": "string",
        "format": "date",
        "description": "Relevant date of termination (last day counted), YYYY-MM-DD."
      },
      "finalMonthlyWage": {
        "type": "number",
        "minimum": 0,
        "description": "Full monthly wage in the last month before termination, HK$."
      },
      "preTransitionMonthlyWage": {
        "type": "number",
        "minimum": 0,
        "description": "Full monthly wage in April 2025, HK$. Required only when employment started before and ended on or after 1 May 2025."
      },
      "offsetAccruedBenefits": {
        "type": "number",
        "minimum": 0,
        "description": "Employer mandatory MPF accrued benefits that may offset the pre-transition portion, HK$. Omit for 0."
      }
    }
  },
  "outputSchema": {
    "oneOf": [
      {
        "type": "object",
        "required": [
          "ok",
          "tool",
          "mode",
          "arguments",
          "result",
          "rendered",
          "uiInputsReplaced"
        ],
        "properties": {
          "ok": {
            "const": true
          },
          "tool": {
            "type": "string"
          },
          "mode": {
            "const": "local_calculation"
          },
          "arguments": {
            "type": "object"
          },
          "result": {
            "type": "object"
          },
          "rendered": {
            "type": "object",
            "description": "Text the page displayed after the same calculation, keyed by element id."
          },
          "uiInputsReplaced": {
            "const": true
          },
          "notes": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      },
      {
        "type": "object",
        "required": [
          "ok",
          "error"
        ],
        "properties": {
          "ok": {
            "const": false
          },
          "error": {
            "type": "object",
            "required": [
              "code",
              "message"
            ],
            "properties": {
              "code": {
                "enum": [
                  "invalid_json",
                  "invalid_argument",
                  "missing_argument",
                  "unknown_argument",
                  "out_of_range",
                  "internal_error"
                ]
              },
              "message": {
                "type": "string"
              },
              "field": {
                "type": "string"
              }
            }
          }
        }
      }
    ]
  },
  "privacy": "Uses only the arguments supplied: every relevant page input is replaced (omitted optional arguments clear their field), so earlier visitor input is never read into the result. Nothing is stored. Calculation or source matching runs in this page; arguments and results are not uploaded to Agoodeal servers or to Google Analytics, and the result is returned only to the calling agent. Non-sensitive usage metadata (tool name, outcome, execution mode, error code, duration; predefined source IDs for source matching) is reported through the site’s existing Google Analytics 4.",
  "coverage": "Monthly-rated employees covered by MPF; MPF offsetting split at 1 May 2025.",
  "limits": [
    "Does not decide eligibility by reason of leaving; not legal advice.",
    "Cases the page does not model return no amount."
  ],
  "officialSources": [
    {
      "id": "labour-sp-lsp-guide",
      "name": "勞工處：遣散費及長期服務金",
      "publisher": "Labour Department",
      "kind": "pdf_document",
      "url": "https://www.labour.gov.hk/tc/public/pdf/wcp/ConciseGuide/11.pdf"
    },
    {
      "id": "labour-offsetting-faq",
      "name": "勞工處：取消對沖常見問題",
      "publisher": "Labour Department",
      "kind": "web_page",
      "url": "https://www.op.labour.gov.hk/tc/faq.html"
    }
  ],
  "agoodealPage": "https://www.agoodeal.com/tools/severance-long-service-payment-calculator/"
}