
中国社保与薪税计算器 (China Shebao & Payroll Tax MCP)
Estimates China payroll: social insurance bases, take-home pay, tax and pensions
- 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/mcpAdd to Settings → Connectors → Add custom connector
https://www.shebao.org/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"china-shebao": {
"url": "https://www.shebao.org/mcp"
}
}
}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/mcpEnter 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.