Standardise address
standardise_addressConverts free-text addresses into a standardized, geocoded location with a location_id for property risk screening, returning match status, gaps, and US risk enrichment.
Instructions
Turn a free-text address into one standardised, geocoded location with a location_id.
country is an ISO 3166 alpha-3 code (USA, IND, GBR, ...). Returns status 'matched' (use location.location_id next), 'ambiguous' (ask the user to choose from candidates) or 'no_match'. Missing components are listed in gaps. Risk enrichment covers US addresses only; elsewhere the risk blocks come back as gaps.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"address": "<address>"
},
"name": "standardise_address"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| address | Yes | ||
| country | No | USA |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| gaps | No | ||
| input | Yes | ||
| status | Yes | ||
| location | No | Set only when status is 'matched' | |
| warnings | No | Input the provider corrected (e.g. a different ZIP): confirm with the applicant | |
| candidates | No | Set when status is 'ambiguous': ask the user which one, do not pick | |
| provenance | Yes |