geocoding_search
Search OpenStreetMap places by free-text query or structured address fields and get coordinates, categories, and address details for location lookups.
Instructions
Search Nominatim places. Searches OpenStreetMap places by address. Pass either free-text q or structured fields (street, city, county, state, country, postalcode), not both. limit defaults to 10 and is clamped to 20; countrycodes restricts by ISO 3166-1 alpha-2 country. Each result has its display name, coordinates, category, type, bounding box, importance and address parts. No match returns 404.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "geocoding_search"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Free-text search query | |
| city | No | Structured city | |
| limit | No | Maximum results, defaults to 10 and clamps to 20 | |
| state | No | Structured state | |
| county | No | Structured county | |
| street | No | Structured street or house number | |
| country | No | Structured country | |
| extratags | No | Include OSM extra tags | |
| postalcode | No | Structured postal code | |
| namedetails | No | Include multilingual name details | |
| countrycodes | No | Comma-separated ISO 3166-1 alpha-2 country filters | |
| addressdetails | No | Include address details, defaults to true | |
| accept_language | No | Preferred result language, forwarded to Nominatim |