Skip to content
MCP server

Geodistance

Great-circle distance, bearing, destination points and DMS coordinate conversion

Install
Pricing
Freemium
Platforms
API, Web, self-hosted
Runs
Locally or Remotely
Version
0.2.1
Listing updated
today

Similar MCP servers

About Geodistance

Geodistance is a freemium MCP server for maps and travel. It can run locally on your machine or as a hosted remote server.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://gateway.pipeworx.io/geodistance/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "geodistance": {
      "url": "https://gateway.pipeworx.io/geodistance/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Configuration

  • PIPEWORX_API_KEYOptional Pipeworx API key. Without it calls are anonymous and capped daily; a free key raises the cap.

Tools this server provides (4)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Freemium, from $49 a month

Anonymous 50 calls/day; free account 200 calls/day; paid credits and subscriptions beyond that.

Prices change. Check pipeworx.io before you buy.

Geodistance 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.

How AIPoweredBot checks servers