GnistAI GnistAI
Log in

Nominatim Geocoding

Forward and reverse geocoding — address to coordinates and coordinates to address.

Overview   |   MCP Docs   |   API Docs   |   OpenAPI   |   Playground   |   Tutorial   |   Toolkits   |   Home
status: healthy status status healthy healthy tools: 3 tools tools 3 3 Geography

Data source: OpenStreetMap Nominatim

MCP MCP Protocol

Endpoint https://context.gnist.ai/mcp/nominatim/
claude_desktop_config.json
{
  "mcpServers": {
    "gnist-nominatim": {
      "url": "https://context.gnist.ai/mcp/nominatim/",
      "headers": {
        "Gnist-API-Key": "YOUR_API_KEY"
      }
    }
  }
}
Shell
curl -X POST "https://context.gnist.ai/mcp/nominatim/" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Gnist-API-Key: YOUR_API_KEY" \
  -d '{"jsonrpc": "2.0", "method": "tools/call", "id": 1, "params": {"name": "geocode_address", "arguments": {"query": "example"}}}'

API REST API

API Root https://context.gnist.ai/rest/nominatim/

3 endpoints available:

Shell
curl "https://context.gnist.ai/rest/nominatim/geocode_address?query=example" \
  -H "Gnist-API-Key: YOUR_API_KEY"
Python
import httpx

resp = httpx.get(
    "https://context.gnist.ai/rest/nominatim/geocode_address",
    headers={"Gnist-API-Key": "YOUR_API_KEY"},
    params={
        "query": "example"
},
)
print(resp.json())

OpenAPI Spec  ·  Full API Docs

CLI Command Line

Command gc nominatim

CLI documentation will be available when the GnistAI SDK is published.

Install
pip install gnistai

Available Tools (3)

geocode_address
Convert an address or place name to geographic coordinates.
ParameterTypeRequiredDescription
querystringrequired
limitintegeroptional (default: 5)
reverse_geocode
Convert geographic coordinates to a human-readable address.
ParameterTypeRequiredDescription
latnumberrequired
lonnumberrequired
report_feedback
Report a bug, feature request, or general feedback for this data source.
ParameterTypeRequiredDescription
feedbackstringrequired
feedback_typestringoptional (default: "general")

Related