list_notices

Pack: usgs-volcano · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/list_notices for the schema, then POST the same URL with its arguments for the data.

Recent USGS volcano notices and reports, observatory updates, VAN (Volcano Activity Notice) and VONA (Volcano Observatory Notice for Aviation) text. Filter by volcano slug.

Parameters

NameTypeRequiredDescription
volcano_slugstringnoUSGS volcano slug (e.g., “kilauea”, “shishaldin”). Optional, omit for all recent.
limitnumbernoCap notices returned (default 50)

Example call

Arguments

{}

curl

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

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('list_notices', {});

More examples

{
  "volcano_slug": "kilauea",
  "limit": 10
}

Response shape

Always returns: volcano_slug, count, notices

FieldTypeDescription
volcano_slugstring | nullFiltered volcano slug if provided, otherwise null
countnumberNumber of notices returned
noticesarrayList of volcano notices and alerts
Full JSON Schema
{
  "type": "object",
  "properties": {
    "volcano_slug": {
      "type": [
        "string",
        "null"
      ],
      "description": "Filtered volcano slug if provided, otherwise null"
    },
    "count": {
      "type": "number",
      "description": "Number of notices returned"
    },
    "notices": {
      "type": "array",
      "description": "List of volcano notices and alerts",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": [
              "string",
              "null"
            ],
            "description": "Notice ID"
          },
          "volcano": {
            "type": [
              "string",
              "null"
            ],
            "description": "Volcano name"
          },
          "slug": {
            "type": [
              "string",
              "null"
            ],
            "description": "Volcano slug"
          },
          "observatory": {
            "type": [
              "string",
              "null"
            ],
            "description": "Observatory code"
          },
          "type": {
            "type": [
              "string",
              "null"
            ],
            "description": "Message type (VAN, VONA, etc.)"
          },
          "alert_level": {
            "type": [
              "string",
              "null"
            ],
            "description": "Alert level at time of notice"
          },
          "color_code": {
            "type": [
              "string",
              "null"
            ],
            "description": "Color code at time of notice"
          },
          "sent_utc": {
            "type": [
              "string",
              "null"
            ],
            "description": "Timestamp when notice was sent (UTC)"
          },
          "summary": {
            "type": [
              "string",
              "null"
            ],
            "description": "Brief summary of the notice"
          },
          "message": {
            "type": [
              "string",
              "null"
            ],
            "description": "Full notice message text"
          },
          "url": {
            "type": [
              "string",
              "null"
            ],
            "description": "URL to full notice"
          }
        }
      }
    }
  },
  "required": [
    "volcano_slug",
    "count",
    "notices"
  ]
}

Connect

Add this to your MCP client config — every tool in the catalog, including this one — or use one-click install buttons:

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://pipeworx.io/mcp"
    }
  }
}
Connect to just the usgs-volcano pack
{
  "mcpServers": {
    "usgs-volcano": {
      "url": "https://gateway.pipeworx.io/usgs-volcano/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

Regenerated from source · build November 19, 2026