`lookup`

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

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/lookup for the schema, then POST the same URL with its arguments for the data.

Get details for OpenStreetMap locations by ID (e.g., “N123456” for node, “W654321” for way, “R111” for relation). Returns coordinates, names, and metadata.

Parameters

Name	Type	Required	Description
`ids`	string	yes	Comma-separated list of OSM IDs with type prefix (e.g. “N123456,W654321”). N=node, W=way, R=relation.

Example call

Arguments

{
  "ids": "N123456,W654321"
}

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":"lookup","arguments":{"ids":"N123456,W654321"}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('lookup', {
  "ids": "N123456,W654321"
});

More examples

{
  "ids": "R111"
}

Response shape

Always returns: results

Field	Type	Description
`results`	array	Array of looked-up OSM objects

Full JSON Schema

{
  "type": "object",
  "properties": {
    "results": {
      "type": "array",
      "description": "Array of looked-up OSM objects",
      "items": {
        "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"
        ]
      }
    }
  },
  "required": [
    "results"
  ]
}

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.

lookup