ChinaTaxCalc — China Expat IIT, BIA Allowance, Annual Bonus & GBA 15% Rebate Engine

● Active

com.chinataxcalc/mcp

Calculate China expat IIT net salary, BIA tax-free allowances, annual bonus & GBA 15% rebates.

Connect this server

One click to install, or copy the config below. Suits: Cursor · HTTP clients.

Add to Cursor Add to VS CodeClaude Desktop / Claude Code: paste the config below.

Or add it manually — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor):

{
  "mcpServers": {
    "mcp": {
      "url": "https://chinataxcalc.com/api/mcp"
    }
  }
}
One line, from the terminal
Claude Code
claude mcp add --transport http mcp https://chinataxcalc.com/api/mcp
VS Code
code --add-mcp '{"name":"mcp","type":"http","url":"https://chinataxcalc.com/api/mcp"}'

Syntax from each client's docs (Claude Code: claude mcp add; Codex: codex mcp add; VS Code: code --add-mcp). Placeholders in angle brackets are values you fill in. Codex takes hosted servers in config.toml ([mcp_servers.<name>] url = …) rather than on the command line.

A starting point — check the repository for exact arguments and setup. Restart your client after editing the config.

Category
Developer Tools
Version
1.0.0
Registry
active
Published
11/22/2026
Listed in:Official MCP registry ↗how this is checked

Is it safe? Is it maintained?

Serverdex check: Nov 22, 2026

Mostly fine: ChinaTaxCalc — China Expat IIT, BIA Allowance, Annual Bonus & GBA 15% Rebate Engine is maintained, hosted endpoint answering without a key.

Maintained
Active
Last commit today (Nov 22, 2026), 0 open issues.
Official registry
Active
Published as com.chinataxcalc/mcp in the official MCP registry, version 1.0.0.
Source
No licence found
Public repository, but GitHub reports no recognised licence (0 stars). Check the README before shipping it in a product.
Runs
Hosted by the publisher
Your client talks to chinataxcalc.com: prompts and tool arguments leave your machine for that host.
Credentials
None needed to connect
The hosted endpoint completed the Serverdex initialize + tools/list handshake with no key (checked Nov 22, 2026); individual tools may still ask for one.
Owner
Unclaimed
Nobody has claimed this page yet; the data above comes from the registry, GitHub and the live check.

Facts only: last commit and licence from GitHub, the entry's status from the official registry, credentials from the live check. Not a code audit — run the security scan on the endpoint yourself and see the status history.

Live check

checked Nov 22, 2026, 06:07 UTCStatus history & uptime →
● Working99 msprotocol 2025-06-18v1.0.0tools

The endpoint answered the MCP handshake as "ChinaTaxCalc — China Expat IIT, BIA Allowance, Annual Bonus & GBA 15% Rebate Engine" and listed 8 tools. Answering since Nov 22, 2026.

Context cost ≈ 2.4k tokens of tool definitions a client loads per conversation (estimate: characters ÷ 4) across 8 tools.

Tools (8)

  • calculate_china_expat_iit_and_net_salary8 params

    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.

    Show parameters
    • grossAmountnumberrequiredBase cash remuneration expressed in the chosen currency before payroll deductions or tax.
    • incomePeriodstringSpecifies whether grossAmount and BIA inputs are monthly or annualized figures.
    • currencystringReporting currency code used for base pay, BIA items, and returned net figures.
    • cityIdstringMunicipality determining local social insurance base caps and employer rate tables.
    • socialSecurityModestringSelect exempt for Shanghai opt-out or treaty protection, otherwise standard capped contributions.
    • annualBonusnumberSeparate annual lump-sum bonus taxed under MOF/STA Announcement 2023 No. 30.
    • housingRentalnumberFapiao-substantiated housing rent allowance matching the chosen incomePeriod and currency.
    • childrenEducationnumberAccredited international school tuition reimbursed per period with official invoices.
  • simulate_cumulative_monthly_withholding5 params

    Simulate January-to-December paycheck variance under STA Announcement 2018 No. 56, highlighting bracket jump months and lumpy school tuition spikes.

    Show parameters
    • monthlyGrossRMBnumberrequiredRegular monthly gross salary in Chinese Yuan before statutory exemptions or withholdings.
    • monthlySSRMBnumberMonthly employee social insurance contribution in RMB (pass 0 when exempt in Shanghai).
    • monthlyBIARMBnumberAverage monthly tax-exempt BIA reimbursements in RMB backed by vendor VAT invoices.
    • lumpyTuitionModebooleanWhen true, allocates annualTuitionRMB into 50% semiannual offsets during January and August.
    • annualTuitionRMBnumberTotal annual international school tuition in RMB used when lumpyTuitionMode is enabled.
  • compare_annual_bonus_separate_vs_combined_tax2 params

    Contrast MOF/STA Announcement 30 separate bonus taxation against combined comprehensive filing and warn about statutory bracket cliff traps.

    Show parameters
    • annualTaxableSalaryRMBnumberrequiredRegular annual comprehensive taxable income in RMB after standard 60,000 deduction and exemptions.
    • annualBonusRMBnumberrequiredOne-off year-end bonus amount in RMB under evaluation for separate versus combined treatment.
  • analyze_landlord_fapiao_surcharge_roi3 params

    Evaluate whether paying a landlord surcharge to obtain official housing VAT invoices generates positive after-tax savings at your marginal rate.

    Show parameters
    • monthlyRentRMBnumberrequiredContractual monthly apartment rent in RMB before any landlord invoice markup.
    • surchargeRatePctnumberrequiredPercentage fee demanded by the landlord or agent to issue official tax bureau Fapiao (e.g., 5).
    • marginalRatenumberrequiredEmployee top applicable IIT decimal rate between 0.03 and 0.45 (e.g., 0.30 for 30%).
  • calculate_gba_15pct_talent_tax_subsidy3 params

    Quantify municipal fiscal refunds across nine Greater Bay Area hubs like Shenzhen Qianhai and Guangzhou Nansha where effective burden caps at 15 percent.

    Show parameters
    • actualIITPaidRMBnumberrequiredTotal China Individual Income Tax actually remitted to the tax bureau for the calendar year in RMB.
    • taxableIncomeRMBnumberrequiredCorresponding annual taxable income base in RMB used by Qianhai or Nansha fiscal rebate rules.
    • gbaCityIdstringTarget Guangdong-Hong Kong-Macao Greater Bay Area municipality administering the 15% refund.
  • compare_cross_border_relocation_net_pay4 params

    Benchmark equivalent USD compensation across seven global financial hubs against Shanghai expat net pay with cost-of-living index comparisons.

    Show parameters
    • grossUSDnumberrequiredComparable annual gross compensation package denominated in US Dollars.
    • comparisonHubsarrayList of overseas jurisdictions to benchmark alongside Shanghai China (defaults to all seven hubs).
    • chinaCityIdstringMainland Chinese comparison city used for the domestic expat benchmark calculation.
    • chinaHousingAllowanceUSDnumberAnnual Fapiao-backed housing allowance in USD included inside the China package (defaults to 24000).
  • diagnose_six_year_worldwide_tax_rule1 param

    Track consecutive 183-day residency years and verify whether a continuous 30+ day absence resets non-domiciled offshore income protection.

    Show parameters
    • recordsarrayrequiredChronological calendar-year presence flags ordered oldest to newest (up to 6+ years).
  • generate_safe_salary_repatriation_checklist2 params

    Assemble the six mandatory counter verification items, Tax App registration tips, and bilingual SAFE quota exemption text for wiring RMB abroad.

    Show parameters
    • remitAmountRMBnumberAfter-tax RMB balance intended for outward cross-border bank wire (defaults to 100000).
    • targetCurrencystringForeign settlement currency requested at the Chinese commercial bank counter.

Checked by Serverdex with a plain initialize + tools/list call to chinataxcalc.com/api/mcp, no credentials, about once a day. A failed check is never a removal.

On GitHub

read Nov 22, 2026
Stars
0
Forks
0
Last push
Nov 22, 2026
License
Other

agent-skillschina-taxexpat-salarygemini-cli-extensionmcpmcp-servermodel-context-protocol

From the README

ChinaTaxCalc MCP Server — China Expat IIT, BIA Allowance, Annual Bonus & GBA 15% Rebate Engine Overview & Production Architecture ChinaTaxCalc (https://chinataxcalc.com) exposes a stateless, zero-authentication Model Context Protocol (MCP) server (streamable-http at https://chinataxcalc.com/api/mcp) backed directly by mainland China Individual Income Tax (IIT) engines, MOF/STA Announcements [2023] No. 29 (tax-exempt expat BIA housing and international school tuition through 2027) and [2023] No. 30 (annual one-off bonus separate calculation & cliff dead-zone detection), STA [2018] No. 56 12-month cumulative withholding simulations, six municipal social insurance caps, nine Greater Bay Area 15% fiscal rebate hubs, seven international relocation benchmarks (US-CA, US-NY, US-TX, UK, DE, SG, HK), the 6-year worldwide tax 31-day reset rule, and SAFE Circular [2020] No. 14 salary repatriation bank checklists.…

Read the full README on GitHub →

Remotes

  • streamable-httphttps://chinataxcalc.com/api/mcp

Alternatives to ChinaTaxCalc — China Expat IIT, BIA Allowance, Annual Bonus & GBA 15% Rebate Engine

All ChinaTaxCalc — China Expat IIT, BIA Allowance, Annual Bonus & GBA 15% Rebate Engine alternatives →Best Developer Tools servers →

The most-starred Developer Tools servers in the index, with their live-check result.

ServerStarsLast pushLive check
REA466,935Nov 2026Local / not checked
GitHub34,658Nov 2026Needs sign-in
Repomix29,280Nov 2026Local / not checked
Compiler Explorer19,201Nov 2026Working
XERJ19,135Nov 2026Local / not checked

ChinaTaxCalc — China Expat IIT, BIA Allowance, Annual Bonus & GBA 15% Rebate Engine: questions people ask

Is ChinaTaxCalc — China Expat IIT, BIA Allowance, Annual Bonus & GBA 15% Rebate Engine a remote or a local MCP server?
According to its entry in the official MCP registry, ChinaTaxCalc — China Expat IIT, BIA Allowance, Annual Bonus & GBA 15% Rebate Engine ships as a hosted endpoint (streamable-http) that your client connects to by URL.
Does ChinaTaxCalc — China Expat IIT, BIA Allowance, Annual Bonus & GBA 15% Rebate Engine need an API key?
Its hosted endpoint completed the Serverdex live check — an MCP initialize + tools/list call — with no credentials on Nov 22, 2026. Individual tools may still ask for a key when called.
Is ChinaTaxCalc — China Expat IIT, BIA Allowance, Annual Bonus & GBA 15% Rebate Engine safe to use?
Mostly fine: ChinaTaxCalc — China Expat IIT, BIA Allowance, Annual Bonus & GBA 15% Rebate Engine is maintained, hosted endpoint answering without a key. In detail — maintained: Active; official registry: Active; source: No licence found; runs: Hosted by the publisher; credentials: None needed to connect. Serverdex check of Nov 22, 2026. This is a reading of the repository, the registry entry and the live check, not a code audit; run the Serverdex security scan on the endpoint before trusting it with real data.
Is ChinaTaxCalc — China Expat IIT, BIA Allowance, Annual Bonus & GBA 15% Rebate Engine still maintained?
Active: the repository's last commit today. Last push Nov 22, 2026, 0 GitHub stars, Other licence. Read from GitHub on Nov 22, 2026.
What tools does ChinaTaxCalc — China Expat IIT, BIA Allowance, Annual Bonus & GBA 15% Rebate Engine expose?
8 tools as listed by the server itself during the live check, including calculate_china_expat_iit_and_net_salary, simulate_cumulative_monthly_withholding, compare_annual_bonus_separate_vs_combined_tax, analyze_landlord_fapiao_surcharge_roi, calculate_gba_15pct_talent_tax_subsidy. The full list with parameters is in the Live check section above.
How do I add ChinaTaxCalc — China Expat IIT, BIA Allowance, Annual Bonus & GBA 15% Rebate Engine to Claude, Cursor or VS Code?
Copy the config in "Connect this server" into your client's MCP config file (claude_desktop_config.json, ~/.cursor/mcp.json or .vscode/mcp.json), or use the one-click Add to Cursor / Add to VS Code buttons and the one-line commands for Claude Code and Codex; then restart the client.

More from AbigailDavised

All 22 servers by AbigailDavised →
  1. ChinaDocCheck — 16-Country China Hague Apostille, USDOS Jurisdiction & 180-Day Validity EngineVerify 16-country China Hague Apostille rules, 180-day validity & USDOS jurisdiction.
  2. ChinaMedsCheck — China Customs GACC Medication Legality & Airport Red-Channel EngineScreen 38 medications against China Customs GACC rules, CAAC limits & airport desks.
  3. ChinaDriveTest — China Subject 1 Exam Bank, Airport Driving Permit & DMV Conversion EngineSearch 2,545 China Subject 1 driving test questions, airport permits, DMV swaps & road signs.
  4. ChinaVisaCalc — China Work Permit Points, Z-Visa, Apostille & Expat Tax EngineCalculate China SAFEA work permit points, Z-visa timelines, Apostille rules & expat IIT tax.
Browse all Developer Tools →

Add the badge to your site

Show visitors that ChinaTaxCalc — China Expat IIT, BIA Allowance, Annual Bonus & GBA 15% Rebate Engine is listed here — it’s also the link we check for a free listing.

ChinaTaxCalc — China Expat IIT, BIA Allowance, Annual Bonus & GBA 15% Rebate Engine — listed on Serverdex

HTML — for your website

<a href="https://serverdex.io/server/com-chinataxcalc-mcp?utm_source=badge"><img src="https://serverdex.io/brand/badge.svg" alt="ChinaTaxCalc — China Expat IIT, BIA Allowance, Annual Bonus & GBA 15% Rebate Engine — listed on Serverdex" width="123" height="40" loading="lazy"></a>

Recommended. A dofollow link from your own domain is the one that counts for search engines, and it's the link we check for a free listing.

Markdown — for your README

[![ChinaTaxCalc — China Expat IIT, BIA Allowance, Annual Bonus & GBA 15% Rebate Engine — listed on Serverdex](https://serverdex.io/brand/badge.svg)](https://serverdex.io/server/com-chinataxcalc-mcp?utm_source=badge)

Nice for visibility, but GitHub marks README links nofollow, so it doesn't pass authority. Use the HTML badge on your site as well.

Add to CursorAdd to VS CodeOpen in Claude Code

Install buttons — for your README

[![Add to Cursor](https://serverdex.io/brand/install-cursor.svg)](https://serverdex.io/install/cursor/com-chinataxcalc-mcp) [![Add to VS Code](https://serverdex.io/brand/install-vscode.svg)](https://serverdex.io/install/vscode/com-chinataxcalc-mcp) [![Open in Claude Code](https://serverdex.io/brand/install-claude-code.svg)](https://serverdex.io/install/claude-code/com-chinataxcalc-mcp)

One click opens Cursor or VS Code with this server's config prefilled; the Claude Code button lands on the one-line command. The links point at Serverdex, so when your config changes the buttons keep working.

Install buttons — HTML for your docs

<a href="https://serverdex.io/install/cursor/com-chinataxcalc-mcp"><img src="https://serverdex.io/brand/install-cursor.svg" alt="Add to Cursor — via Serverdex" width="140" height="28"></a>
<a href="https://serverdex.io/install/vscode/com-chinataxcalc-mcp"><img src="https://serverdex.io/brand/install-vscode.svg" alt="Add to VS Code — via Serverdex" width="147" height="28"></a>
<a href="https://serverdex.io/install/claude-code/com-chinataxcalc-mcp"><img src="https://serverdex.io/brand/install-claude-code.svg" alt="Open in Claude Code — via Serverdex" width="180" height="28"></a>

Same buttons as plain links for a docs page or website.

Prefer a live badge with the score, stars and live check? Score badge (links to a page that explains the number and back to this listing).