Hong Kong housing MCP Server providing housing data tools, specifically private storage information from the Rating and Valuation Department
Single-tool server with minimal definition quality. The tool 'get_private_storage' has a basic description and schema, but lacks depth, parameter descriptions, output schema documentation, and error handling guidance. No tool annotations (readOnlyHint/destructiveHint), no documented output structure, and the optional 'year' parameter lacks meaningful constraint documentation. The description is adequately detailed for the data source but does not explain WHEN to use this tool, prerequisites, or the structure of returned data. Parameter description is generic ('Filter by specific year') and does not specify valid year ranges or formats. No recovery guidance for error cases (e.g., CSV fetch failure, invalid year input). The tool name 'get_private_storage' is acceptably verb-forward and clear, but the overall definition falls short of production baseline expectations.
Private Storage - Completions, Stock and Vacancy in Hong Kong. Data source: Rating and Valuation Department
Output schema not documented. Tool returns List[Dict] but no schema specifying which fields (e.g., 'Year', 'Completions', 'Stock', 'Vacancy') are present, types, or required. LLMs cannot plan downstream processing without knowing response structure.
Parameter description is too generic. 'Filter by specific year' does not specify valid year range (e.g., 2000-2024), format (integer only, no strings), or consequences of invalid input. LLMs may pass invalid values.
No error handling guidance. Tool calls external CSV from RVD; if fetch fails, network times out, or CSV format changes, LLM receives raw error dict with no recovery hint (e.g., 'Try again later' or 'Check data source availability'). Pattern: recovery-guide.
No tool annotations. Tool is read-only (no side effects), but lacks readOnlyHint in schema. This prevents clients from optimizing caching, logging, or safety policies based on tool semantics.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-22 | D | 54 | 2026-07-28+ | v2 |
| 2026-03-09 | F | 39 | - | v1 |
Tool description does not explain WHEN to use it or what the user gets. Current description is data-source focused ('Data source: Rating and Valuation Department') but does not guide LLM selection: 'Call this to retrieve historical and current private storage statistics (completions, stock, vacancy) for Hong Kong real estate market analysis.'
No pagination or result limiting documented. If CSV contains thousands of rows, tool returns all of them, risking context window exhaustion. No limit parameter, no documentation of typical row count or paging strategy.