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
| Name | Type | Required | Description |
|---|---|---|---|
volcano_slug | string | no | USGS volcano slug (e.g., “kilauea”, “shishaldin”). Optional, omit for all recent. |
limit | number | no | Cap 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
| Field | Type | Description |
|---|---|---|
volcano_slug | string | null | Filtered volcano slug if provided, otherwise null |
count | number | Number of notices returned |
notices | array | List 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.