# Volcano Activity AI Agent Connect

> Volcano Activity MCP provides structured access to the Smithsonian Global Volcanism Program and USGS Weekly Volcanic Activity Report. Your AI client can pull specific data on eruptions, alert levels, ash plumes, and exclusion zones. It turns complex scientific prose into actionable data for monitoring global volcanic unrest.

## Overview
- **Category:** weather-climate
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_54LBEEfNlx6i1ozZQh1k2tUrVqF1M6l06HbhPSI9/ai-agent-connect
- **Tags:** volcanoes, geology, natural-hazards, eruption, alert-level, ash-plume, smithsonian, usgs, earth-science, disaster-monitoring

## Description

You can connect your AI agent to the authoritative weekly summary of volcanic unrest published by the Smithsonian and USGS. Instead of digging through PDF reports or messy web pages, your agent reads the latest data published every Thursday at 2300 UTC. You can ask about specific volcanoes, find new eruptions that started this week, or check for activity within a specific radius of your location. The data includes critical safety information like alert levels and exclusion zones, which are pulled directly from the scientific narratives provided by observatories like PVMBG or JMA. Because the report is a summary of notable activity rather than an exhaustive list of every volcano on Earth, your agent can quickly identify where the real unrest is happening. It is a direct line to the scientists monitoring the world's most active volcanic zones.

## Tools

### get_volcano_report
This tool retrieves the full scientist-written narrative for a specific volcano. It includes the reporting observatory, source details, and specific alert levels or exclusion zones mentioned in the text.

### list_active_volcanoes
Use this to see all volcanoes included in this week's report. You can filter the results by country, activity type, or geographic bounding box.

### find_volcanoes_nearby
This tool finds volcanoes with notable activity within a specific kilometer radius of any coordinate. It returns results sorted by proximity.

### list_new_activity
This tool isolates only the volcanoes that began erupting or showing new unrest this week. It ignores continuing activity to focus on recent changes.

### get_report_summary
This tool provides a high-level overview of the entire week's global volcanic activity. It summarizes how many volcanoes are active and identifies the highest alert levels reported.

## Prompt Examples

**Prompt:** 
```
Did any new volcano eruptions start this week?
```

**Response:** 
```
One volcano began new eruptive activity in the report for 10–16 September 2026: Krakatau in Indonesia. PVMBG reported fourteen Strombolian eruptions during 6–11 September, with an ash plume reaching 2.1 km above the summit. The alert level stands at 3 on Indonesia's 1–4 scale.
```

**Prompt:** 
```
I'm planning a trip to Bali. Is there any volcano activity I should worry about nearby?
```

**Response:** 
```
Searching within 300 km of Bali, the current Weekly Volcanic Activity Report lists no volcano with notable activity in that radius. The report's entries this week are all located elsewhere.
```

**Prompt:** 
```
Give me the full report on Mount Merapi.
```

**Response:** 
```
Merapi is currently showing continuing eruptive activity. The alert level is 3 on Indonesia's four-level scale, and the public is warned to stay at least 5 km from the Jonggring Seloko crater. PVMBG is the reporting authority for this update.
```

## Capabilities

### Geographic Proximity Checks
Your agent calculates volcanic activity within a specific radius of any latitude and longitude.

### New Event Detection
The agent filters out ongoing activity to identify only the eruptions and unrest that began this week.

### Safety Data Extraction
Your agent reads scientific prose to find specific alert levels, ash plume heights, and exclusion zones.

### Global Activity Summaries
The agent can provide a bird's-eye view of how many volcanoes are active worldwide each week.

### Filtered Volcano Lists
Your agent can narrow down volcanic data by country, name, or specific activity type.

## Use Cases

### Regional Risk Assessment
Check for any notable volcanic activity within a specific radius of a planned logistics route.

### Weekly Monitoring
Automate a summary of all new eruptions and unrest that occurred globally in the last seven days.

### Safety Compliance
Retrieve specific exclusion zone distances and alert levels for a volcano to inform safety protocols.

### Data Filtering
Isolate all volcanoes currently experiencing new unrest within a specific country.

## Benefits

- Converts scientific prose into structured, queryable data.
- Provides direct access to authoritative Smithsonian and USGS sources.
- Eliminates the need to manually search through weekly PDF updates.
- Allows for rapid identification of new volcanic threats via proximity searches.

## How It Works

The MCP connects your AI client to the Smithsonian and USGS data streams.

1. Connect your AI client to the Volcano Activity MCP via Vinkius.
2. Ask your agent a question about volcanic activity or specific locations.
3. The agent invokes the necessary tool to query the weekly report.
4. The agent parses the scientific text or structured data to find your answer.
5. You receive a direct response based on the latest official report.

## Frequently Asked Questions

**Do I need an API key?**
No. This reads the public GeoRSS feed of the Smithsonian / USGS Weekly Volcanic Activity Report, which requires no key or account.

**Is this a complete list of every erupting volcano?**
No, and the source says so itself. The Weekly Volcanic Activity Report summarises activity that met selected criteria — significant new eruptions, changes in alert level, or notable ongoing activity. It typically lists around twenty volcanoes a week out of the roughly 1,300 that have erupted in historical time, so treat it as the authoritative digest of what changed, not an exhaustive catalogue.

**Why is the alert level missing for some volcanoes?**
Alert levels are written in free prose by the reporting observatory, and each country words them differently — some reports state no numeric level at all. The tool reads them out of the text where they are stated and leaves the field empty where they are not; the full report body is always returned alongside so nothing is hidden. Check the body before acting on any extracted number.

**How fresh is the data?**
The report is published every Thursday by 2300 UTC, so on a Thursday or Friday you are reading the freshest issue; later in the week you are reading the previous Thursday's report. Each answer carries its own report window and publication timestamp — quote those alongside any figure so the reader knows which week it describes.

**Why does find_volcanoes_nearby return nothing for my location?**
Because nothing notable is active there. The report lists only about twenty volcanoes a week worldwide, so for most of the planet — including all of Europe outside Iceland and Italy — the answer is genuinely empty. Increase radius_km before concluding the search is broken; the radius caps at 2,000 km.
