fdsn_events
Pack: earthscope-fdsn · Endpoint: https://gateway.pipeworx.io/earthscope-fdsn/mcp
No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/fdsn_events for the schema, then POST the same URL with its arguments for the data.
“What small earthquakes happened near Etna this week?” — earthquake catalogues published by REGIONAL seismological agencies over the FDSN standard: GFZ GEOFON (global rapid solutions), INGV (Italy, down to about M0.5), RESIF (France), KOERI (Turkey and the eastern Mediterranean). Complements the global catalogues — these agencies list the local magnitude-1-to-3 events that USGS and EMSC never publish. Returns event id, origin time, latitude/longitude/depth, magnitude and magnitude type, region name and event type.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
datacenter | string | no | Which agency catalogue: “gfz” (default, global), “ingv” (Italy), “resif” (France), “koeri” (Turkey). |
starttime | string | no | Earliest origin time, YYYY-MM-DD (default: 30 days ago). |
endtime | string | no | Latest origin time, YYYY-MM-DD. |
min_magnitude | number | no | Minimum magnitude. |
max_magnitude | number | no | Maximum magnitude. |
min_depth_km | number | no | Minimum hypocentre depth in km. |
max_depth_km | number | no | Maximum hypocentre depth in km. |
latitude | number | no | Centre latitude for a radial search. |
longitude | number | no | Centre longitude for a radial search. |
max_radius_km | number | no | Radius in km around latitude/longitude. |
min_latitude | number | no | Bounding-box south edge. |
max_latitude | number | no | Bounding-box north edge. |
min_longitude | number | no | Bounding-box west edge. |
max_longitude | number | no | Bounding-box east edge. |
limit | number | no | Max events to return (default 50, max 500). |
Example call
Arguments
{
"datacenter": "ingv",
"starttime": "2026-09-10",
"min_magnitude": 2,
"limit": 5
}
curl
curl -X POST https://gateway.pipeworx.io/earthscope-fdsn/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"fdsn_events","arguments":{"datacenter":"ingv","starttime":"2026-09-10","min_magnitude":2,"limit":5}}}'
TypeScript (@pipeworx/sdk)
import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();
const result = await pipeworx.call('fdsn_events', {
"datacenter": "ingv",
"starttime": "2026-09-10",
"min_magnitude": 2,
"limit": 5
});
More examples
{
"datacenter": "gfz",
"starttime": "2026-09-01",
"min_magnitude": 5.5,
"limit": 20
}
Connect
Add this to your MCP client config, or use one-click install buttons:
{
"mcpServers": {
"earthscope-fdsn": {
"url": "https://gateway.pipeworx.io/earthscope-fdsn/mcp"
}
}
}
See Getting Started for client-specific install steps.