Hong Kong Address Lookup (ALS)
alsgovhk/lookup-address
Looks up a plain-text Hong Kong address, building or estate name and returns up to 15 matching official premises addresses, best first, each in English and Traditional Chinese (building, estate, street, district, region) with WGS84 latitude and longitude, HK1980 Grid northing and easting, the Geospatial Address identifier and a match score. Hong Kong only. The text may not contain < or >. A query with no match returns just the request echo, with no SuggestedAddress.
Price
$0.0026 per call
You pay the price shown. If a call turns out to cost more than its quote, you pay the actual price, capped at twice the quote. No monthly minimum. Top-ups start at $0.50.
Data source
Hong Kong Address Lookup Service (DATA.GOV.HK)
Address data from the Address Lookup Service (ALS) of the Government of the Hong Kong Special Administrative Region, published through DATA.GOV.HK (https://data.gov.hk/en/terms-and-conditions). Credit the Government, the Relevant Organisations that provide the data, and DATA.GOV.HK. Served by Eden Engine; not an official Hong Kong Government product.
Use it
Five steps: search, inspect, learn, run, settle. No per-tool setup; your agent reaches this tool through the meta-tools it already has.
Connect once and your AI can find and run this tool, and any other it needs.
// 1. search: find the tool
omnial_search({ query: "what you need" })
// 2. inspect: price and input schema
omnial_inspect({ tool: "alsgovhk/lookup-address" })
// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "alsgovhk/lookup-address" })
// 4. run: price the exact call first, then run it
omnial_execute({ tool: "alsgovhk/lookup-address", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "alsgovhk/lookup-address", input: { /* ... */ } })
// 5. settle: the call is charged when it finishes, nothing to doNot connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.
Pricing
Every charge this tool can incur.
| Charge | Price |
|---|---|
Per call | $0.0026 |
- Updated
- Oct 21, 2026
Input and output schemas
Input schema
{
"type": "object",
"required": [
"q"
],
"properties": {
"n": {
"type": "integer",
"maximum": 15,
"minimum": 1,
"description": "Maximum matches to return, 1 to 15. The service returns at most 15 whatever is asked; when omitted it returns up to 15."
},
"q": {
"type": "string",
"pattern": "^[^<>]+$",
"maxLength": 200,
"minLength": 1,
"description": "Address text, building or estate name in English or Chinese, for example '1 Garden Road'. Up to 200 characters, without < or >."
}
},
"additionalProperties": false
}Output schema
{
"type": "object",
"required": [
"RequestAddress"
],
"properties": {
"RequestAddress": {
"type": "object",
"required": [
"AddressLine"
],
"properties": {
"AddressLine": {
"type": "array",
"items": {
"type": "string"
}
}
},
"description": "The address text as the service read it.",
"additionalProperties": true
},
"SuggestedAddress": {
"type": "array",
"items": {
"type": "object",
"required": [
"Address"
],
"properties": {
"Address": {
"type": "object",
"required": [
"PremisesAddress"
],
"properties": {
"PremisesAddress": {
"type": "object",
"required": [
"GeospatialInformation"
],
"properties": {
"GeoAddress": {
"type": "string",
"description": "The Geospatial Address identifier of the premises."
},
"ChiPremisesAddress": {
"type": "object",
"properties": {
"Region": {
"type": "string"
},
"BuildingName": {
"type": "string"
}
},
"description": "Traditional Chinese address parts, same layout as the English block.",
"additionalProperties": true
},
"EngPremisesAddress": {
"type": "object",
"properties": {
"Region": {
"type": "string",
"description": "HK, KLN or NT."
},
"EngEstate": {
"type": "object",
"properties": {
"EstateName": {
"type": "string"
}
},
"additionalProperties": true
},
"EngStreet": {
"type": "object",
"properties": {
"StreetName": {
"type": "string"
},
"BuildingNoFrom": {
"type": "string"
}
},
"additionalProperties": true
},
"EngDistrict": {
"type": "object",
"properties": {
"DcDistrict": {
"type": "string"
}
},
"additionalProperties": true
},
"BuildingName": {
"type": "string"
}
},
"description": "English address parts. Only the parts that exist for the premises are present.",
"additionalProperties": true
},
"GeospatialInformation": {
"type": "object",
"required": [
"Latitude",
"Longitude"
],
"properties": {
"Easting": {
"type": "string"
},
"Latitude": {
"type": "string"
},
"Northing": {
"type": "string"
},
"Longitude": {
"type": "string"
}
},
"description": "HK1980 Grid northing and easting and WGS84 latitude and longitude, all as strings.",
"additionalProperties": true
}
},
"additionalProperties": true
}
},
"additionalProperties": true
},
"ValidationInformation": {
"type": "object",
"properties": {
"Score": {
"type": "number",
"description": "Match score, 0 to 100."
}
},
"additionalProperties": true
}
},
"additionalProperties": true
},
"description": "Matches, best first. The key is absent when nothing matched."
}
},
"additionalProperties": true
}