Environment
Data source: USGS Earthquake Hazards
MCP Protocol
Endpoint
https://context.gnist.ai/mcp/earthquakes/
claude_desktop_config.json
{
"mcpServers": {
"gnist-earthquakes": {
"url": "https://context.gnist.ai/mcp/earthquakes/",
"headers": {
"Gnist-API-Key": "YOUR_API_KEY"
}
}
}
}
Shell
curl -X POST "https://context.gnist.ai/mcp/earthquakes/" \
-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": "get_earthquake", "arguments": {"event_id": "example"}}}'
REST API
API Root
https://context.gnist.ai/rest/earthquakes/
4 endpoints available:
GET /rest/earthquakes/search_earthquakesGET /rest/earthquakes/get_earthquakeGET /rest/earthquakes/latest_earthquakesGET /rest/earthquakes/report_feedback
Shell
curl "https://context.gnist.ai/rest/earthquakes/get_earthquake?event_id=example" \ -H "Gnist-API-Key: YOUR_API_KEY"
Python
import httpx
resp = httpx.get(
"https://context.gnist.ai/rest/earthquakes/get_earthquake",
headers={"Gnist-API-Key": "YOUR_API_KEY"},
params={
"event_id": "example"
},
)
print(resp.json())
Command Line
Command
gc earthquakes
CLI documentation will be available when the GnistAI SDK is published.
Install
pip install gnistai
Available Tools (4)
search_earthquakesSearch earthquakes from the USGS seismic event database.
| Parameter | Type | Required | Description |
|---|---|---|---|
min_magnitude | any | optional | Minimum magnitude (e.g. 4.5 for significant quakes). |
max_magnitude | any | optional | Maximum magnitude. |
start_time | any | optional | Start date/time in ISO 8601 (e.g. "2024-01-01" or "2024-01-01T00:00:00"). |
end_time | any | optional | End date/time in ISO 8601. |
min_latitude | any | optional | Southern boundary (-90 to 90). |
max_latitude | any | optional | Northern boundary (-90 to 90). |
min_longitude | any | optional | Western boundary (-180 to 180). |
max_longitude | any | optional | Eastern boundary (-180 to 180). |
min_depth | any | optional | Minimum depth in km. |
max_depth | any | optional | Maximum depth in km. |
limit | integer | optional | Maximum results to return (1-200, default 20). (default: 20) |
order_by | string | optional | Sort order — "time" (newest first), "time-asc", "magnitude", "magnitude-asc". (default: "time") |
get_earthquakeGet detailed information about a specific earthquake by its USGS event ID.
| Parameter | Type | Required | Description |
|---|---|---|---|
event_id | string | required | The USGS event identifier (e.g. "us7000n7q6"). |
latest_earthquakesGet the latest significant earthquakes globally or near a specific location.
| Parameter | Type | Required | Description |
|---|---|---|---|
min_magnitude | number | optional | Minimum magnitude threshold (default 4.5). (default: 4.5) |
limit | integer | optional | Maximum results to return (1-100, default 10). (default: 10) |
latitude | any | optional | Center latitude for geographic filter (-90 to 90). Requires longitude. |
longitude | any | optional | Center longitude for geographic filter (-180 to 180). Requires latitude. |
max_radius_km | any | optional | Search radius in kilometers from the center point (default 500 if lat/lon given). |
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") |