Skip to content
Eden Engine

Earthquake Event Detail by USGS Event ID

usgs/earthquake-detail

Everything the U.S. Geological Survey holds for one earthquake, looked up by its USGS event id (for example us6000qw60): magnitude and scale, place, UTC time, longitude, latitude, depth in kilometres, review status, tsunami flag, significance score, felt reports and impact alert level when they exist, and a products list of the origin, shake map, felt-report and other records with their download links. Use the data fields; some linked images may not be public domain. 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/earthquake-detail" })

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

// 4. run: price the exact call first, then run it
omnial_execute({ tool: "usgs/earthquake-detail", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "usgs/earthquake-detail", 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": [
    "event_id"
  ],
  "properties": {
    "event_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_]{4,30}$",
      "description": "The USGS event id: the `id` of a feature from the earthquake search tools, for example us6000qw60 or nc75451511. An id the USGS does not hold is a validation error."
    }
  },
  "additionalProperties": false
}
Output schema
output_schema.json
{
  "type": "object",
  "required": [
    "type",
    "id",
    "properties",
    "geometry"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "The USGS event id."
    },
    "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": {
        "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": "The event type, for example earthquake or quarry blast."
        },
        "alert": {
          "type": [
            "string",
            "null"
          ],
          "description": "PAGER alert level (green, yellow, orange, red), if issued."
        },
        "place": {
          "type": [
            "string",
            "null"
          ],
          "description": "Nearest place or the event's name."
        },
        "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)."
        },
        "products": {
          "type": "object",
          "description": "Every product the USGS holds for the event, keyed by product type (origin, phase-data, nearby-cities, shakemap, dyfi, losspager and others, depending on the event). Each value is a list of product records; `contents` maps a file name to its download `url`. Some linked files are images.",
          "additionalProperties": true
        }
      },
      "additionalProperties": true
    }
  },
  "description": "A single GeoJSON Feature exactly as the USGS sends it for one event: core fields under properties, the point under geometry.",
  "additionalProperties": true
}