# Nokosanzo

> Nokosanzo is a free MCP server for legal and government. Exact Japanese benefit, pension, tax and shipping calculations, run locally. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** CLI, Windows, macOS, Linux
- **Website:** https://c2nprds.com/tools/mcp/
- **MCP Registry name:** io.github.c2nprds/nokosanzo
- **Categories:** [legal and government](https://ai-powered.com/categories/legal-and-government), [accounting and tax](https://ai-powered.com/categories/accounting-and-tax)
- **Listing updated:** 2026-11-22

## About

Nokosanzo is a local MCP server that lets an AI app call the same calculators published on the Nokosanzo site, instead of the model working from half-remembered rates and tables. It covers Japanese employment and leave benefits, pensions, taxes, labour insurance, parcel fees and postage.

Everything runs on your own machine. Values you pass to a calculation are not sent to Nokosanzo's servers. Results include the period and source of the tables and rates used, plus usage notes, and dates outside a table's valid period return an error with the reason rather than a wrong amount.

It needs Node.js 22 or later and starts with npx. New package versions are released when rates or tables change each fiscal year. Results are estimates; final decisions rest with the relevant offices.

## Features

- **Runs locally:** Calculations happen on your own machine and inputs are not sent to Nokosanzo.
- **Benefits and leave:** Covers unemployment, childcare leave, family care leave, sickness and maternity allowances.
- **Pension tools:** Includes working-pension suspension and a deferral break-even calculation.
- **Tax and payroll:** Gift tax, depreciation, gross-from-net, average wage and labour insurance renewal.
- **Shipping and postage:** Compares parcel fees across carriers and computes postage with stamp combinations.
- **Sourced results:** Each result states the tables, rates and period it used, and errors out of range.

## Good for

- Ask Claude for a childcare leave benefit estimate using official tables
- Compare parcel carrier fees for a package
- Work out gross pay from a target take-home amount
- Check overtime against the 36 agreement limits
- Check ad copy for risky claims before publishing

## Install

### Claude Code (Terminal)

```sh
claude mcp add nokosanzo -- npx -y @nokosanzo/mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "nokosanzo": {
      "command": "npx",
      "args": [
        "-y",
        "@nokosanzo/mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "nokosanzo": {
      "command": "npx",
      "args": [
        "-y",
        "@nokosanzo/mcp"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "nokosanzo": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@nokosanzo/mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "nokosanzo": {
      "command": "npx",
      "args": [
        "-y",
        "@nokosanzo/mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "nokosanzo": {
      "command": "npx",
      "args": [
        "-y",
        "@nokosanzo/mcp"
      ]
    }
  }
}
```

## Tools

- `unemployment-benefit`: Unemployment benefit calculation
- `childcare-leave-benefit`: Childcare leave benefit calculation
- `family-care-leave-benefit`: Family care leave benefit calculation
- `sickness-allowance`: Sickness allowance calculation
- `maternity-allowance`: Maternity leave period and allowance calculation
- `high-cost-medical-expense`: Out-of-pocket limit for high-cost medical expenses
- `working-pension-suspension`: Suspended amount of pension while working
- `pension-deferral-breakeven`: Break-even point for deferring pension
- `gift-tax`: Gift tax calculation
- `depreciation`: Depreciation calculation
- `gross-from-net`: Work back from take-home pay to gross
- `overtime-limit-check`: Overtime limit check under Article 36 agreements
- `labor-insurance-renewal`: Annual labour insurance renewal calculation
- `average-wage`: Average wage calculation
- `parcel-compare`: Parcel size and fee comparison across Takkyubin, Hikyaku and Yu-Pack
- `postage-stamps`: Postage calculation with stamp combinations
- `ad-claim-check`: Checker for risky advertising wording under Japanese pharmaceutical and misrepresentation laws

## FAQ

### Does Nokosanzo send my inputs anywhere?

No. Calculations run on your machine and values are not sent to the Nokosanzo servers. Your AI app may still send the conversation to its own provider.

### How do I install Nokosanzo?

Run claude mcp add nokosanzo -- npx -y @nokosanzo/mcp, or add the npx command to your client's MCP config. Node.js 22 or later is required.

### Are the results official?

They are estimates. Final eligibility and tax decisions are made by offices such as Hello Work, pension offices and tax offices.

### What happens with dates outside the table period?

It returns an error with the reason instead of an incorrect amount.

### Is Nokosanzo free?

Yes. Nokosanzo is free to use.

### How do I add Nokosanzo to Claude Code?

Run this command in your terminal: claude mcp add nokosanzo -- npx -y @nokosanzo/mcp

### What are the best alternatives to Nokosanzo?

The closest alternatives to Nokosanzo are VEOSKILL, EU TED Tenders Scraper, Torhy, Lithuania Public Procurement and BRAINIAC Accounting Schedules & Close.

## Where this comes from

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

## Alternatives

- [VEOSKILL](https://ai-powered.com/mcp/veoskill): VEOSKILL is a freemium MCP server for education and exams.
- [EU TED Tenders Scraper](https://ai-powered.com/mcp/eu-ted-tenders-scraper): EU TED Tenders Scraper is a paid MCP server for web search and scraping.
- [Torhy](https://ai-powered.com/mcp/torhy): Torhy is a freemium MCP server for legal and government.
- [Lithuania Public Procurement](https://ai-powered.com/mcp/lithuania-public-procurement): Lithuania Public Procurement is a freemium MCP server for legal and government.
- [BRAINIAC Accounting Schedules & Close](https://ai-powered.com/mcp/brainiac-accounting-schedules-and-close): BRAINIAC Accounting Schedules & Close is a paid MCP server for finance and payments.
- [BRAINIAC Agent Execution Contract Intelligence](https://ai-powered.com/mcp/brainiac-agent-execution-contract-intelligence): BRAINIAC Agent Execution Contract Intelligence is a paid MCP server for legal and government.
- [Tvarka Proof](https://ai-powered.com/mcp/tvarka-proof): Tvarka Proof is a paid MCP server for files and documents.
- [jdelete](https://ai-powered.com/mcp/jdelete): jdelete is a paid MCP server for security.

---
Source: https://ai-powered.com/mcp/nokosanzo
