Nokosanzo
Exact Japanese benefit, pension, tax and shipping calculations, run locally
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/mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"nokosanzo": {
"command": "npx",
"args": [
"-y",
"@nokosanzo/mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"nokosanzo": {
"command": "npx",
"args": [
"-y",
"@nokosanzo/mcp"
]
}
}
}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.
