# NZ Data API

> NZ Data API is a paid MCP server for legal and government. Pay-per-call New Zealand holidays, working-day deadlines, IRD and bank checks, and GST. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Paid
- **Platforms:** API
- **Website:** https://nzdata.zakwins.workers.dev/llms.txt
- **MCP Registry name:** dev.workers.zakwins.nzdata/nz-data-api
- **Categories:** legal and government, finance and payments
- **Listing updated:** 2026-11-16

## About

NZ Data API sells small New Zealand utilities to agents at fractions of a cent per call, settled in USDC on Base with the x402 protocol. An unpaid HTTP request returns a 402 with payment requirements, and the MCP endpoint accepts the same payment through message metadata.

The date tools cover public holidays from 2022 to 2030 including Matariki and Mondayisation with optional regional anniversary days, counting working days between two dates, and adding working days to a date with presets for statutory shutdowns, such as the 20-working-day Official Information Act deadline. The validators check IRD and GST numbers, NZBN check digits, phone numbers normalised to E.164, and bank account numbers with the bank code identified. A GST calculator handles 15% in either direction.

Prices are $0.002 for holiday and working-day calls and $0.001 for validators and GST. The disclaimer says results are computed from statute and government dates, provided as is, and critical deadlines should be verified with the relevant agency.

## Features

- **Public holidays:** NZ holidays 2022 to 2030 with Matariki, Mondayisation and regions.
- **Working-day counting:** Counts or adds working days with statutory shutdown presets.
- **IRD and NZBN checks:** Validates check digits for IRD, GST and NZBN numbers.
- **Bank account validation:** Validates and normalises account numbers and identifies the bank.
- **Phone normalisation:** Converts NZ numbers to E.164 and gives the type.
- **GST calculator:** Adds or removes 15% GST.

## Good for

- Compute an OIA 20-working-day response deadline
- Check whether a date is a public holiday in Auckland
- Validate an IRD number before invoicing
- Normalise a New Zealand phone number or bank account

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http nz-data-api https://nzdata.zakwins.workers.dev/mcp
```

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

```sh
https://nzdata.zakwins.workers.dev/mcp
```

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

```json
{
  "mcpServers": {
    "nz-data-api": {
      "url": "https://nzdata.zakwins.workers.dev/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "nz-data-api": {
      "type": "http",
      "url": "https://nzdata.zakwins.workers.dev/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "nz-data-api": {
      "serverUrl": "https://nzdata.zakwins.workers.dev/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "nz-data-api": {
      "type": "http",
      "url": "https://nzdata.zakwins.workers.dev/mcp"
    }
  }
}
```

## FAQ

### How is it priced?

$0.002 per holiday or working-day call and $0.001 per validator or GST call.

### How do I pay?

In USDC on Base using x402, over HTTP or inside MCP messages.

### Is the data guaranteed?

No. It is provided as is, and critical deadlines should be verified with the agency.

### Which dates are covered?

Public holidays from 2022 to 2030.

### Is NZ Data API free?

No. NZ Data API is a paid product.

### How do I add NZ Data API to Claude Code?

Run this command in your terminal: claude mcp add --transport http nz-data-api https://nzdata.zakwins.workers.dev/mcp

### What are the best alternatives to NZ Data API?

The closest alternatives to NZ Data API are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, NY LLC Publication (FileMyPublication) and Quantivex Research.

## Alternatives

- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [NY LLC Publication (FileMyPublication)](https://ai-powered.com/mcp/ny-llc-publication-filemypublication): NY LLC Publication (FileMyPublication) is a free MCP server for legal and government.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.
- [TribuJus](https://ai-powered.com/mcp/tribujus): TribuJus is an open-source MCP server for legal and government.
- [SupplyClub Catalog](https://ai-powered.com/mcp/supplyclub-catalog): SupplyClub Catalog is a free MCP server for legal and government.

---
Source: https://ai-powered.com/mcp/nz-data-api
