Recent earthquakes

usgs_earthquakes.recent

FreeLive now

Earthquakes from the USGS worldwide catalog in the last 1-30 days, newest or biggest first, optionally within a radius of a place. Returns magnitude, place, time, depth, tsunami flag, PAGER alert and the USGS event page.

Inputs

Name	Type	Description
`min_magnitude`	number	Smallest magnitude to includedefault: 4.5; range: -1 to 10
`days`	integer	How many days back to searchdefault: 1; range: 1 to 30
`order`	string	one of: time, magnitude; default: "time"
`lat`	number	Optional: latitude to search around (give with lon)range: -90 to 90
`lon`	number	Optional: longitude to search around (give with lat)range: -180 to 180
`radius_km`	number	Search radius when lat/lon are givendefault: 500; range: 1 to 5000
`limit`	integer	default: 10; range: 1 to 50

Example output

{"query":{"min_magnitude":2.5,"days":7,"order":"time","lat":37.77,"lon":-122.42,"radius_km":200},"count":5,"earthquakes":[{"id":"nc75460382","magnitude":2.92,"mag_type":"md","place":"27 km WSW of Westley, CA","time":"2026-10-31T16:44:50.250Z","lat":37.4236679077148,"lon":-121.457664489746,"depth_km":2.4,"distance_km":93.1,"tsunami_flag":false,"pager_alert":null,"felt_reports":null,"status":"automatic","page":"https://earthquake.usgs.gov/earthquakes/eventpage/nc75460382"},{"id":"nc75459362","magnitude":2.67,"mag_type":"md","place":"12 km SW of Ridgemark, CA","time":"2026-10-29T12:38:05.010Z"...

Data license

Public domain · Earthquake data from the U.S. Geological Survey (public domain). Credit: U.S. Geological Survey. Source

Try it

…

Call it

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "usgs_earthquakes.recent",
    "arguments": {
      "min_magnitude": 2.5,
      "days": 7,
      "lat": 37.77,
      "lon": -122.42,
      "radius_km": 200,
      "limit": 5
    }
  }
}

curl -sS -X POST https://www.realworldmcp.com/api/call/usgs_earthquakes.recent \
  -H 'content-type: application/json' \
  -d '{"min_magnitude": 2.5, "days": 7, "lat": 37.77, "lon": -122.42, "radius_km": 200, "limit": 5}'

const res = await fetch("https://www.realworldmcp.com/api/call/usgs_earthquakes.recent", {
  method: "POST",
  headers: { "content-type": "application/json" },
  body: JSON.stringify({"min_magnitude": 2.5, "days": 7, "lat": 37.77, "lon": -122.42, "radius_km": 200, "limit": 5})
});
console.log(await res.json());