# Geodistance

> Geodistance is a freemium MCP server for maps and travel. Great-circle distance, bearing, destination points and DMS coordinate conversion. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $49 a month
- **Platforms:** API, Web, self-hosted
- **Website:** https://pipeworx.io/packs/geodistance
- **Repository:** https://github.com/pipeworx-io/mcp-geodistance
- **MCP Registry name:** io.github.pipeworx-io/geodistance
- **Categories:** [maps and travel](https://ai-powered.com/categories/maps-and-travel)
- **Listing updated:** 2026-11-18

## About

The README describes four geodesy operations exposed over MCP: haversine distance with bearing between two lat/lon points, destination-point projection from a start point, bearing and distance, and conversion between degrees-minutes-seconds strings and decimal degrees in both directions. Distance results come back in kilometres, miles, nautical miles, metres and feet, and the destination tool accepts several units.

The server is a thin client to the Pipeworx gateway rather than a local library, so each call travels over the network. The README is explicit that it needs network access and has no offline mode, even though the marketing copy on the pack page uses the word offline.

It suits developers and agents that need coordinate arithmetic inside an assistant workflow, such as checking how far apart two locations are or turning coordinates copied from a map into decimal form. Calls can be anonymous with a daily cap, or made with an optional Pipeworx API key for a higher limit.

## Features

- **Haversine distance and bearing:** Computes great-circle distance between two lat/lon points in several units along with the initial compass bearing.
- **Destination point projection:** Given a start point, bearing and distance, returns the destination coordinates in km, miles, nautical miles, metres or feet.
- **DMS to decimal conversion:** Parses degree-minute-second strings with hemisphere letters or plain decimal input into decimal degrees.
- **Decimal to DMS conversion:** Turns decimal latitude and longitude values into degrees-minutes-seconds strings.

## Good for

- Calculating the straight-line distance between two cities or sites from coordinates
- Converting coordinates copied from a map or document into decimal form for other tools
- Projecting a point a given distance and bearing away from a known location
- Adding geodesic calculations to an AI assistant without writing a local geo library

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http geodistance https://gateway.pipeworx.io/geodistance/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://gateway.pipeworx.io/geodistance/mcp
```

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "geodistance": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/geodistance/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "geodistance": {
      "serverUrl": "https://gateway.pipeworx.io/geodistance/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "geodistance": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/geodistance/mcp"
    }
  }
}
```

## Tools

- `distance`: Great-circle (haversine) distance between two lat/lon points, with initial bearing.
- `destination`: Destination point from a start lat/lon, bearing and distance.
- `dms_to_decimal`: Parses a degrees-minutes-seconds string to decimal degrees.
- `decimal_to_dms`: Converts decimal lat/lon to degrees-minutes-seconds strings.

## FAQ

### Does it work offline?

No. The README says the stdio bridge forwards every call to the Pipeworx gateway and that it needs network access, with no offline mode.

### Is an API key required?

No. Without a key calls are anonymous and capped at 50 per day. A free Pipeworx account raises the cap to 200 per day.

### Which units does the distance tool return?

The README lists kilometres, miles, nautical miles, metres and feet, plus the initial compass bearing.

### Is Geodistance free?

Geodistance has a free plan, with paid plans for more usage or features. Paid plans start at $49 a month.

### How do I add Geodistance to Claude Code?

Run this command in your terminal: claude mcp add --transport http geodistance https://gateway.pipeworx.io/geodistance/mcp

### What are the best alternatives to Geodistance?

The closest alternatives to Geodistance are Coordinates, Geohash, Openrouteservice, Mapbox and What3words.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Coordinates](https://ai-powered.com/mcp/coordinates): Coordinates is a freemium MCP server for maps and travel.
- [Geohash](https://ai-powered.com/mcp/geohash): Geohash is a freemium MCP server for maps and travel.
- [Openrouteservice](https://ai-powered.com/mcp/openrouteservice): Openrouteservice is a freemium MCP server for maps and travel.
- [Mapbox](https://ai-powered.com/mcp/mapbox): Mapbox is a freemium MCP server for maps and travel.
- [What3words](https://ai-powered.com/mcp/what3words): What3words is a freemium MCP server for maps and travel.
- [Maptiler](https://ai-powered.com/mcp/maptiler): Maptiler is a freemium MCP server for maps and travel.
- [Opencages](https://ai-powered.com/mcp/opencages): Opencages is a freemium MCP server for maps and travel.
- [Geoapify MCP by usefulapi](https://ai-powered.com/mcp/geoapify-mcp-by-usefulapi): Geoapify MCP by usefulapi is a freemium MCP server for maps and travel.

---
Source: https://ai-powered.com/mcp/geodistance
