Skip to content
MCP server

Nokosanzo

Exact Japanese benefit, pension, tax and shipping calculations, run locally

Runs locally
Install

Nokosanzo is a free MCP server for legal and government. It runs locally on your machine and is started by your AI client.

Pricing
Free
Platforms
CLI, Windows, macOS
Runs
Locally
Version
0.1.1
Listing updated

Similar MCP servers

Install

Run in a terminal

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

Add to claude_desktop_config.json

{
  "mcpServers": {
    "nokosanzo": {
      "command": "npx",
      "args": [
        "-y",
        "@nokosanzo/mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "nokosanzo": {
      "command": "npx",
      "args": [
        "-y",
        "@nokosanzo/mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

About Nokosanzo

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.

Tools this server provides (17)

Taken from the project documentation; the running server may differ.

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

What it does

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

Pricing

Free

Prices change. Check c2nprds.com before you buy.

Nokosanzo 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.

How AIPoweredBot checks servers