Geography
Data source: OpenStreetMap / Overpass
MCP Protocol
Endpoint
https://context.gnist.ai/mcp/osm-poi/
claude_desktop_config.json
{
"mcpServers": {
"gnist-osm-poi": {
"url": "https://context.gnist.ai/mcp/osm-poi/",
"headers": {
"Gnist-API-Key": "YOUR_API_KEY"
}
}
}
}
Shell
curl -X POST "https://context.gnist.ai/mcp/osm-poi/" \
-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": "nearby_pois", "arguments": {"lat": 1.0, "lon": 1.0}}}'
REST API
API Root
https://context.gnist.ai/rest/osm-poi/
5 endpoints available:
GET /rest/osm-poi/nearby_poisGET /rest/osm-poi/search_poiGET /rest/osm-poi/get_poi_detailsGET /rest/osm-poi/count_poisGET /rest/osm-poi/report_feedback
Shell
curl "https://context.gnist.ai/rest/osm-poi/nearby_pois?lat=1.0&lon=1.0" \ -H "Gnist-API-Key: YOUR_API_KEY"
Python
import httpx
resp = httpx.get(
"https://context.gnist.ai/rest/osm-poi/nearby_pois",
headers={"Gnist-API-Key": "YOUR_API_KEY"},
params={
"lat": 1.0,
"lon": 1.0
},
)
print(resp.json())
Command Line
Command
gc osm-poi
CLI documentation will be available when the GnistAI SDK is published.
Install
pip install gnistai
Available Tools (5)
nearby_poisFind points of interest near a location.
| Parameter | Type | Required | Description |
|---|---|---|---|
lat | number | required | Latitude of the centre point (-90 to 90). |
lon | number | required | Longitude of the centre point (-180 to 180). |
radius_m | integer | optional | Search radius in metres (1–50000, default 500). (default: 500) |
poi_type | any | optional | Type of POI to filter by. Examples: "restaurant", "cafe", "hospital", "pharmacy", "hotel", "museum", "supermarket", "park", "ev_charger", "school", "bank", "parking". Omit t... |
max_results | integer | optional | Maximum number of results (1–100, default 20). (default: 20) |
search_poiSearch for POIs by name across OpenStreetMap.
| Parameter | Type | Required | Description |
|---|---|---|---|
name_query | string | required | Name or partial name to search for (e.g. "Starbucks", "IKEA"). |
country_code | any | optional | ISO 3166-1 alpha-2 country code to restrict results (e.g. "NO" for Norway, "GB" for UK, "US" for United States). Omit for global search (slower, may time out for common names). |
max_results | integer | optional | Maximum number of results (1–50, default 20). (default: 20) |
get_poi_detailsGet full OSM tag data for a specific POI.
| Parameter | Type | Required | Description |
|---|---|---|---|
osm_id | string | required | OSM element identifier in the format "type/id", e.g. "node/12345" or "way/67890". Obtained from nearby_pois or search_poi results. |
count_poisCount POIs within a bounding box.
| Parameter | Type | Required | Description |
|---|---|---|---|
min_lat | number | required | Southern boundary latitude. |
min_lon | number | required | Western boundary longitude. |
max_lat | number | required | Northern boundary latitude. |
max_lon | number | required | Eastern boundary longitude. |
poi_type | any | optional | POI type to count (e.g. "restaurant", "ev_charger"). Omit to count all named POIs. |
report_feedbackReport a bug, feature request, or general feedback for this data source.
| Parameter | Type | Required | Description |
|---|---|---|---|
feedback | string | required | |
feedback_type | string | optional | (default: "general") |