# geo [Health: Active]

**Category:** 🗺️ Location Services  
**Repository:** https://github.com/pipeworx-io/mcp-geo  
**GitHub Stars:** 1  
**npm Downloads (last month):** 415  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/geo-2

## Description
Geo MCP — geographic utilities from free public APIs

## Tools
Capabilities this server exposes over MCP:

- **geocode** — Convert an address or place name to up to 5 matching coordinates via OpenStreetMap Nominatim. Returns latitude, longitude, display_name, and place type for each result.
- **reverse_geocode** — Convert coordinates to a physical address. Returns street address, city, country, and postal code. Use to identify locations from lat/lng pairs.
- **get_country** — Get country information by name or ISO code (e.g., 'US', 'FR'). Returns capital, population, currency, languages, and neighboring countries. Use for regional context or facts.
- **get_timezone** — Look up the IANA timezone name, current local time, and UTC offset (hours) for a given latitude and longitude via TimeAPI.io. Requires coordinates — does not accept city names.
- **get_sunrise_sunset** — Fetch sunrise, sunset, solar noon, civil twilight begin/end, and day length (seconds) for a given latitude/longitude on an optional YYYY-MM-DD date (defaults to today) via the Sunrise-Sunset API.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

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

## Documentation

## 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:

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

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

```json
{
  "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.

_Full upstream README: https://allmcps.com/mcp/geo-2/readme_