ChinaVisaCalc MCP Server
This server has a remotely hosted endpoint. Open its connector listing for connection details, authentication requirements, and setup instructions:
ChinaVisaCalc MCP Server — China SAFEA Work Permit Points, Z-Visa, Apostille & Expat IIT Engine

Overview & Production Architecture
ChinaVisaCalc (https://chinavisacalc.com) exposes a stateless, zero-authentication Model Context Protocol (MCP) server (streamable-http at https://chinavisacalc.com/api/mcp) backed directly by TypeScript immigration and taxation engines covering China SAFEA Category A/B/C work-permit points, score-deficit optimization levers, MOF/STA Circular [2023] No. 29 expatriate tax allowances (extended through Dec 31, 2027), 30-day job-switching runway deadlines under PRC Labor Contract Law Articles 37 and 50, Hague Apostille rules across 21 countries, and municipal work permit comparisons across 7 Chinese economic hubs. All 8 tools are public, deterministic, and annotated readOnlyHint: true with zero API keys required.

Related MCP server: China Shebao & Payroll Tax MCP
Available MCP Tools (8 Read-Only Tools)
Tool Name | Purpose & Deterministic Engine | Key Parameters | Safety |
| Evaluate foreign applicant eligibility across standard points, native English teacher (7-country passport + 120h TEFL), or WFOE entrepreneur trac |
|
|
| Diagnose exact point gaps below Category B (60) or Category A (85) thresholds and rank concrete SAFEA upgrade levers such as HSK certification, > |
|
|
| Compare Option A fapiao-backed tax-exempt fringe benefits extended through 2027 (Circular [2023] No. 29) against Option B Tax App Special Additio |
|
|
| Compute statutory dates under PRC Labor Contract Law Articles 37 and 50 from a resignation date, pinpointing the 15-day release letter deadline, |
|
|
| Look up document authentication requirements across 21 issuing jurisdictions to distinguish single-step domestic Hague Apostille from dual-step C |
|
|
| Inspect and compare municipal processing speeds, Greater Bay Area or Hainan FTP 15% income tax rebates, Category B age-65 exceptions, and designa |
|
|
| Check statutory fast-track exemptions (6x local average wage by city, Top-100 postdoc, Fortune 500 executive, Top-100/Chinese Master recent gradu |
|
|
| Retrieve end-to-end procedural checklists for overseas Z-visa onboarding, in-country employer changes, X1/S1 status switches, 24h police accommod |
|
|
Live JSON-RPC 2.0 Verification Sample
Request (POST https://chinavisacalc.com/api/mcp):
curl -s -X POST https://chinavisacalc.com/api/mcp \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"calculate_job_transfer_runway_deadlines","arguments":{"resignationDate":"2026-12-01","employerWithholdingRelease":true}}}'Verified Production Response:
{
"sourceEngine": "src/components/TransitionRunwayCalculator.tsx + src/data/visaScenarios.ts",
"resignationDate": "2026-12-01",
"milestones": {
"step1WrittenNoticeDate": {
"date": "2026-11-01",
"rule": "30 days written advance notice required under PRC Labor Contract Law Art. 37."
},
"step2CancellationDeadline": {
"date": "2026-12-16",
"dayOffset": "Day +15",
"rule": "Former employer legally mandated to issue Release Letter (离职证明) & cancel work permit within 15 days (Labor Contract Law Art. 50)."
},
"step3SafeTransferSubmissionCutoff": {
"date": "2026-12-21",
"dayOffset": "Day +20",
"rule": "Recommended safe deadline for new sponsor to lodge online SAFEA transfer before Stay Permit expiry pressure mounts."
},
"step4StayPermitHardExpiry": {
"date": "2026-12-31",
"dayOffset": "Day +30",
"rule": "30-Day Humanitarian Stay Permit (T-Visa / 停留证) hard cutoff; must exit Mainland China if transfer application is not locked in."
}
},
"withholdingRemediationSop": {
"legalBasis": "PRC Labor Contract Law Article 50 (《劳动合同法》第五十条) — employers cannot legally withhold release papers over commercial disputes.",
"steps": [
"1. Formal Evidence Trail: Demand 《离职证明》 and 《外国人工作许可证注销证明》 within 3 business days via EMS or registered WeChat.",
"2. File Labor Arbitration: Apply at District Labor Dispute Arbitration Commission (劳动人事争议仲裁委员会) and secure 《仲裁立案通知书》.",
"3. SAFEA Unilateral Administrative Cancellation: Present Arbitration Notice + resignation proof + contract at Science & Technology Bureau window."
]
},
"transferSteps": [
{
"stepNumber": "01",
"title": "Cancellation of Current Work Permit by Former Employer",
"duration": "3 - 5 Business Days",
"partyResponsible": "Former Employer HR (via SAFEA system)",
"description": "Upon resigning, your former employer must submit a work permit cancellation request on the SAFEA system and issue you the official \"Work Permit Cancellation Certificate\" (外国人工作许可证注销证明) along with an Employment Release / Recommendation Letter.",
"requiredDocuments": [
"Work Permit Cancellation Certificate",
"Official Release Letter (离职证明) stating good standing and departure date"
],
"criticalTips": "Ensure the cancellation reason states \"Contract Expiration\" or \"Mutual Agreement Resignation\" to facilitate a seamless transfer without dispute notes."
},
{
"stepNumber": "02",
"title": "New Employer Submits Work Permit Transfer (Change of Employer)",
"duration": "5 - 10 Business Days",
"partyResponsible": "New Sponsoring Employer HR",
"description": "New employer logs into SAFEA to initiate an employer transfer. If the new job role falls in the same category/industry, re-authentication of overseas degrees and background checks is normally waived.",
"requiredDocuments": [
"Work Permit Cancellation Certificate",
"New Signed Labor Contract",
"New Company Business License",
"Previous Work Permit Card scan",
"Valid Passport & Residence Permit"
],
"criticalTips": "If your existing Residence Permit is expiring during the transfer window, apply for a 30-day Humanitarian/Stay Visa (T Visa / 停留证) at the Exit-Entry Bureau to maintain continuous legal status."
},
{
"stepNumber": "03",
"title": "Update Work Residence Permit at Exit-Entry Bureau (PSB)",
"duration": "5 - 7 Business Days",
"partyResponsible": "Applicant + New Employer HR",
"description": "Submit your updated Foreigner's Work Permit and application dossier to the local Public Security Bureau to update your sponsoring company on the Work Residence Permit sticker.",
"requiredDocuments": [
"New Foreigner's Work Permit Card/Confirmation",
"Application Form with New Company Stamp",
"Original Passport"
],
"criticalTips": "You DO NOT need to exit mainland China or apply for a new Z Visa during an in-country transfer as long as permits remain uninterrupted."
}
],
"officialGuideUrl": "https://chinavisacalc.com/guides/work-permit-transfer-process"
}Quick Client Configuration (Claude Desktop / Cursor / Windsurf / Hermes)
{
"mcpServers": {
"chinavisacalc": {
"type": "streamable-http",
"url": "https://chinavisacalc.com/api/mcp"
}
}
}Or inspect directly from any Node.js terminal via the pinned official CLI:
npx -y chinavisacalc-cli@1.0.0 tools
npx -y chinavisacalc-cli@1.0.0 demoStatutory Compliance & Reference Matrices
SAFEA Direct Category A 6x Local Average Wage Benchmarks
City / Economic Region | Monthly Salary Benchmark (6x) | Annual Gross Threshold (RMB) | Non-Degree Legal Impact |
Shanghai |
| ¥877,200 / yr | Direct Category A exemption: waives bachelor degree, age ceiling & 2-year experience |
Beijing |
| ¥858,000 / yr | Paperless online pre-approval (~5 business days Green Channel) |
Shenzhen / Guangzhou |
| ¥818,400 / yr | Eligible for Greater Bay Area 15% Individual Income Tax cap rebate |
Hangzhou / Chengdu / Wuhan |
| ¥624,000 / yr | Combines with +4 to +10 regional incentive points under Category B matrix |
Third-Tier / Western Cities |
| ¥456,000 / yr | National Key Development Zone & Western Corridor fast-track qualification |
Statutory Job-Switching Runway (PRC Labor Contract Law Art. 37 & Art. 50)
Legal Milestone | Statutory Offset | Controlling Chinese Statute & Operational Action |
Written Resignation Notice |
| Required 30-day formal written notice via traceable email or WeChat (Art. 37) |
Employer Release & Cancellation |
| Mandatory 15-day deadline for Release Letter (离职证明) & SAFEA cancellation (Art. 50) |
Safe Online Transfer Filing |
| Target submission cutoff on |
30-Day Stay Permit Cutoff |
| Hard expiry for Humanitarian T-Visa (停留证); file Labor Arbitration if withheld |
Municipal Fast-Track Turnarounds & Expat IIT Fringe Rules
City Hub | Cat A FWP Days | Cat B FWP Days | Regional Policy Highlight |
Shanghai |
|
| Single-Window combined FWP + Residence Permit in 7 days; Master's experience waiver |
Shenzhen |
|
| Greater Bay Area IIT 15% effective tax cap rebate; Qianhai license recognition |
Hangzhou |
|
| Digital economy fast-track & international graduate entrepreneurship residence |
Hainan FTP |
|
| 15% IIT tax cap + Category B age limit extended to 65 (vs 60 nationwide) |
Technical Architecture & Editorial Reference

Official Web Tools & Authoritative Guides
ChinaVisaCalc Official Portal — Work Permit Points & Z-Visa Calculator —
https://chinavisacalc.comChina Z-Visa Step-by-Step Application & Document Checklist —
https://chinavisacalc.com/z-visaForeigner Work Permit Category A/B/C Policy & Processing Guide —
https://chinavisacalc.com/work-visaChina Work Visa Legal Workarounds, Apostille & Transfer Guides —
https://chinavisacalc.com/guidesChina Work Visa Without a Bachelor Degree: 4 Legal SAFEA Workarounds —
https://chinavisacalc.com/guides/work-visa-without-degreeHow to Reach 60 Points for a Category B China Work Permit —
https://chinavisacalc.com/guides/how-to-reach-60-pointsChina Work Permit Tier A, B, and C Classification Explained —
https://chinavisacalc.com/guides/tier-a-b-c-explainedChina Hague Apostille & Document Authentication Country Guide —
https://chinavisacalc.com/guides/apostille-authentication-guideIn-China Work Permit Transfer & 30-Day Stay Permit Runway Guide —
https://chinavisacalc.com/guides/work-permit-transfer-processChina Foreign Language Teacher Z-Visa & 7-Nation Native Speaker Rule —
https://chinavisacalc.com/guides/english-teacher-visa-china
License
MIT License — maintained by ChinaVisaCalc.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Verify China 240h TWOV transit, customs meds, work permit points, expat IIT & CAAC limits.
81Read-only payroll calculations and multi-country tax comparisons for eight countries.
Deterministic China trade compliance: GACC customs, CCC clearance, and PIPL transfers.
Mira, by Mirabello: verified, source-cited data on citizenship and residency by investment, golden visas, immigration pathways, visa requirements, naturalisation and tax residency across 190+ countries. 68 tools, remote, no key needed. Built and operated by Mirabello Consultancy (Zurich, Dubai, Hong Kong): https://www.mirabelloconsultancy.com/mcp. General information, not legal, tax or immigration advice.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables geographic parity analysis with 26 read-only tools covering purchasing power, salary localization, cost of living, nomad visas, tax residency, FIRE planning, and relocation costs.13 npmMIT
- AlicenseNot gradedqualityCmaintenanceEnables querying provincial social security policies and city housing-fund limits, calculating take-home salary, income tax, annual bonus tax options, and retirement pension estimates across China.MIT
- FlicenseNot gradedqualityCmaintenanceEnables agents to verify China 24/240-hour visa-free transit eligibility, validate third-country itineraries, calculate legal stay deadlines, look up approved ports and stay zones, and generate airline check-in document checklists.-
- AlicenseNot gradedqualityCmaintenanceEnables agents to search verified upcoming China B2B trade shows, book on-the-ground remote exhibition booth walks, scope Shenzhen hardware prototyping timelines and costs, calculate AQL/ISO 2859-1 inspection sample sizes, and submit project inquiries or RFQs. It also exposes current service pillars, pricing, and contact details for supplier sourcing, interpreting, and third-party QC coordination.1MIT