Earthquakes Worldwide by Magnitude and Date (USGS)
usgs/earthquakes-search
Search the U.S. Geological Survey's earthquake catalog for the whole world: every earthquake of magnitude 4.5 or more in a date range, newest first or largest first, each with magnitude, place, UTC time, longitude, latitude, depth in kilometres, USGS event id, tsunami flag and the USGS review status. With no dates it covers the last 30 days. Preliminary (automatic) events are revised or removed later. U.S. Geological Survey data, passed through unmodified and served by Omnial; not an official USGS product.
activeper callv1
Price
$0.00273 per call
You pay the price shown. If a call turns out to cost more than its quote, you pay the actual price, capped at twice the quote. No monthly minimum. Top-ups start at $5.
Data source
U.S. Geological Survey
Data from the U.S. Geological Survey (USGS), U.S. Department of the Interior, public domain per usgs.gov/information-policies-and-instructions/copyrights-and-credits. Credit: U.S. Geological Survey Department of the Interior/USGS. Served by Omnial; not an official USGS product.
Use it
Five steps: search, inspect, learn, run, settle. No per-tool setup; your agent reaches this tool through the meta-tools it already has.
Connect once and your AI can find and run this tool, and any other it needs.
agent
// 1. search: find the tool
omnial_search({ query: "what you need" })
// 2. inspect: price and input schema
omnial_inspect({ tool: "usgs/earthquakes-search" })
// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "usgs/earthquakes-search" })
// 4. run: price the exact call first, then run it
omnial_execute({ tool: "usgs/earthquakes-search", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "usgs/earthquakes-search", input: { /* ... */ } })
// 5. settle: the call is charged when it finishes, nothing to doNot connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.
Pricing
Every charge this tool can incur.
| Charge | Price |
|---|---|
Per call | $0.00273 |
- Updated
- Oct 18, 2026
Input and output schemas
Input schema
input_schema.json
{
"type": "object",
"required": [
"min_magnitude",
"limit"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 200,
"minimum": 1,
"description": "How many earthquakes to return, 1 to 200. If more match, the first `limit` in the chosen order are returned and the rest are not reachable by this call: narrow the dates or raise the magnitude."
},
"end_date": {
"type": "string",
"pattern": "^[0-9]{4}-(0[1-9]|1[0-2])-(0[1-9]|[12][0-9]|3[01])$",
"description": "Latest event date to include, YYYY-MM-DD, read as 00:00 UTC, so a one-day search needs the next day here. Leave it out for no upper bound (now)."
},
"order_by": {
"enum": [
"time",
"magnitude"
],
"type": "string",
"default": "time",
"description": "time returns the newest first; magnitude returns the largest first, newest first among equals."
},
"start_date": {
"type": "string",
"pattern": "^[0-9]{4}-(0[1-9]|1[0-2])-(0[1-9]|[12][0-9]|3[01])$",
"description": "Earliest event date to include, YYYY-MM-DD, read as 00:00 UTC. Leave it out for the last 30 days."
},
"min_magnitude": {
"type": "number",
"maximum": 10,
"minimum": 4.5,
"description": "Smallest magnitude to include, 4.5 to 10. By the USGS's 2025 counts, 4.5 and up is about 700 earthquakes a month worldwide, 6 and up about 12 a month, and 7 and up about 16 a year. For smaller earthquakes near one place use the radius search tool."
}
},
"additionalProperties": false
}Output schema
output_schema.json
{
"type": "object",
"required": [
"type",
"metadata",
"features"
],
"properties": {
"bbox": {
"type": "array",
"items": {
"type": "number"
},
"description": "The bounding box of the result: [minLongitude, minLatitude, minDepth, maxLongitude, maxLatitude, maxDepth]. Absent when nothing matches."
},
"type": {
"type": "string",
"description": "Always FeatureCollection."
},
"features": {
"type": "array",
"items": {
"type": "object",
"required": [
"type",
"id",
"properties",
"geometry"
],
"properties": {
"id": {
"type": "string",
"description": "The USGS event id, for example us7000abcd. Pass it to the earthquake detail tool."
},
"type": {
"type": "string",
"description": "Always Feature."
},
"geometry": {
"type": "object",
"properties": {
"type": {
"type": "string",
"description": "Always Point."
},
"coordinates": {
"type": "array",
"items": {
"type": "number"
},
"description": "[longitude, latitude, depth in kilometres], in that order."
}
},
"additionalProperties": true
},
"properties": {
"type": "object",
"properties": {
"tz": {
"type": [
"integer",
"null"
],
"description": "Reserved by the USGS; null in the 2026-10-18 captures."
},
"cdi": {
"type": [
"number",
"null"
],
"description": "Maximum community-reported intensity, if any."
},
"gap": {
"type": [
"number",
"null"
]
},
"ids": {
"type": "string"
},
"mag": {
"type": [
"number",
"null"
],
"description": "Magnitude. Null when the USGS has not assigned one."
},
"mmi": {
"type": [
"number",
"null"
],
"description": "Maximum instrumental intensity, if any."
},
"net": {
"type": "string",
"description": "The contributing seismic network's code."
},
"nst": {
"type": [
"integer",
"null"
],
"description": "Number of seismic stations used."
},
"rms": {
"type": [
"number",
"null"
]
},
"sig": {
"type": "integer",
"description": "USGS significance score; larger means a more significant event, from magnitude, felt reports and estimated impact."
},
"url": {
"type": "string",
"description": "The USGS event page."
},
"code": {
"type": "string"
},
"dmin": {
"type": [
"number",
"null"
]
},
"felt": {
"type": [
"integer",
"null"
],
"description": "Number of 'Did You Feel It?' reports, if any."
},
"time": {
"type": "integer",
"description": "Origin time, ms since the Unix epoch (UTC)."
},
"type": {
"type": "string",
"description": "earthquake for every result of this tool."
},
"alert": {
"type": [
"string",
"null"
],
"description": "PAGER alert level (green, yellow, orange, red), if issued."
},
"place": {
"type": [
"string",
"null"
],
"description": "Nearest place, for example '10 km SW of Tres Pinos, CA'."
},
"title": {
"type": "string",
"description": "Magnitude and place as one line."
},
"types": {
"type": "string"
},
"detail": {
"type": "string",
"description": "The USGS event detail query URL."
},
"status": {
"type": "string",
"description": "automatic (not yet reviewed, may be revised or deleted) or reviewed."
},
"magType": {
"type": [
"string",
"null"
],
"description": "Magnitude scale, for example mww, mb, ml, md."
},
"sources": {
"type": "string"
},
"tsunami": {
"type": "integer",
"description": "1 for large events in oceanic regions, 0 otherwise. It does not say that a tsunami happened or will, and it is not a tsunami warning."
},
"updated": {
"type": "integer",
"description": "When the USGS last revised this event, ms since the Unix epoch (UTC)."
}
},
"additionalProperties": true
}
},
"additionalProperties": true
},
"description": "One feature per earthquake. Empty when nothing matches."
},
"metadata": {
"type": "object",
"properties": {
"api": {
"type": "string",
"description": "USGS event service version."
},
"url": {
"type": "string",
"description": "The USGS query URL that produced this result."
},
"count": {
"type": "integer",
"description": "Present on some responses only, for example 0 for an empty result."
},
"limit": {
"type": "integer"
},
"title": {
"type": "string"
},
"offset": {
"type": "integer"
},
"status": {
"type": "integer"
},
"generated": {
"type": "integer",
"description": "When the USGS produced this response, ms since the Unix epoch (UTC)."
}
},
"description": "The USGS's own description of the query. It echoes `limit` and `offset` and carries no total match count: `count` appears only on some responses, for example an empty result.",
"additionalProperties": true
}
},
"description": "A GeoJSON FeatureCollection exactly as the USGS sends it: a metadata block and one feature per earthquake in the requested order.",
"additionalProperties": true
}