`get_earthquakes`

Pack: science · Endpoint: https://gateway.pipeworx.io/science/mcp

Retrieve up to 20 globally recent earthquakes from the USGS FDSN service, filtered by lookback period (1–30 days, default 1) and minimum magnitude (default 4.0). Returns magnitude, location name, depth (km), coordinates, time, and tsunami warning flag.

Parameters

Name	Type	Required	Description
`days`	number	no	Look back N days (1-30, default 1)
`min_magnitude`	number	no	Minimum magnitude (default 4.0)

Example call

Arguments

{
  "days": 7,
  "min_magnitude": 5
}

curl

curl -X POST https://gateway.pipeworx.io/science/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_earthquakes","arguments":{"days":7,"min_magnitude":5}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('get_earthquakes', {
  "days": 7,
  "min_magnitude": 5
});

More examples

{
  "days": 1
}

Response shape

Always returns: count, earthquakes

Field	Type	Description
`count`	number	Total number of earthquakes found
`earthquakes`	array	List of earthquake events

Full JSON Schema

{
  "type": "object",
  "properties": {
    "count": {
      "type": "number",
      "description": "Total number of earthquakes found"
    },
    "earthquakes": {
      "type": "array",
      "description": "List of earthquake events",
      "items": {
        "type": "object",
        "properties": {
          "magnitude": {
            "type": "number",
            "description": "Earthquake magnitude"
          },
          "location": {
            "type": "string",
            "description": "Geographic location description"
          },
          "time": {
            "type": "string",
            "description": "ISO 8601 timestamp of event"
          },
          "latitude": {
            "type": "number",
            "description": "Event latitude"
          },
          "longitude": {
            "type": "number",
            "description": "Event longitude"
          },
          "depth_km": {
            "type": "number",
            "description": "Depth in kilometers"
          },
          "tsunami_warning": {
            "type": "boolean",
            "description": "Whether tsunami warning was issued"
          },
          "details_url": {
            "type": "string",
            "description": "URL to USGS event details"
          }
        },
        "required": [
          "magnitude",
          "location",
          "time",
          "latitude",
          "longitude",
          "depth_km",
          "tsunami_warning",
          "details_url"
        ]
      }
    }
  },
  "required": [
    "count",
    "earthquakes"
  ]
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "science": {
      "url": "https://gateway.pipeworx.io/science/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

get_earthquakes