`reverse_geocode`

Pack: nominatim · Endpoint: https://gateway.pipeworx.io/nominatim/mcp

Convert latitude/longitude coordinates to a human-readable address. Returns nearest address, place name, and administrative boundaries.

Parameters

Name	Type	Required	Description
`lat`	number	yes	Latitude in decimal degrees (e.g. 48.8584).
`lon`	number	yes	Longitude in decimal degrees (e.g. 2.2945).

Example call

Arguments

{
  "lat": 48.8584,
  "lon": 2.2945
}

curl

curl -X POST https://gateway.pipeworx.io/nominatim/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"reverse_geocode","arguments":{"lat":48.8584,"lon":2.2945}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('reverse_geocode', {
  "lat": 48.8584,
  "lon": 2.2945
});

More examples

{
  "lat": 40.7128,
  "lon": -74.006
}

Response shape

Always returns: place_id, osm_type, osm_id, lat, lon, display_name, type, importance

Field	Type	Description
`place_id`	number	Unique place identifier
`osm_type`	string	OpenStreetMap object type (node, way, relation)
`osm_id`	number	OpenStreetMap object ID
`lat`	number	Latitude in decimal degrees
`lon`	number	Longitude in decimal degrees
`display_name`	string	Human-readable address or place name
`type`	string	Place type (e.g., landmark, city, road)
`importance`	number	Importance score of the place
`address`	object	Address components as key-value pairs

Full JSON Schema

{
  "type": "object",
  "properties": {
    "place_id": {
      "type": "number",
      "description": "Unique place identifier"
    },
    "osm_type": {
      "type": "string",
      "description": "OpenStreetMap object type (node, way, relation)"
    },
    "osm_id": {
      "type": "number",
      "description": "OpenStreetMap object ID"
    },
    "lat": {
      "type": "number",
      "description": "Latitude in decimal degrees"
    },
    "lon": {
      "type": "number",
      "description": "Longitude in decimal degrees"
    },
    "display_name": {
      "type": "string",
      "description": "Human-readable address or place name"
    },
    "type": {
      "type": "string",
      "description": "Place type (e.g., landmark, city, road)"
    },
    "importance": {
      "type": "number",
      "description": "Importance score of the place"
    },
    "address": {
      "type": "object",
      "description": "Address components as key-value pairs",
      "additionalProperties": {
        "type": "string"
      }
    }
  },
  "required": [
    "place_id",
    "osm_type",
    "osm_id",
    "lat",
    "lon",
    "display_name",
    "type",
    "importance"
  ]
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "nominatim": {
      "url": "https://gateway.pipeworx.io/nominatim/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

reverse_geocode