{ "descriptorVersion": "1.0.0", "name": "find_elderly_respite_sources", "title": "Elderly residential respite sources", "description": "Source discovery for Social Welfare Department residential respite homes for the elderly: returns the official Hong Kong government data sources (API, feed, file, PDF list or official service), their format, update notes, how to use them, limits and the matching Agoodeal page. Does not fetch or return live records, and is not a booking, diagnosis or eligibility service. No government data is fetched when it is called. Vacancies are checked in the SWD vacancy enquiry system; applying for the service needs a social worker referral. 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": "source_discovery", "pageUrls": [ "https://www.agoodeal.com/tools/elderly-respite-vacancies/", "https://www.agoodeal.com/tools/elderly-respite-vacancies/central-and-western/", "https://www.agoodeal.com/tools/elderly-respite-vacancies/wan-chai/", "https://www.agoodeal.com/tools/elderly-respite-vacancies/eastern/", "https://www.agoodeal.com/tools/elderly-respite-vacancies/southern/", "https://www.agoodeal.com/tools/elderly-respite-vacancies/yau-tsim-mong/", "https://www.agoodeal.com/tools/elderly-respite-vacancies/sham-shui-po/", "https://www.agoodeal.com/tools/elderly-respite-vacancies/kowloon-city/", "https://www.agoodeal.com/tools/elderly-respite-vacancies/wong-tai-sin/", "https://www.agoodeal.com/tools/elderly-respite-vacancies/kwun-tong/", "https://www.agoodeal.com/tools/elderly-respite-vacancies/tsuen-wan/", "https://www.agoodeal.com/tools/elderly-respite-vacancies/tuen-mun/", "https://www.agoodeal.com/tools/elderly-respite-vacancies/yuen-long/", "https://www.agoodeal.com/tools/elderly-respite-vacancies/north/", "https://www.agoodeal.com/tools/elderly-respite-vacancies/tai-po/", "https://www.agoodeal.com/tools/elderly-respite-vacancies/sai-kung/", "https://www.agoodeal.com/tools/elderly-respite-vacancies/sha-tin/", "https://www.agoodeal.com/tools/elderly-respite-vacancies/kwai-tsing/", "https://www.agoodeal.com/tools/elderly-respite-vacancies/islands/" ], "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": true, "untrustedContentHint": false, "consequentialHint": false }, "annotationNotes": "readOnlyHint is true: the tool only returns stored official source information and does not change the page.", "inputSchema": { "type": "object", "additionalProperties": false, "properties": { "topic": { "type": "string", "enum": [ "all", "home_list", "vacancy_enquiry", "how_to_apply" ], "description": "Which official source to return. Omit for all. home_list: Homes with respite places; vacancy_enquiry: Check vacancies (official system); how_to_apply: How to apply and fees." } } }, "outputSchema": { "oneOf": [ { "type": "object", "required": [ "ok", "tool", "mode", "liveDataFetched", "topic", "sources", "agoodealPage", "limits", "notice" ], "properties": { "ok": { "const": true }, "tool": { "type": "string" }, "mode": { "const": "source_discovery" }, "liveDataFetched": { "const": false }, "topic": { "type": "string" }, "pageScope": { "type": [ "string", "null" ] }, "notice": { "type": "string" }, "sources": { "type": "array", "maxItems": 5, "items": { "type": "object", "required": [ "id", "name", "publisher", "kind", "url", "agoodealUse", "updateFrequency" ], "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "publisher": { "type": "string" }, "kind": { "type": "string" }, "url": { "type": "string" }, "datasetUrl": { "type": "string" }, "documentationUrl": { "type": "string" }, "agoodealUse": { "type": "string" }, "updateFrequency": { "type": "string" } } } }, "agoodealPage": { "type": "string" }, "coverage": { "type": "string" }, "limits": { "type": "array", "items": { "type": "string" } }, "howToUse": { "type": "array", "items": { "type": "string" } }, "versionedContract": { "type": [ "object", "null" ] } } }, { "type": "object", "required": [ "ok", "error" ], "properties": { "ok": { "const": false }, "error": { "type": "object", "required": [ "code", "message" ], "properties": { "code": { "enum": [ "invalid_json", "invalid_argument", "unknown_argument", "internal_error" ] }, "message": { "type": "string" }, "field": { "type": "string" } } } } } ] }, "privacy": "Returns stored source records only; no government data is fetched per call and nothing from the page is read. 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": "SWD list of homes with designated residential respite places; district pages are limited to that official district.", "limits": [ "The list is a contact list, not live bed vacancies or a quality ranking.", "Service applications require a social worker referral (182 183)." ], "officialSources": [ { "id": "swd-respite-list", "name": "空置宿位查詢系統－長者住宿暫託服務（院舍名單）", "publisher": "Social Welfare Department", "kind": "xml_feed", "url": "https://www.ves.swd.gov.hk/sites/rrpvs-swd/files/rrse_list.xml" }, { "id": "swd-vacancy-enquiry", "name": "社署暫託服務／緊急住宿空置名額查詢系統", "publisher": "Social Welfare Department", "kind": "web_service", "url": "https://www.ves.swd.gov.hk/tc/rrse" }, { "id": "swd-respite-service", "name": "社署：長者住宿暫託服務（申請及收費）", "publisher": "Social Welfare Department", "kind": "web_page", "url": "https://www.swd.gov.hk/tc/pubsvc/elderly/cat_careersupp/drrr/respiteser/" } ], "agoodealPage": "https://www.agoodeal.com/tools/elderly-respite-vacancies/" }