{
  "descriptorVersion": "1.0.0",
  "name": "check_public_housing_limits",
  "title": "Public rental housing income and asset limits check",
  "description": "Compare a household's monthly income and total net assets with the Hong Kong Housing Authority's 2026/27 public rental housing application limits on this page, using the page's own screening. Replaces every input on the page and shows the same result on screen. A preliminary number check only, not an eligibility decision. 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/public-housing-eligibility-check/"
    ],
    "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": [
      "householdType",
      "householdSize",
      "monthlyIncome",
      "totalNetAssets"
    ],
    "properties": {
      "householdType": {
        "type": "string",
        "enum": [
          "standard",
          "allElderly",
          "nonRelatedElderly"
        ],
        "description": "standard (ordinary family), allElderly (all members aged 60+), nonRelatedElderly (non-related elderly, 2+ persons)."
      },
      "householdSize": {
        "type": "integer",
        "minimum": 1,
        "maximum": 10,
        "description": "Number of household members; 10 means 10 or more."
      },
      "monthlyIncome": {
        "type": "number",
        "minimum": 0,
        "description": "Total monthly household income after statutory MPF contributions, HK$."
      },
      "totalNetAssets": {
        "type": "number",
        "minimum": 0,
        "description": "Total household net assets, HK$."
      }
    }
  },
  "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": "Housing Authority 2026/27 application limits for standard, all-elderly and non-related elderly households.",
  "limits": [
    "Preliminary number check only; not an eligibility decision.",
    "Existing tenants follow a different policy."
  ],
  "officialSources": [
    {
      "id": "ha-income-asset-limits",
      "name": "房委會：入息及資產限額",
      "publisher": "Hong Kong Housing Authority",
      "kind": "web_page",
      "url": "https://www.housingauthority.gov.hk/tc/flat-application/income-and-asset-limits/index.html"
    },
    {
      "id": "ha-application-guide",
      "name": "房委會：申請指引",
      "publisher": "Hong Kong Housing Authority",
      "kind": "web_page",
      "url": "https://www.housingauthority.gov.hk/tc/flat-application/application-guide/index.html"
    }
  ],
  "agoodealPage": "https://www.agoodeal.com/tools/public-housing-eligibility-check/"
}
