Skip to content
MCP server

ChinaVisaCalc — China Work Permit Points, Z-Visa, Apostille & Expat Tax Engine

MCP server for China work permit points, Z-visa timelines, apostille rules and expat tax

Install
Pricing
Free
Platforms
API, CLI, Self-hosted
Runs
Remotely
Version
1.0.0
Listing updated
1 day ago

Similar MCP servers

About ChinaVisaCalc — China Work Permit Points, Z-Visa, Apostille & Expat Tax Engine

ChinaVisaCalc — China Work Permit Points, Z-Visa, Apostille & Expat Tax Engine is a free MCP server for legal and government. It runs as a hosted remote server, so there is nothing to install locally.

The README describes this as a read-only Model Context Protocol server, reachable over streamable HTTP at a public endpoint with no API key, that wraps calculation engines for China's foreign work permit system. Clients can ask it to score an applicant against the SAFEA Category A, B and C thresholds, suggest which point levers would close a gap, and walk through job-switching deadlines under the Labor Contract Law articles it cites.

The same toolset covers document authentication for a handful of issuing countries, municipal processing times for several major cities, and a comparison of traditional fapiao-based tax allowances against the Tax App special deductions for the annual income tax refund. Each tool is marked read-only, so an assistant can run the numbers without writing anything back to a user's accounts.

The server is aimed at relocation consultants, HR teams and expatriates who want an assistant to work through China visa and tax questions with concrete dates and thresholds. Its outputs are rule-based estimates tied to the sources it names, so the official SAFEA, Exit-Entry Bureau and tax authority channels remain the reference for any filing.

Install

Run in a terminal

claude mcp add --transport http mcp https://chinavisacalc.com/api/mcp

Add to Settings → Connectors → Add custom connector

https://chinavisacalc.com/api/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp": {
      "url": "https://chinavisacalc.com/api/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "mcp": {
      "type": "http",
      "url": "https://chinavisacalc.com/api/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp": {
      "serverUrl": "https://chinavisacalc.com/api/mcp"
    }
  }
}

Add to Grok Bot desktop app → Connect apps → Add a custom connector

https://chinavisacalc.com/api/mcp

Enter a Name (for example "ChinaVisaCalc — China Work Permit Points, Z-Visa, Apostille & Expat Tax Engine"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.

Full Grok Bot setup guide

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mcp": {
      "type": "http",
      "url": "https://chinavisacalc.com/api/mcp"
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (8)

Taken from the project documentation; the running server may differ.

calculate_safea_work_permit_points
Evaluates foreign applicant eligibility across standard points, native English teacher and WFOE entrepreneur tracks.
optimize_work_permit_score_deficit
Diagnoses point gaps below the Category B and A thresholds and ranks SAFEA upgrade levers.
simulate_expat_iit_and_tax_refund
Compares fapiao-backed tax-exempt allowances against Tax App special additional deductions.
calculate_job_transfer_runway_deadlines
Computes statutory dates for notice, release letter, transfer filing and the 30-day stay permit.
verify_country_apostille_and_legalization
Looks up document authentication requirements for listed issuing jurisdictions.
compare_municipal_work_permit_policies
Compares municipal processing speeds and local incentives between cities.
evaluate_fast_track_and_no_degree_pathways
Checks statutory fast-track exemptions and no-degree pathways by salary and experience.
generate_visa_execution_roadmap_and_arrival_kit
Retrieves procedural checklists for overseas Z-visa onboarding, in-country changes and arrival steps.

What it does

Work permit points scoring
Evaluates an applicant's standard points, with separate tracks for native English teachers and WFOE entrepreneurs.
Score gap optimizer
Shows how far an applicant sits below the Category B and A thresholds and ranks possible improvements.
Expat tax comparison
Compares fapiao-backed allowances with Tax App special additional deductions for a given salary and rent.
Job transfer deadlines
Calculates the notice, release letter, transfer filing and 30-day stay permit dates from a resignation date.
Apostille lookup
Returns the authentication route for documents from listed issuing countries.
Municipal comparison
Compares processing times and local incentives across several Chinese cities and economic zones.

Good for

  • Estimate whether a job offer meets the Category B points threshold before applying
  • Plan the legal timeline for switching employers without leaving China
  • Check whether diplomas and background checks need an apostille or embassy legalization
  • Compare expected annual tax refunds under the two allowance structures
  • Assemble a step-by-step Z-visa and residence permit checklist for a relocation

Pricing

Free

Free public MCP endpoint with no API key listed.

Prices change. Check chinavisacalc.com before you buy.

ChinaVisaCalc — China Work Permit Points, Z-Visa, Apostille & Expat Tax Engine FAQ

Does the server require authentication?

The README says it is stateless and zero-authentication, with no API keys required.

How is it connected to an AI client?

The README gives a streamable-http configuration pointing to the public endpoint, and notes it works with Claude Desktop, Cursor and Windsurf.

Which tools are available?

The README lists eight read-only tools covering points scoring, score gaps, tax simulation, transfer deadlines, apostille rules, municipal comparison, fast-track pathways and the visa roadmap.

How many countries does apostille lookup cover?

The README states 21 issuing jurisdictions.

Is ChinaVisaCalc — China Work Permit Points, Z-Visa, Apostille & Expat Tax Engine free?

Yes. ChinaVisaCalc — China Work Permit Points, Z-Visa, Apostille & Expat Tax Engine is free to use.

How do I add ChinaVisaCalc — China Work Permit Points, Z-Visa, Apostille & Expat Tax Engine to Claude Code?

Run this command in your terminal: claude mcp add --transport http mcp https://chinavisacalc.com/api/mcp

What are the best alternatives to ChinaVisaCalc — China Work Permit Points, Z-Visa, Apostille & Expat Tax Engine?

The closest alternatives to ChinaVisaCalc — China Work Permit Points, Z-Visa, Apostille & Expat Tax Engine are ChinaKit — China Travel, Visa, Meds, Tax & Payment Compliance Engine, China Visa & Regulation Data, Korea Tax Calculator, Transita and Visarun.

Where this comes from

  • Description: written from the project's README, the project's website and its MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers