Skip to content
Eden Engine

Earthquakes Near a Location by Radius (USGS)

usgs/earthquakes-near-point

Find earthquakes within a radius (up to 1000 km) of any latitude and longitude from the U.S. Geological Survey's catalog, with a minimum magnitude as low as 1, newest first or largest first: magnitude, place, UTC time, longitude, latitude, depth in kilometres, USGS event id and 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-near-point" })

// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "usgs/earthquakes-near-point" })

// 4. run: price the exact call first, then run it
omnial_execute({ tool: "usgs/earthquakes-near-point", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "usgs/earthquakes-near-point", input: { /* ... */ } })

// 5. settle: the call is charged when it finishes, nothing to do

Not 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.

ChargePrice
Per call
$0.00273
Updated
Oct 18, 2026

Input and output schemas

Input schema
input_schema.json
{
  "type": "object",
  "required": [
    "latitude",
    "longitude"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "default": 20,
      "maximum": 200,
      "minimum": 1,
      "description": "How many earthquakes to return, 1 to 200. Defaults to 20. If more match, the first `limit` in the chosen order are returned and the rest are not reachable by this call: narrow the dates, shrink the radius 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)."
    },
    "latitude": {
      "type": "number",
      "maximum": 90,
      "minimum": -90,
      "description": "Latitude of the centre point in decimal degrees, -90 to 90 (north is positive)."
    },
    "order_by": {
      "enum": [
        "time",
        "magnitude"
      ],
      "type": "string",
      "default": "time",
      "description": "time returns the newest first; magnitude returns the largest first, newest first among equals."
    },
    "longitude": {
      "type": "number",
      "maximum": 180,
      "minimum": -180,
      "description": "Longitude of the centre point in decimal degrees, -180 to 180 (east is positive, so the Americas are negative)."
    },
    "radius_km": {
      "type": "number",
      "default": 100,
      "maximum": 1000,
      "minimum": 1,
      "description": "Search radius around the point in kilometres, 1 to 1000. Defaults to 100."
    },
    "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",
      "default": 2.5,
      "maximum": 10,
      "minimum": 1,
      "description": "Smallest magnitude to include, 1 to 10. Defaults to 2.5."
    }
  },
  "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 within the radius, in the requested order.",
  "additionalProperties": true
}