`geocode`

Pack: open-meteo · Endpoint: https://gateway.pipeworx.io/open-meteo/mcp

“What are the coordinates of [city]” / “lat lng for [place]” / “find [town] location” — resolve a place name (city, village, region) to lat/lng so the other Open-Meteo tools can use them. Free, keyless, multilingual; returns up to 100 matches ranked by population. Use before forecast / historical / air_quality / marine / flood when you only have a place name.

Parameters

Name	Type	Required	Description
`name`	string	yes	Place name (any language)
`count`	number	no	Max results, 1-100 (default 10)
`language`	string	no	ISO-639 lang for returned names (default en)

Example call

Arguments

{
  "name": "New York"
}

curl

curl -X POST https://gateway.pipeworx.io/open-meteo/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"geocode","arguments":{"name":"New York"}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('geocode', {
  "name": "New York"
});

More examples

{
  "name": "Paris",
  "count": 5,
  "language": "fr"
}

Response shape

Field	Type	Description
`results`	array	List of geocoding results
`generationtime_ms`	number	API response generation time in milliseconds

Full JSON Schema

{
  "type": "object",
  "properties": {
    "results": {
      "type": "array",
      "description": "List of geocoding results",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "description": "Unique identifier for this location"
          },
          "name": {
            "type": "string",
            "description": "Place name in requested language"
          },
          "latitude": {
            "type": "number",
            "description": "Geographic latitude"
          },
          "longitude": {
            "type": "number",
            "description": "Geographic longitude"
          },
          "elevation": {
            "type": "number",
            "description": "Elevation in meters"
          },
          "feature_code": {
            "type": "string",
            "description": "Geographic feature classification code"
          },
          "country_code": {
            "type": "string",
            "description": "ISO 3166-1 alpha-2 country code"
          },
          "admin1": {
            "type": "string",
            "description": "First-order administrative division"
          },
          "timezone": {
            "type": "string",
            "description": "IANA timezone string"
          },
          "population": {
            "type": "integer",
            "description": "Population of the location"
          },
          "country": {
            "type": "string",
            "description": "Country name in requested language"
          }
        }
      }
    },
    "generationtime_ms": {
      "type": "number",
      "description": "API response generation time in milliseconds"
    }
  }
}

Connect

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

{
  "mcpServers": {
    "open-meteo": {
      "url": "https://gateway.pipeworx.io/open-meteo/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

geocode