{"openapi":"3.0.3","info":{"title":"Gnist Context — Nominatim Geocoding","description":"Forward and reverse geocoding — address to coordinates and coordinates to address.\n\n- **MCP endpoint:** `https://context.gnist.ai/mcp/nominatim/`\n- **Toolkit page:** `/toolkits/nominatim`\n- **Full API spec:** `/api/openapi.json`\n- **Get an API key:** `/signup`","version":"1.0.0","contact":{"name":"GnistAI","url":"https://gnist.ai"}},"servers":[{"url":"https://context.gnist.ai","description":"Production"}],"paths":{"/rest/nominatim/geocode_address":{"post":{"tags":["Geography"],"summary":"geocode_address","description":"Convert an address or place name to geographic coordinates.\n\nForward geocoding: searches OpenStreetMap for matching places and returns\ncoordinates, display name, and structured address components.\n\nArgs:\n    query: Address or place name (e.g. \"Buckingham Palace\", \"Karl Johans gate 22, Oslo\").\n    limit: Maximum results (1-20, default 5).","operationId":"nominatim_geocode_address","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"query":{"type":"string"},"limit":{"default":5,"type":"integer"}},"required":["query"],"type":"object"}}}}}},"/rest/nominatim/reverse_geocode":{"post":{"tags":["Geography"],"summary":"reverse_geocode","description":"Convert geographic coordinates to a human-readable address.\n\nReverse geocoding: looks up what's at the given latitude/longitude and\nreturns the full address with structured components.\n\nArgs:\n    lat: Latitude (-90 to 90, e.g. 59.9139 for Oslo).\n    lon: Longitude (-180 to 180, e.g. 10.7522 for Oslo).","operationId":"nominatim_reverse_geocode","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"lat":{"type":"number"},"lon":{"type":"number"}},"required":["lat","lon"],"type":"object"}}}}}},"/rest/nominatim/report_feedback":{"post":{"tags":["Geography"],"summary":"report_feedback","description":"Report a bug, feature request, or general feedback for this data source.\n\nUse this when something doesn't work as expected, when you'd like\na new feature, or when you have suggestions for improvement.\n\nArgs:\n    feedback: Describe the issue or suggestion.\n    feedback_type: One of 'bug', 'feature_request', or 'general'.","operationId":"nominatim_report_feedback","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"feedback":{"type":"string"},"feedback_type":{"default":"general","type":"string"}},"required":["feedback"],"type":"object"}}}}}}},"tags":[{"name":"Geography","description":"Data sources: Geography"}],"components":{"securitySchemes":{"ApiKeyHeader":{"type":"apiKey","in":"header","name":"gnist-api-key","description":"API key passed via request header."},"ApiKeyQuery":{"type":"apiKey","in":"query","name":"gnist_api_key","description":"API key passed via query parameter."}}}}