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

> 中国社保与薪税计算器 (China Shebao & Payroll Tax MCP) is a free MCP server for finance and payments. Estimates China payroll: social insurance bases, take-home pay, tax and pensions. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** Web, API, CLI
- **Website:** https://www.shebao.org
- **Repository:** https://github.com/ddter/china-shebao-mcp
- **MCP Registry name:** io.github.ddter/china-shebao
- **Categories:** [finance and payments](https://ai-powered.com/categories/finance-and-payments)
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://www.shebao.org/mcp
```

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

```json
{
  "mcpServers": {
    "china-shebao": {
      "url": "https://www.shebao.org/mcp"
    }
  }
}
```

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

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

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

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

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
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.

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

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

## Tools

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

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

## Alternatives

- [Estimate My Paycheck](https://ai-powered.com/mcp/estimate-my-paycheck): Estimate My Paycheck is a free MCP server for finance and payments.
- [SalaryNet Payroll](https://ai-powered.com/mcp/salarynet-payroll): SalaryNet Payroll is a freemium MCP server for finance and payments.
- [CalcBloc tax and salary calculator](https://ai-powered.com/mcp/calcbloc-tax-and-salary-calculator): CalcBloc tax and salary calculator is a free MCP server for finance and payments.
- [OIYO Korea Calculators](https://ai-powered.com/mcp/oiyo-korea-calculators): OIYO Korea Calculators is a free MCP server for finance and payments.
- [Jp Statutory](https://ai-powered.com/mcp/jp-statutory): Jp Statutory is a paid MCP server for finance and payments.
- [SA Payroll & Labour Rules](https://ai-powered.com/mcp/sa-payroll-and-labour-rules): SA Payroll & Labour Rules is a freemium MCP server for legal and government.
- [明乐智保 MCP（Minglezhibao Insurance Data）](https://ai-powered.com/mcp/mcp-minglezhibao-insurance-data): 明乐智保 MCP（Minglezhibao Insurance Data） is a freemium MCP server for finance and payments.
- [ISZ Shiwake AI (Japanese tax & accounting)](https://ai-powered.com/mcp/isz-shiwake-ai-japanese-tax-and-accounting): ISZ Shiwake AI (Japanese tax & accounting) is a free MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/china-shebao-and-payroll-tax-mcp
