`get_alerts`

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

Active NWS watches / warnings / advisories. Filter by US state (2-letter code), point (lat,lon), severity, or status. Returns event name, severity, urgency, headline, description, affected areas, and effective/expires times.

Parameters

Name	Type	Required	Description
`area`	string	no	2-letter US state/territory code (e.g., “CA”, “TX”)
`latitude`	number	no	Latitude (use with longitude for point query)
`longitude`	number	no	Longitude (use with latitude for point query)
`severity`	string	no	Extreme \| Severe \| Moderate \| Minor \| Unknown
`urgency`	string	no	Immediate \| Expected \| Future \| Past \| Unknown
`event`	string	no	Restrict to a specific event type (e.g., “Tornado Warning”)
`limit`	number	no	Cap alerts returned (default 50, max 500)

Example call

Arguments

{
  "area": "TX"
}

curl

curl -X POST https://gateway.pipeworx.io/nws/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_alerts","arguments":{"area":"TX"}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('get_alerts', {
  "area": "TX"
});

More examples

{
  "latitude": 40.7128,
  "longitude": -74.006,
  "severity": "Severe",
  "urgency": "Immediate"
}

{
  "event": "Tornado Warning",
  "limit": 20
}

Response shape

Always returns: count, alerts

Field	Type	Description
`count`	number	Total number of alerts returned
`alerts`	array

Full JSON Schema

{
  "type": "object",
  "properties": {
    "count": {
      "type": "number",
      "description": "Total number of alerts returned"
    },
    "alerts": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": [
              "string",
              "null"
            ],
            "description": "Alert identifier"
          },
          "event": {
            "type": [
              "string",
              "null"
            ],
            "description": "Event type (e.g. Tornado Warning)"
          },
          "severity": {
            "type": [
              "string",
              "null"
            ],
            "description": "Extreme/Severe/Moderate/Minor"
          },
          "urgency": {
            "type": [
              "string",
              "null"
            ],
            "description": "Immediate/Expected/Future/Past"
          },
          "certainty": {
            "type": [
              "string",
              "null"
            ],
            "description": "Certainty level"
          },
          "status": {
            "type": [
              "string",
              "null"
            ],
            "description": "Alert status"
          },
          "category": {
            "type": [
              "string",
              "null"
            ],
            "description": "Alert category"
          },
          "headline": {
            "type": [
              "string",
              "null"
            ],
            "description": "Alert headline"
          },
          "description": {
            "type": [
              "string",
              "null"
            ],
            "description": "Full alert description"
          },
          "instruction": {
            "type": [
              "string",
              "null"
            ],
            "description": "Safety instructions"
          },
          "area": {
            "type": [
              "string",
              "null"
            ],
            "description": "Affected area description"
          },
          "sender": {
            "type": [
              "string",
              "null"
            ],
            "description": "Issuing organization"
          },
          "response": {
            "type": [
              "string",
              "null"
            ],
            "description": "Recommended response type"
          },
          "sent": {
            "type": [
              "string",
              "null"
            ],
            "description": "Sent time ISO 8601"
          },
          "effective": {
            "type": [
              "string",
              "null"
            ],
            "description": "Effective time ISO 8601"
          },
          "onset": {
            "type": [
              "string",
              "null"
            ],
            "description": "Onset time ISO 8601"
          },
          "expires": {
            "type": [
              "string",
              "null"
            ],
            "description": "Expiration time ISO 8601"
          },
          "ends": {
            "type": [
              "string",
              "null"
            ],
            "description": "End time ISO 8601"
          }
        }
      }
    }
  },
  "required": [
    "count",
    "alerts"
  ]
}

Connect

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

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

See Getting Started for client-specific install steps.

get_alerts