Geocoding

FreeNot checked

An MCP server for forward geocoding via the Nominatim API (OpenStreetMap) with no API key required.

by jamesfiltness

GitHub Embed

About

An MCP server for forward geocoding via the Nominatim API (OpenStreetMap) with no API key required.

README

An MCP server for forward geocoding via the Nominatim API (OpenStreetMap). No API key required.

Usage

Claude CLI

claude mcp add --scope user geocoding -- npx -y geo-coding-mcp

Manual configuration

Add to your MCP config (e.g. claude_desktop_config.json):

{
  "mcpServers": {
    "geocoding": {
      "command": "npx",
      "args": ["-y", "geo-coding-mcp"]
    }
  }
}

Tool

`geocode`

Forward geocodes a free-form location query and returns matching places with coordinates and address details.

Parameters:

Name	Type	Required	Description
`q`	string	yes	Free-form search query, e.g. `"221B Baker Street, London"`
`limit`	number	no	Max results to return (1–40, default `5`)
`countrycodes`	string	no	Comma-separated ISO 3166-1 alpha-2 codes to filter by, e.g. `"gb,us"`
`addressdetails`	boolean	no	Include structured address breakdown (default `true`)
`viewbox`	string	no	Bounding box to boost results: `"x1,y1,x2,y2"` (min_lon,min_lat,max_lon,max_lat)
`bounded`	boolean	no	Restrict results to within the viewbox (requires `viewbox`)

Example response:

Geocoding results for: Big Ben, London
Found 3 result(s)
==================================================

[1] Big Ben, Westminster Bridge Road, Lambeth, London, Greater London, England, SE1 7PB, United Kingdom
    Lat: 51.5007325  Lon: -0.1246254
    Type: tourism/attraction  (importance: 0.7654)
    Address: tourism: Big Ben, road: Westminster Bridge Road, city: London, postcode: SE1 7PB, country: United Kingdom
...

Testing locally

npm run build
npx @modelcontextprotocol/inspector node ./build/index.js

License

MIT

from github.com/jamesfiltness/geocoding-mcp

Install Geocoding in Claude Desktop, Claude Code & Cursor

Recommended · one command, every IDE

unyly install geocoding-mcp

Installs into Claude Desktop, Claude Code, Cursor & VS Code — handles npx, uvx and build-from-source repos for you.

First time? Get the CLI: curl -fsSL https://unyly.org/install | sh

Or configure manually

Run in your terminal:

claude mcp add geocoding-mcp -- npx -y geo-coding-mcp

FAQ

Is Geocoding MCP free?

Yes, Geocoding MCP is free — one-click install via Unyly at no cost.

Does Geocoding need an API key?

No, Geocoding runs without API keys or environment variables.

Is Geocoding hosted or self-hosted?

A hosted option is available: Unyly runs the server in the cloud, no local setup required.

How do I install Geocoding in Claude Desktop, Claude Code or Cursor?

Open Geocoding on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.

Related MCPs

GitHub

PRs, issues, code search, CI status

by GitHub

Filesystem

Secure file operations with configurable access controls.

by Community

Memory

Knowledge graph-based persistent memory system.

by Community

Template MCP Server

A CLI tool to create a new Model Context Protocol server project with TypeScript support, dual transport options, and an extensible structure

by mcpdotdirect

Compare Geocoding with

GeocodingvsGitHub GeocodingvsFilesystem GeocodingvsMemory GeocodingvsTemplate MCP Server

Not sure what to pick?

Find your stack in 60 seconds

Author?

Embed badge for your README

Browse similar

All development MCPs