# Taiwan Weather (CWA) MCP

> Taiwan Weather (CWA) MCP Server accesses the Central Weather Administration's official records for Taiwan. Use it to get real-time major earthquake reports, 36-hour city forecasts, one-week township predictions, and detailed small-magnitude seismic data.

## Overview
- **Category:** artificial-intelligence
- **Price:** Free
- **Tags:** meteorology, weather-forecast, typhoon-tracking, seismology, real-time-data, public-data

## Description

This MCP Server connects your AI client directly to the Central Weather Administration (CWA) of Taiwan. You're getting access to official, real-time seismic and meteorological records from one of Asia’s major monitoring networks. It handles everything from immediate earthquake reports to detailed, long-range weather planning.

When you need to check for significant geological activity, use `get_taiwan_earthquakes`. This tool pulls verified, official reports on large earthquakes across Taiwan and the surrounding region. You'll get key details like the event's magnitude, its depth, and precise epicenter coordinates—what you really need when assessing risk.

For analyzing background seismic activity, run `get_taiwan_small_earthquakes`. This function retrieves data specifically on minor-magnitude quakes. It’s critical for seismological research or if you're monitoring subtle shifts in activity that don't trigger major alerts, giving you a granular view of the tectonic environment.

When you need to plan trips, your options are pretty robust. If you only have three days, use `get_taiwan_forecast`. This function pulls a 36-hour weather forecast for specific major cities or counties across Taiwan. You'll get predicted temperature ranges and the probability of rain over that period.

When you need to plan weeks out, you've got `get_taiwan_weekly_forecast`. Running this tool gives you a full one-week outlook, but it breaks down conditions by individual townships in 12-hour chunks. This granularity is essential for complex itinerary planning or logistics where timing matters.

Combining these tools lets your agent handle highly specific requests. For instance, if you need to know the weather for a city *and* check for minor quakes that happened today, you can call both `get_taiwan_forecast` and `get_taiwan_small_earthquakes`. If your goal is pure risk assessment, you'll pull major quake reports using `get_taiwan_earthquakes`, then cross-reference the region with the long-term planning data from `get_taiwan_weekly_forecast`. The system pulls together official reports on significant seismic events and detailed weather forecasts for townships across Taiwan. You won't find more direct, actionable government data anywhere else.

## Tools

### get_taiwan_earthquakes
Retrieves official reports on significant earthquakes, including magnitude and epicenter coordinates.

### get_taiwan_forecast
Gets the 36-hour weather forecast for major cities across Taiwan, listing temperature ranges and rain probability.

### get_taiwan_weekly_forecast
Provides the 1-week weather forecast, detailing conditions across townships in 12-hour intervals.

### get_taiwan_small_earthquakes
Retrieves reports on small-magnitude quakes useful for seismological research and monitoring minor activity.

## Prompt Examples

**Prompt:** 
```
What's the weather forecast for Taipei this week?
```

**Response:** 
```
I've pulled the CWA forecast for Taipei. Expect partly cloudy skies with afternoon thunderstorms through Wednesday, temperatures ranging from 24°C to 31°C. Rain probability peaks at 60% on Tuesday afternoon. Clear conditions expected by the weekend.
```

**Prompt:** 
```
Have there been any significant earthquakes near Taiwan recently?
```

**Response:** 
```
I've checked the CWA seismological feed. The most recent significant earthquake was a magnitude 5.2 event centered 23 km east of Hualien at a depth of 15 km. Minor shaking was felt across eastern Taiwan. No tsunami warning was issued. The CWA registered 3 additional minor events in the surrounding area over the past 48 hours.
```

## Capabilities

### Get Real-Time Earthquake Reports
The agent pulls official data on significant seismic events, providing magnitude, depth, and epicenter coordinates.

### Run 36-Hour City Forecasts
You request the weather forecast for a specific city or county, receiving predicted temperature ranges and rain probability over three days.

### Plan Weeks Out with Township Data
The agent retrieves the 1-week forecast, breaking down conditions by township in 12-hour intervals for detailed itinerary planning.

### Analyze Minor Seismic Events
You pull reports on small-magnitude quakes, useful specifically for research or monitoring minor activity trends.

## Use Cases

### Coordinating disaster relief after a tremor
The ground shakes, and you need immediate information. Your agent runs `get_taiwan_earthquakes` to confirm the quake's magnitude and epicenter. Then, it calls `get_taiwan_forecast` to see if heavy rain or typhoons are complicating rescue efforts in that specific region.

### Planning a multi-day construction project
You need reliable outdoor work for the next two weeks. Instead of checking daily, you run `get_taiwan_weekly_forecast` to map out when rain probability dips low enough across multiple townships to allow safe material transport.

### Writing a scientific paper on regional risk
Your research requires both major and minor data points. You use `get_taiwan_earthquakes` for the high-impact events, then supplement that with `get_taiwan_small_earthquakes` to provide a fuller picture of background seismic noise.

### Adjusting travel plans around typhoons
A large typhoon is approaching. You use the 36-hour forecast (`get_taiwan_forecast`) to track the immediate severe weather changes in Taipei, and then cross-check with `get_taiwan_weekly_forecast` to see how long that impact will last.

## Benefits

- Access CWA's official data directly. You skip cross-referencing multiple government sites; the server provides verified reports on both seismic activity and weather conditions using `get_taiwan_earthquakes`.
- Plan trips with granular detail. The `get_taiwan_weekly_forecast` tool delivers 12-hour interval predictions for entire townships, which is way more useful than a single city summary.
- Differentiate between risks. You can call both `get_taiwan_earthquakes` (big events) and `get_taiwan_small_earthquakes` (minor data). This lets you build a complete risk model without missing the minor tremors.
- Know the immediate conditions. The 36-hour forecast from `get_taiwan_forecast` gives you enough lead time to adjust operations—you know if those afternoon thunderstorms are coming early or late in the window.

## How It Works

The bottom line is: your agent gets verified, multi-source weather and seismic data directly into your workflow without needing to visit multiple government websites.

1. Tell your agent exactly what you need. For example: 'What's the 36-hour weather forecast for Kaohsiung?'
2. The server executes the appropriate tool (e.g., `get_taiwan_forecast`) and fetches data from the CWA feed.
3. Your AI client receives a structured JSON payload containing the raw, official predictions or event logs.

## Frequently Asked Questions

**How do I check for major earthquakes using get_taiwan_earthquakes?**
You tell your agent to run `get_taiwan_earthquakes`. This tool pulls official reports on significant seismic events, giving you the magnitude, depth, and precise epicenter coordinates from the CWA.

**Can I get a forecast for more than 3 days using get_taiwan_forecast?**
No. `get_taiwan_forecast` is limited to the 36-hour window for major cities. For multi-day planning, you must use `get_taiwan_weekly_forecast`.

**Is get_taiwan_small_earthquakes useful for general users?**
It's mainly for researchers and technical teams. This tool provides records on small-magnitude quakes—stuff that doesn't trigger a major public alert but is key data points for monitoring.

**What time frame does get_taiwan_weekly_forecast cover?**
This tool covers one full week of predictions. The forecast delivers conditions in 12-hour increments, which helps you plan logistics across entire townships.

**Before running `get_taiwan_earthquakes`, what credentials do I need to access the data?**
You'll need a free API key from CWA. The MCP server handles the connection; you simply input your generated key during setup, and it manages rate limiting for you.

**When using `get_taiwan_forecast`, what format should I use for city names to get accurate readings?**
You can filter by either Traditional Chinese characters or English romanization. The tool accepts both inputs, giving you flexibility regardless of your source data.

**Does `get_taiwan_earthquakes` only report on seismic activity inside Taiwan?**
No, the reports cover both Taiwan and the surrounding Pacific region. This is critical because it provides regional context needed for safety planning across the Western Pacific typhoon corridor.

**What specific weather metrics are provided by `get_taiwan_weekly_forecast`?**
The forecast gives you temperature ranges, precipitation probability, and general conditions. This level of detail helps plan logistics down to 12-hour shifts for travel.

**How do I get a CWA API key?**
Register for a free account at opendata.cwa.gov.tw. Once logged in, your Authorization key is available immediately in your profile dashboard. No approval wait time required.

**Why is Taiwan earthquake data so important?**
Taiwan sits directly on the Pacific Ring of Fire, one of the most seismically active zones on Earth. The CWA operates one of the densest seismological sensor networks in Asia, providing rapid, high-precision earthquake data that is critical for safety, construction, and insurance applications.