Skip to content
MCP server

中国社保与薪税计算器 (China Shebao & Payroll Tax MCP)

Estimates China payroll: social insurance bases, take-home pay, tax and pensions

Install
Pricing
Free
Platforms
Web, API, CLI
Runs
Remotely
Version
1.0.1
Listing updated
4 days ago

Similar MCP servers

About 中国社保与薪税计算器 (China Shebao & Payroll Tax MCP)

中国社保与薪税计算器 (China Shebao & Payroll Tax MCP) is a free MCP server for finance and payments. It runs as a hosted remote server, so there is nothing to install locally.

Shebao.org is a Chinese payroll and social insurance calculator, and this MCP server exposes its engine to assistants. It covers social insurance policy for 31 provinces and municipalities and contribution bases and rates for 392 cities, and it returns breakdowns with source links. The site says only .gov.cn sources are used for bases and that results are for reference.

The README lists nine tools: policy lookup by province, city base limits, take-home salary with housing fund and cumulative withholding, income tax calculations, a comparison of annual bonus tax methods, pension estimates, severance pay, flexible-employment social insurance, and maternity allowance. Example questions include net pay for a 15,000 yuan salary in Shanghai or whether a bonus is better taxed separately.

Unlike the website, which calculates in the browser, MCP calls send parameters to the server, so names, ID numbers and employee tables should not be passed. The project is MIT licensed, with a remote endpoint and an optional stdio bridge via npx.

Install

Run in a terminal

claude mcp add --transport http china-shebao https://www.shebao.org/mcp

Add to Settings → Connectors → Add custom connector

https://www.shebao.org/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "china-shebao": {
      "url": "https://www.shebao.org/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "china-shebao": {
      "type": "http",
      "url": "https://www.shebao.org/mcp"
    }
  }
}

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

{
  "mcpServers": {
    "china-shebao": {
      "serverUrl": "https://www.shebao.org/mcp"
    }
  }
}

Add to Grok Bot desktop app → Connect apps → Add a custom connector

https://www.shebao.org/mcp

Enter a Name (for example "中国社保与薪税计算器 (China Shebao & Payroll Tax MCP)"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.

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

{
  "mcpServers": {
    "china-shebao": {
      "type": "http",
      "url": "https://www.shebao.org/mcp"
    }
  }
}

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

Tools this server provides (9)

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

query_social_security_policy
Looks up a province's 2026 social insurance base limits and source documents.
get_city_social_fund_limits
Looks up base limits and default rates for a city, with verification status.
calculate_salary_take_home
Estimates net salary with insurance, housing fund and cumulative withholding.
calculate_income_tax
Calculates salary withholding, service income withholding and annual reconciliation.
compare_annual_bonus_tax
Compares separate versus combined taxation of an annual bonus.
calculate_retirement_pension
Estimates the monthly basic and personal account pension.
calculate_severance_pay
Estimates severance and the tax-exempt portion.
calculate_flexible_employment_social
Compares contribution tiers for flexible employment and future pension.
calculate_maternity_allowance
Estimates maternity leave days, allowance and employer top-up.

What it does

Province policy lookup
Social insurance base limits and source documents for 31 regions.
City base limits
Bases and default rates for 392 cities with verification status.
Take-home pay
Net salary with deductions, cumulative tax and monthly cash flow.
Bonus tax comparison
Compares separate and combined taxation for year-end bonuses.
Pension estimate
Basic pension plus personal account amounts.
Severance pay
N, N+1 and 2N compensation with the tax-free cap.
Maternity allowance
Leave days, allowance and employer top-up.

Good for

  • Work out net pay for a salary in a given city
  • Decide how to tax a year-end bonus
  • Estimate monthly pension at retirement
  • Estimate severance or flexible-employment contributions

Pricing

Free

Free to use, no login

Prices change. Check shebao.org before you buy.

中国社保与薪税计算器 (China Shebao & Payroll Tax MCP) FAQ

How many cities are covered?

392 cities, with 31 provinces and regions of policy.

Is it free?

The site says calculators are free, and the MCP endpoint needs no authentication.

What privacy caution applies?

MCP calls send parameters to the server; avoid names, ID numbers or employee tables.

What licence is the repository?

MIT.

Are results official?

No. They are estimates for reference; actual deductions follow local authorities.

Is 中国社保与薪税计算器 (China Shebao & Payroll Tax MCP) free?

Yes. 中国社保与薪税计算器 (China Shebao & Payroll Tax MCP) is free to use.

How do I add 中国社保与薪税计算器 (China Shebao & Payroll Tax MCP) to Claude Code?

Run this command in your terminal: claude mcp add --transport http china-shebao https://www.shebao.org/mcp

What are the best alternatives to 中国社保与薪税计算器 (China Shebao & Payroll Tax MCP)?

The closest alternatives to 中国社保与薪税计算器 (China Shebao & Payroll Tax MCP) are Estimate My Paycheck, SalaryNet Payroll, CalcBloc tax and salary calculator, OIYO Korea Calculators and Jp Statutory.

Where this comes from

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

How AIPoweredBot checks servers