Geocoding
Place name to coordinates and back, with country, population and timezone.
Offline geocoding (GeoNames + DB-IP, CC BY 4.0): exactly one of ip (IPv4/IPv6 -> country/region/city/lat,lon), q (place name, e.g. 'Springfield, IL, US', optional country filter), postcode (+country), or lat+lon (reverse: nearest places). City/place level; no street addresses.
What agents use it for
- Resolve addresses and city names
- Reverse-geocode GPS points
- Find a place's timezone
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
ip | string | no | Public IPv4/IPv6 address |
q | string | no | Place name; qualifiers after commas (region, country) |
postcode | string | no | Postal code to look up; combine with country for precision |
country | string | no | ISO alpha-2/3 or English name |
lat | number | no | Latitude in decimal degrees (-90 to 90) |
lon | number | no | Longitude in decimal degrees (-180 to 180) |
limit | integer · default 5 | no | Maximum number of results to return |
Call it
{
"name": "geocode",
"arguments": {
"q": "Paris, France"
}
}curl -i "https://api.ishob.com/v1/geocode?q=Paris%2C+France"
Paid with x402: the first call returns HTTP 402 with the price; an x402 client (for example @x402/fetch or @x402/mcp) signs a USDC payment and retries. Calls that fail are not charged.
Connect the MCP server: setup for Claude, Cursor and other clients.