{"openapi":"3.0.3","info":{"title":"Gnist Context — Earthquakes (USGS)","description":"Recent and historical earthquake data — magnitude, location, depth, and alerts.\n\n- **MCP endpoint:** `https://context.gnist.ai/mcp/earthquakes/`\n- **Toolkit page:** `/toolkits/earthquakes`\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/earthquakes/search_earthquakes":{"post":{"tags":["Environment"],"summary":"search_earthquakes","description":"Search earthquakes from the USGS seismic event database.\n\nQuery by magnitude range, date range, geographic bounding box, and depth.\nData is sourced from the USGS Earthquake Hazards Program and updated every minute.\n\nArgs:\n    min_magnitude: Minimum magnitude (e.g. 4.5 for significant quakes).\n    max_magnitude: Maximum magnitude.\n    start_time: Start date/time in ISO 8601 (e.g. \"2024-01-01\" or \"2024-01-01T00:00:00\").\n    end_time: End date/time in ISO 8601.\n    min_latitude: Southern boundary (-90 to 90).\n    max_latitude: Northern boundary (-90 to 90).\n    min_longitude: Western boundary (-180 to 180).\n    max_longitude: Eastern boundary (-180 to 180).\n    min_depth: Minimum depth in km.\n    max_depth: Maximum depth in km.\n    limit: Maximum results to return (1-200, default 20).\n    order_by: Sort order — \"time\" (newest first), \"time-asc\", \"magnitude\", \"magnitude-asc\".\n\nReturns:\n    Dict with 'count' and 'results' list of earthquakes. Each earthquake includes\n    magnitude, location (place, lat/lon), depth, time, alert level, tsunami flag,\n    and a USGS detail URL.","operationId":"earthquakes_search_earthquakes","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":false,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"min_magnitude":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Minimum magnitude (e.g. 4.5 for significant quakes)."},"max_magnitude":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Maximum magnitude."},"start_time":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Start date/time in ISO 8601 (e.g. \"2024-01-01\" or \"2024-01-01T00:00:00\")."},"end_time":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"End date/time in ISO 8601."},"min_latitude":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Southern boundary (-90 to 90)."},"max_latitude":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Northern boundary (-90 to 90)."},"min_longitude":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Western boundary (-180 to 180)."},"max_longitude":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Eastern boundary (-180 to 180)."},"min_depth":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Minimum depth in km."},"max_depth":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Maximum depth in km."},"limit":{"default":20,"description":"Maximum results to return (1-200, default 20).","type":"integer"},"order_by":{"default":"time","description":"Sort order — \"time\" (newest first), \"time-asc\", \"magnitude\", \"magnitude-asc\".","type":"string"}},"type":"object"}}}}}},"/rest/earthquakes/get_earthquake":{"post":{"tags":["Environment"],"summary":"get_earthquake","description":"Get detailed information about a specific earthquake by its USGS event ID.\n\nArgs:\n    event_id: The USGS event identifier (e.g. \"us7000n7q6\").\n\nReturns:\n    Dict with earthquake details including magnitude, location, depth, time,\n    felt reports count, alert level (green/yellow/orange/red), tsunami flag,\n    and the USGS detail URL. Returns an error if the event is not found.","operationId":"earthquakes_get_earthquake","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":{"event_id":{"description":"The USGS event identifier (e.g. \"us7000n7q6\").","type":"string"}},"required":["event_id"],"type":"object"}}}}}},"/rest/earthquakes/latest_earthquakes":{"post":{"tags":["Environment"],"summary":"latest_earthquakes","description":"Get the latest significant earthquakes globally or near a specific location.\n\nBy default returns recent M4.5+ earthquakes worldwide. Optionally filter\nto a specific area by providing a center point and radius.\n\nArgs:\n    min_magnitude: Minimum magnitude threshold (default 4.5).\n    limit: Maximum results to return (1-100, default 10).\n    latitude: Center latitude for geographic filter (-90 to 90). Requires longitude.\n    longitude: Center longitude for geographic filter (-180 to 180). Requires latitude.\n    max_radius_km: Search radius in kilometers from the center point (default 500 if lat/lon given).\n\nReturns:\n    Dict with 'count' and 'results' list of recent earthquakes sorted by time (newest first).","operationId":"earthquakes_latest_earthquakes","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":false,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"min_magnitude":{"default":4.5,"description":"Minimum magnitude threshold (default 4.5).","type":"number"},"limit":{"default":10,"description":"Maximum results to return (1-100, default 10).","type":"integer"},"latitude":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Center latitude for geographic filter (-90 to 90). Requires longitude."},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Center longitude for geographic filter (-180 to 180). Requires latitude."},"max_radius_km":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"description":"Search radius in kilometers from the center point (default 500 if lat/lon given)."}},"type":"object"}}}}}},"/rest/earthquakes/report_feedback":{"post":{"tags":["Environment"],"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":"earthquakes_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":"Environment","description":"Data sources: Environment"}],"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."}}}}