# Geonet Nz

> Geonet Nz is an open-source MCP server for space data. Live NZ earthquake, quake detail and volcano alert data from GeoNet for AI agents. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** API, CLI, self-hosted
- **Website:** https://pipeworx.io/packs/geonet-nz
- **Repository:** https://github.com/pipeworx-io/mcp-geonet-nz
- **MCP Registry name:** io.github.pipeworx-io/geonet-nz
- **Categories:** [space data](https://ai-powered.com/categories/space-data)
- **Listing updated:** 2026-11-18

## About

The README says this server is a thin bridge to the Pipeworx gateway, exposing three tools that pull from GeoNet, the New Zealand monitoring network run by GNS Science. It can list recent earthquakes filtered by minimum felt intensity, look up a single quake by its GeoNet public ID, and report current alert levels for monitored volcanoes such as Taupo, Whakaari and Ruapehu.

Each tool returns structured fields like magnitude, depth, locality, felt intensity and coordinates, so an assistant can answer questions about recent seismic activity without scraping the GeoNet site. The volcano tool also includes the NZ 0-5 alert scale, activity descriptions, hazards and aviation colour codes.

The lookup tools are keyless. Anonymous use is capped at 50 calls a day, and a free Pipeworx account raises the cap to 200. The endpoint also lists shared gateway tools such as ask_pipeworx alongside the three pack tools.

## Features

- **Recent earthquake listing:** Returns recent NZ quakes newest first, filtered by a minimum Modified Mercalli Intensity.
- **Single quake detail:** Fetches time, magnitude, depth, locality, felt intensity, location quality and coordinates for one GeoNet public ID.
- **Volcanic alert levels:** Reports current NZ volcanic alert levels with activity descriptions, hazards and aviation colour codes.
- **Keyless lookups:** The three GeoNet tools run without an API key; a free key only raises the daily call cap.
- **Multiple connection options:** Available as a remote streamable-HTTP endpoint or as a local npm stdio bridge.

## Good for

- Checking whether recent earthquakes in New Zealand were widely felt
- Pulling magnitude and depth details for a specific GeoNet event
- Monitoring current volcanic alert levels for NZ volcanoes
- Adding NZ seismic context to a travel or aviation briefing assistant

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http geonet-nz https://gateway.pipeworx.io/geonet-nz/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://gateway.pipeworx.io/geonet-nz/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "geonet-nz": {
      "url": "https://gateway.pipeworx.io/geonet-nz/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "geonet-nz": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/geonet-nz/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "geonet-nz": {
      "serverUrl": "https://gateway.pipeworx.io/geonet-nz/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "geonet-nz": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/geonet-nz/mcp"
    }
  }
}
```

## Tools

- `recent_quakes`: Recent New Zealand earthquakes from GeoNet, filtered by minimum Modified Mercalli Intensity.
- `get_quake`: Detail for a single New Zealand earthquake by its GeoNet publicID.
- `volcano_alerts`: Current Volcanic Alert Levels for monitored New Zealand volcanoes.

## FAQ

### Does it need an API key?

The three GeoNet tools are keyless. Without a Pipeworx key, anonymous calls are capped at 50 a day; a free account raises the cap to 200 a day.

### Which volcanoes does the alert tool cover?

The README names Taupo, White Island/Whakaari, Ruapehu, Tongariro and the Auckland Volcanic Field, among all monitored New Zealand volcanoes.

### Is this an official GeoNet product?

The README says it is an independent, unofficial integration and is not affiliated with or endorsed by the upstream provider.

### Is Geonet Nz free?

Yes. Geonet Nz is open source, so you can use and self-host it for free.

### How do I add Geonet Nz to Claude Code?

Run this command in your terminal: claude mcp add --transport http geonet-nz https://gateway.pipeworx.io/geonet-nz/mcp

### What are the best alternatives to Geonet Nz?

The closest alternatives to Geonet Nz are Noaa Swpc, Exoplanet Archive and Spaceflight News.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Noaa Swpc](https://ai-powered.com/mcp/noaa-swpc): Noaa Swpc is a freemium MCP server for space data.
- [Exoplanet Archive](https://ai-powered.com/mcp/exoplanet-archive): Exoplanet Archive is a freemium MCP server for space data.
- [Spaceflight News](https://ai-powered.com/mcp/spaceflight-news): Spaceflight News is a freemium MCP server for space data.

---
Source: https://ai-powered.com/mcp/geonet-nz
