`search_address`

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

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

Search for coordinates of an address or place name. Returns latitude, longitude, display name, and place type for matched locations.

Parameters

Name	Type	Required	Description
`query`	string	yes	Free-form address or place name to search for (e.g. “Eiffel Tower, Paris”).
`limit`	number	no	Maximum number of results to return. Defaults to 5, max 50.

Example call

Arguments

{
  "query": "Eiffel Tower, Paris"
}

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":"search_address","arguments":{"query":"Eiffel Tower, Paris"}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('search_address', {
  "query": "Eiffel Tower, Paris"
});

More examples

{
  "query": "1600 Pennsylvania Avenue, Washington DC",
  "limit": 10
}

Response shape

Always returns: results

Field	Type	Description
`results`	array	Array of matched locations

Full JSON Schema

{
  "type": "object",
  "properties": {
    "results": {
      "type": "array",
      "description": "Array of matched locations",
      "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.

search_address