Geo

What geo does

The geo MCP server exposes five geographic utilities for agents and applications. It can resolve an address or place name into as many as five candidate coordinates, turn latitude and longitude into a postal location, retrieve country facts, determine a coordinate’s timezone, and return solar event data for a date.

Results are intended for common location workflows rather than spatial analysis. The available responses cover coordinate values, display names, place types, address components, country facts, timezone details, and daylight information.

How it works

The service combines several public data sources. Forward geocoding uses OpenStreetMap Nominatim. Timezone lookups use TimeAPI.io, while sunrise and sunset calculations come from the Sunrise-Sunset API. Country queries accept either a country name or an ISO code.

The timezone operation requires latitude and longitude; it does not convert a city name directly. Solar queries also use coordinates and accept an optional date in YYYY-MM-DD format. If no date is supplied, the service uses the current day.

A hosted connection is available through the Pipeworx gateway. The gateway endpoint lists the geographic tools together with shared Pipeworx meta-tools, whose exact scope is reported during MCP initialization. The same gateway can also expose the broader catalog, while ask_pipeworx can route natural-language questions to tools across that catalog.

Setup and configuration

For a remote MCP connection, configure an MCP client with the geo endpoint:

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

The package also supports local stdio use without a Pipeworx account:

{
  "mcpServers": {
    "geo": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-geo"]
    }
  }
}

Run npx -y @pipeworx/mcp-geo directly to verify that the local process starts. HTTP callers can invoke hosted tools through the Pipeworx /v1/tools/ API, including geo_geocode.

Tools and capabilities

• geocode: Finds up to five matching places for an address or name and returns latitude, longitude, a display label, and place type.
• reverse_geocode: Converts coordinates into street, city, country, and postal-code information.
• get_country: Returns a country’s capital, population, currency, languages, and bordering countries using a name or ISO code.
• get_timezone: Returns the IANA timezone, current local time, and UTC offset for supplied coordinates.
• get_sunrise_sunset: Returns sunrise, sunset, solar noon, civil twilight boundaries, and day length in seconds for coordinates and an optional date.

Limitations and notes

The geo MCP server does not provide a city-name shortcut for timezone requests; callers must first obtain coordinates when starting from a place name. Forward geocoding may return multiple candidates, so clients should select the appropriate result rather than assume the first match is correct.

The hosted pack endpoint includes shared gateway meta-tools in addition to the five geographic tools. The local stdio mode exposes only the geographic set. No environment variables are required by the documented setup examples, and the project is licensed under MIT.