Calculate China expat IIT net salary, BIA tax-free allowances, annual bonus & GBA 15% rebates.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Evaluate whether paying a landlord surcharge to obtain official housing VAT invoices generates positive after-tax savings at your marginal rate.
Employee top applicable IIT decimal rate between 0.03 and 0.45 (e.g., 0.30 for 30%).
Contractual monthly apartment rent in RMB before any landlord invoice markup.
Percentage fee demanded by the landlord or agent to issue official tax bureau Fapiao (e.g., 5).
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http mcp https://chinataxcalc.com/api/mcp
Evaluate whether paying a landlord surcharge to obtain official housing VAT invoices generates positive after-tax savings at your marginal rate.
| Argument | Type | Description |
|---|---|---|
| marginalRate* | number | Employee top applicable IIT decimal rate between 0.03 and 0.45 (e.g., 0.30 for 30%). |
| monthlyRentRMB* | number | Contractual monthly apartment rent in RMB before any landlord invoice markup. |
| surchargeRatePct* | number | Percentage fee demanded by the landlord or agent to issue official tax bureau Fapiao (e.g., 5). |
{
"type": "object",
"required": [
"monthlyRentRMB",
"surchargeRatePct",
"marginalRate"
],
"properties": {
"marginalRate": {
"type": "number",
"description": "Employee top applicable IIT decimal rate between 0.03 and 0.45 (e.g., 0.30 for 30%)."
},
"monthlyRentRMB": {
"type": "number",
"description": "Contractual monthly apartment rent in RMB before any landlord invoice markup."
},
"surchargeRatePct": {
"type": "number",
"description": "Percentage fee demanded by the landlord or agent to issue official tax bureau Fapiao (e.g., 5)."
}
},
"additionalProperties": false
}Compute annual and monthly net take-home cash, marginal brackets, employer costs, and tax savings from eight Fapiao-backed BIA allowances across six Chinese cities.
| Argument | Type | Description |
|---|---|---|
| cityId | string | Municipality determining local social insurance base caps and employer rate tables. |
| currency | string | Reporting currency code used for base pay, BIA items, and returned net figures. |
| annualBonus | number | Separate annual lump-sum bonus taxed under MOF/STA Announcement 2023 No. 30. |
| grossAmount* | number | Base cash remuneration expressed in the chosen currency before payroll deductions or tax. |
| incomePeriod | string | Specifies whether grossAmount and BIA inputs are monthly or annualized figures. |
| housingRental | number | Fapiao-substantiated housing rent allowance matching the chosen incomePeriod and currency. |
| childrenEducation | number | Accredited international school tuition reimbursed per period with official invoices. |
| socialSecurityMode | string | Select exempt for Shanghai opt-out or treaty protection, otherwise standard capped contributions. |
{
"type": "object",
"required": [
"grossAmount"
],
"properties": {
"cityId": {
"enum": [
"shanghai",
"beijing",
"shenzhen",
"guangzhou",
"hangzhou",
"chengdu"
],
"type": "string",
"description": "Municipality determining local social insurance base caps and employer rate tables."
},
"currency": {
"enum": [
"RMB",
"USD",
"EUR",
"GBP",
"SGD",
"HKD"
],
"type": "string",
"description": "Reporting currency code used for base pay, BIA items, and returned net figures."
},
"annualBonus": {
"type": "number",
"description": "Separate annual lump-sum bonus taxed under MOF/STA Announcement 2023 No. 30."
},
"grossAmount": {
"type": "number",
"description": "Base cash remuneration expressed in the chosen currency before payroll deductions or tax."
},
"incomePeriod": {
"enum": [
"monthly",
"annual"
],
"type": "string",
"description": "Specifies whether grossAmount and BIA inputs are monthly or annualized figures."
},
"housingRental": {
"type": "number",
"description": "Fapiao-substantiated housing rent allowance matching the chosen incomePeriod and currency."
},
"childrenEducation": {
"type": "number",
"description": "Accredited international school tuition reimbursed per period with official invoices."
},
"socialSecurityMode": {
"enum": [
"exempt",
"standard"
],
"type": "string",
"description": "Select exempt for Shanghai opt-out or treaty protection, otherwise standard capped contributions."
}
},
"additionalProperties": false
}Quantify municipal fiscal refunds across nine Greater Bay Area hubs like Shenzhen Qianhai and Guangzhou Nansha where effective burden caps at 15 percent.
| Argument | Type | Description |
|---|---|---|
| gbaCityId | string | Target Guangdong-Hong Kong-Macao Greater Bay Area municipality administering the 15% refund. |
| actualIITPaidRMB* | number | Total China Individual Income Tax actually remitted to the tax bureau for the calendar year in RMB. |
| taxableIncomeRMB* | number | Corresponding annual taxable income base in RMB used by Qianhai or Nansha fiscal rebate rules. |
{
"type": "object",
"required": [
"actualIITPaidRMB",
"taxableIncomeRMB"
],
"properties": {
"gbaCityId": {
"enum": [
"shenzhen",
"guangzhou",
"zhuhai",
"foshan",
"dongguan",
"zhongshan",
"jiangmen",
"huizhou",
"zhaoqing"
],
"type": "string",
"description": "Target Guangdong-Hong Kong-Macao Greater Bay Area municipality administering the 15% refund."
},
"actualIITPaidRMB": {
"type": "number",
"description": "Total China Individual Income Tax actually remitted to the tax bureau for the calendar year in RMB."
},
"taxableIncomeRMB": {
"type": "number",
"description": "Corresponding annual taxable income base in RMB used by Qianhai or Nansha fiscal rebate rules."
}
},
"additionalProperties": false
}Contrast MOF/STA Announcement 30 separate bonus taxation against combined comprehensive filing and warn about statutory bracket cliff traps.
| Argument | Type | Description |
|---|---|---|
| annualBonusRMB* | number | One-off year-end bonus amount in RMB under evaluation for separate versus combined treatment. |
| annualTaxableSalaryRMB* | number | Regular annual comprehensive taxable income in RMB after standard 60,000 deduction and exemptions. |
{
"type": "object",
"required": [
"annualTaxableSalaryRMB",
"annualBonusRMB"
],
"properties": {
"annualBonusRMB": {
"type": "number",
"description": "One-off year-end bonus amount in RMB under evaluation for separate versus combined treatment."
},
"annualTaxableSalaryRMB": {
"type": "number",
"description": "Regular annual comprehensive taxable income in RMB after standard 60,000 deduction and exemptions."
}
},
"additionalProperties": false
}Benchmark equivalent USD compensation across seven global financial hubs against Shanghai expat net pay with cost-of-living index comparisons.
| Argument | Type | Description |
|---|---|---|
| grossUSD* | number | Comparable annual gross compensation package denominated in US Dollars. |
| chinaCityId | string | Mainland Chinese comparison city used for the domestic expat benchmark calculation. |
| comparisonHubs | array | List of overseas jurisdictions to benchmark alongside Shanghai China (defaults to all seven hubs). |
| chinaHousingAllowanceUSD | number | Annual Fapiao-backed housing allowance in USD included inside the China package (defaults to 24000). |
{
"type": "object",
"required": [
"grossUSD"
],
"properties": {
"grossUSD": {
"type": "number",
"description": "Comparable annual gross compensation package denominated in US Dollars."
},
"chinaCityId": {
"enum": [
"shanghai",
"beijing",
"shenzhen",
"guangzhou",
"hangzhou",
"chengdu"
],
"type": "string",
"description": "Mainland Chinese comparison city used for the domestic expat benchmark calculation."
},
"comparisonHubs": {
"type": "array",
"items": {
"enum": [
"us_ca",
"us_ny",
"us_tx",
"uk_london",
"germany",
"singapore",
"hongkong"
],
"type": "string"
},
"description": "List of overseas jurisdictions to benchmark alongside Shanghai China (defaults to all seven hubs)."
},
"chinaHousingAllowanceUSD": {
"type": "number",
"description": "Annual Fapiao-backed housing allowance in USD included inside the China package (defaults to 24000)."
}
},
"additionalProperties": false
}Track consecutive 183-day residency years and verify whether a continuous 30+ day absence resets non-domiciled offshore income protection.
| Argument | Type | Description |
|---|---|---|
| records* | array | Chronological calendar-year presence flags ordered oldest to newest (up to 6+ years). |
{
"type": "object",
"required": [
"records"
],
"properties": {
"records": {
"type": "array",
"items": {
"type": "object",
"required": [
"year",
"residedOver183Days",
"singleAbsenceOver30Days"
],
"properties": {
"year": {
"type": "number",
"description": "Four-digit calendar tax year under review."
},
"residedOver183Days": {
"type": "boolean",
"description": "True if physical days inside mainland China reached at least 183 days in that year."
},
"singleAbsenceOver30Days": {
"type": "boolean",
"description": "True if at least one single departure outside mainland China exceeded 30 consecutive days."
}
}
},
"description": "Chronological calendar-year presence flags ordered oldest to newest (up to 6+ years)."
}
},
"additionalProperties": false
}Assemble the six mandatory counter verification items, Tax App registration tips, and bilingual SAFE quota exemption text for wiring RMB abroad.
| Argument | Type | Description |
|---|---|---|
| remitAmountRMB | number | After-tax RMB balance intended for outward cross-border bank wire (defaults to 100000). |
| targetCurrency | string | Foreign settlement currency requested at the Chinese commercial bank counter. |
{
"type": "object",
"properties": {
"remitAmountRMB": {
"type": "number",
"description": "After-tax RMB balance intended for outward cross-border bank wire (defaults to 100000)."
},
"targetCurrency": {
"enum": [
"USD",
"EUR",
"GBP",
"SGD",
"HKD"
],
"type": "string",
"description": "Foreign settlement currency requested at the Chinese commercial bank counter."
}
},
"additionalProperties": false
}Simulate January-to-December paycheck variance under STA Announcement 2018 No. 56, highlighting bracket jump months and lumpy school tuition spikes.
| Argument | Type | Description |
|---|---|---|
| monthlySSRMB | number | Monthly employee social insurance contribution in RMB (pass 0 when exempt in Shanghai). |
| monthlyBIARMB | number | Average monthly tax-exempt BIA reimbursements in RMB backed by vendor VAT invoices. |
| monthlyGrossRMB* | number | Regular monthly gross salary in Chinese Yuan before statutory exemptions or withholdings. |
| annualTuitionRMB | number | Total annual international school tuition in RMB used when lumpyTuitionMode is enabled. |
| lumpyTuitionMode | boolean | When true, allocates annualTuitionRMB into 50% semiannual offsets during January and August. |
{
"type": "object",
"required": [
"monthlyGrossRMB"
],
"properties": {
"monthlySSRMB": {
"type": "number",
"description": "Monthly employee social insurance contribution in RMB (pass 0 when exempt in Shanghai)."
},
"monthlyBIARMB": {
"type": "number",
"description": "Average monthly tax-exempt BIA reimbursements in RMB backed by vendor VAT invoices."
},
"monthlyGrossRMB": {
"type": "number",
"description": "Regular monthly gross salary in Chinese Yuan before statutory exemptions or withholdings."
},
"annualTuitionRMB": {
"type": "number",
"description": "Total annual international school tuition in RMB used when lumpyTuitionMode is enabled."
},
"lumpyTuitionMode": {
"type": "boolean",
"description": "When true, allocates annualTuitionRMB into 50% semiannual offsets during January and August."
}
},
"additionalProperties": false
}We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 22, 2026.