Repository avatar
Other Tools
v1.0.0
active

mcp

io.chinakit/mcp

Verify China 240h TWOV transit, customs meds, work permit points, expat IIT & CAAC limits.

Documentation

ChinaKit MCP Server — China Inbound Travel, Visa, Meds, Tax & Payment Engine

ChinaKit MCP Banner

Overview & Production Architecture

ChinaKit (https://chinakit.io) exposes a stateless, zero-authentication Model Context Protocol (MCP) server (streamable-http at https://chinakit.io/api/mcp) backed directly by TypeScript compliance engines covering China work-permit points, border medication screening, expatriate individual income tax (IIT), 240h/144h visa-free transit routing, Hague Apostille legalization, CAAC flight cabin lithium watt-hour rules, and 331 verified attraction guides. All 8 tools are public, deterministic, and annotated readOnlyHint: true with zero API keys required.

ChinaKit Interactive Compliance Tools

Available MCP Tools (8 Read-Only Tools)

Tool NamePurpose & Deterministic EngineKey ParametersSafety
calculate_china_work_permit_pointsScore an applicant under the China SAFIEA work permit rubric (Category A >=85, Category B >=60, Category C <60), detect 6x local average wage orage, education, topUniversityGrad, workExperienceYears* (+9 more)readOnly
check_china_customs_medication_legalityScreen personal prescription drugs and over-the-counter remedies by English brand, generic ingredient, or Chinese alias against China Customs ClamedicationQuery*, categoryFilterreadOnly
calculate_china_expat_iit_and_bonusSimulate annual expatriate individual income tax liability in Mainland China comparing Seven Tax-Exempt Allowances (housing, schooling, home leavmonthlyGrossSalary*, annualBonusRMB, bonusTaxTreatment, citySocialSecurityScheme (+8 more)readOnly
validate_china_transit_and_visa_free_entryInspect unilateral 15/30-day visa-waiver eligibility or 54-nation Transit Without Visa (TWOV) admissibility, verify A-B-C third-region flight comnationality, originCountry, transitPortCode, destinationCountry* (+5 more)readOnly
query_china_document_apostille_stepsRetrieve country-specific legalization workflows for background checks, diplomas, TEFL, and marriage certificates used in China visa filings, flacountryIso, docTypeIdreadOnly
recommend_china_essential_apps_and_paymentSearch curated step-by-step setup guides for Alipay, WeChat Pay, Didi, 12306 rail booking, Amap navigation, and eSIM apps using foreign passportsappSlugOrQuery, categoryreadOnly
lookup_china_destination_foreigner_guideQuery verified attraction entry requirements across China cities (Beijing, Shanghai, Chengdu, Macau, etc.), returning turnstile passport scanningcityOrAttraction*, limitreadOnly
calculate_caac_powerbank_and_alipay_splitCompute lithium battery watt-hours (mAh * V / 1000) against Civil Aviation Administration of China 100Wh/160Wh carry-on prohibitions AND split ancapacityMah*, voltageV, paymentAmountRmbreadOnly

Live JSON-RPC 2.0 Verification Sample

Request (POST https://chinakit.io/api/mcp):

curl -s -X POST https://chinakit.io/api/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"calculate_caac_powerbank_and_alipay_split","arguments":{"capacityMah":20000,"voltageV":3.7,"paymentAmountRmb":480}}}'

Verified Production Response:

{
  "powerbank": {
    "capacityMah": 20000,
    "voltageV": 3.7,
    "wattHours": 74,
    "caacStatus": "ALLOWED_UNRESTRICTED",
    "maxAllowedUnits": 2,
    "checkedBaggageAllowed": false,
    "caacRule": "Carry-on cabin luggage allowed without airline pre-approval (≤ 100Wh). Checked baggage is strictly forbidden; mAh/Wh label must remain clearly legible.",
    "toolUrl": "https://chinakit.io/tools/powerbank-calculator"
  },
  "alipayFeeOptimizer": {
    "totalAmountRmb": 480,
    "feeExemptionThresholdRmb": 200,
    "singleTransaction3PctFeeRmb": 14.4,
    "recommendedSplitTransactionsRmb": [
      200,
      200,
      80
    ],
    "splitTransactionFeeRmb": 0,
    "netFeeSavedRmb": 14.4,
    "toolUrl": "https://chinakit.io/tools/fee-splitter"
  }
}

Quick Client Configuration (Claude Desktop / Cursor / Windsurf / Hermes)

{
  "mcpServers": {
    "chinakit": {
      "type": "streamable-http",
      "url": "https://chinakit.io/api/mcp"
    }
  }
}

Or run directly in any Node.js terminal via the pinned official CLI:

npx -y chinakit-cli@1.0.0 tools
npx -y chinakit-cli@1.0.0 demo

Domain Reference Specifications & Statutory Matrices

Work Permit Category A/B/C City Wage Benchmarks (SAFIEA Matrix)

City TierRepresentative CitiesMonthly Avg Wage (RMB)6x Direct Category A Annual Threshold (RMB)
Tier 1 Mega (tier1_super)Beijing, Shanghai¥12,183¥877,200 / yr (¥73,100 / mo)
Tier 1 (tier1)Shenzhen, Guangzhou, Hangzhou, Suzhou¥11,000¥792,000 / yr (¥66,000 / mo)
Tier 2 (tier2)Chengdu, Wuhan, Xi'an, Qingdao¥8,500¥612,000 / yr (¥51,000 / mo)
Other Regions (other)Haikou, Kunming, Dalian, Ningbo¥6,500¥468,000 / yr (¥39,000 / mo)

CAAC Aviation Lithium Battery & Alipay Foreign Card Thresholds

Compliance RuleStatutory Formula / ThresholdOperational Rule for Travelers
CAAC Unrestricted Carry-OnWh = (mAh * V) / 1000 <= 100 WhPermitted in cabin baggage without pre-approval; checked luggage strictly prohibited
CAAC Airline-Approved Carry-On100 Wh < Wh <= 160 WhRequires airline check-in approval; maximum 2 spare power banks per passenger
CAAC Cabin & Train Ban> 160 Wh or unmarked capacityConfiscated at airport security; strictly banned from aircraft cabin and cargo
Alipay / WeChat Foreign Card<= ¥200 RMB per transaction0% international surcharge (3% fee applies automatically above ¥200 single swipe)

Controlled Medication & Hague Apostille Quick Reference

SubjectCritical Compliance ThresholdSource Engine / Statutory Trap
Class I Psychotropic (Adderall / Ritalin)Maximum 7-day personal supplyMust declare at Customs Red Channel with stamped English medical diagnosis
Class II Psychotropic (Xanax / Zolpidem)Maximum 7-day personal supplyOriginal pharmacy bottle with matching passport name required
US FBI Identity History SummaryFederal Apostille (~25 days)Trap: State-level Apostille is rejected by Chinese PSB; requires U.S. Dept. of State
Unilateral 15/30d vs 240h TWOVFRA / DEU / KOR / AUS vs USA / GBRUnilateral waiver nations bypass A-B-C transit checks; TWOV strictly requires A != C

Technical Architecture & Editorial Reference

ChinaKit Architecture Matrix

Official Web Tools & Deep Documentation

License

MIT License — maintained by ChinaKit.

No installation packages available.

Remote