Reverse Geocode Coordinates

The reverse_geocode_coordinates MCP tool converts latitude and longitude coordinates into nearby address or place data.

Use this tool when you already have coordinates and need to identify the nearest address, postcode, city, administrative area, amenity, or building.

Tool name

reverse_geocode_coordinates

Request URL

https://api.geoapify.com/v1/mcp?apiKey=YOUR_API_KEY

Input parameters

Name	Type	Required	Description
`lat`	number	Yes	Latitude of the coordinate to reverse geocode. Supported range: `-90` to `90`.
`lon`	number	Yes	Longitude of the coordinate to reverse geocode. Supported range: `-180` to `180`.
`limit`	integer	No	Maximum number of nearby address or place results to return. Supported range: `1` to `10`. Default: `1`.
`lang`	string	No	Result language as a supported two-letter language code. Default: `en`.
`type`	string	No	Optional result granularity. Supported values: `country`, `state`, `city`, `postcode`, `street`, `amenity`, `locality`, `building`.
`country_codes`	array of strings	No	Optional ISO 3166-1 alpha-2 country code filters. The array can contain up to 10 country codes.

The input schema does not allow additional properties.

Example request

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "reverse_geocode_coordinates",
    "arguments": {
      "lat": 38.897676,
      "lon": -77.03653,
      "limit": 1,
      "lang": "en",
      "type": "building"
    }
  }
}

City-level example

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "reverse_geocode_coordinates",
    "arguments": {
      "lat": 38.897676,
      "lon": -77.03653,
      "type": "city"
    }
  }
}

Response

The tool returns nearby address or place data for the provided coordinates. Use type to request a preferred result granularity and limit to control how many candidates the response can include.

Example response

{
  "jsonrpc": "2.0",
  "id": 4,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{ ... }"
      }
    ],
    "structuredContent": {
      "coordinates": {
        "lat": 52.52,
        "lon": 13.405
      },
      "count": 1,
      "results": [
        {
          "formatted": "Nordsee, Spandauer Strasse 4, 10178 Berlin, Germany",
          "address_line1": "Nordsee",
          "address_line2": "Spandauer Strasse 4, 10178 Berlin, Germany",
          "lon": 13.4049136,
          "lat": 52.5204075,
          "result_type": "amenity",
          "country": "Germany",
          "country_code": "de"
        }
      ]
    },
    "isError": false
  }
}

Related tools

Geocode Address - use when you have a free-text address and need coordinates.
Geocode Structured Address - use when address parts are already separated.

Related API

For direct HTTP API integration, see Reverse Geocoding API.