# Taiwan Health MCP

> Let AI agents understand Taiwan healthcare. Open-source MCP server for FHIR Box, TW Core IG and Taiwan terminology. Free for dev, hosted for prod.

讓 AI agent 讀懂台灣醫療。開源的 MCP server，接上 FHIR Box 與台灣語彙標準。開發免費，正式環境我們託管。

Taiwan Health MCP is an open-source (MIT) Model Context Protocol (MCP) server by HealthyMind Tech. It exposes 63 tools in 12 groups so any MCP client (Claude Desktop, Claude Code, Cursor, Open WebUI) can query Taiwan FDA drug data, ICD-10, SNOMED CT, LOINC and RxNorm, and author and validate FHIR R4 resources against TW Core and other IGs. It is not a FHIR server: it reads and writes admin-registered external FHIR servers such as a hospital FHIR Box. The same tools are also served as an OpenAPI bridge.

## Quickstart

- [Connect with Claude Code](https://tw-health-mcp.healthymind-tech.com/en#connect): `claude mcp add taiwan-health https://tw-health-mcp.healthymind-tech.com/mcp`
- [Self-host with Docker](https://healthymind-tech.github.io/Taiwan-Health-MCP/en/getting-started/): `git clone https://github.com/healthymind-tech/Taiwan-Health-MCP.git && docker compose up -d` (gateway on :8080)
- [Live tool tester](https://tw-health-mcp.healthymind-tech.com/en/status): run any tool from the browser

## Tools

- [ICD-10 (5)](https://healthymind-tech.github.io/Taiwan-Health-MCP/tools/icd-tools/): Search ICD-10-CM / PCS diagnosis and procedure codes, infer complications, check code conflicts.
- [TFDA drugs (4)](https://healthymind-tech.github.io/Taiwan-Health-MCP/tools/drug-tools/): Taiwan FDA drug licences, package-insert OCR and pill identification by imprint, colour and shape.
- [Lab / LOINC (4)](https://healthymind-tech.github.io/Taiwan-Health-MCP/tools/lab-tools/): LOINC 2.80 lookup and lab-result interpretation against reference ranges.
- [SNOMED CT (4)](https://healthymind-tech.github.io/Taiwan-Health-MCP/tools/snomed-tools/): SNOMED CT International concepts, relationships and cross-terminology mappings.
- [FHIR Condition (2)](https://healthymind-tech.github.io/Taiwan-Health-MCP/tools/fhir-tools/): Build and validate FHIR R4 Condition resources from ICD-10 codes.
- [FHIR Medication (2)](https://healthymind-tech.github.io/Taiwan-Health-MCP/tools/fhir-tools/): Build and validate FHIR R4 Medication resources from Taiwan drug data.
- [FHIR IG authoring & validation (22)](https://healthymind-tech.github.io/Taiwan-Health-MCP/tools/fhir-ig-tools/): Multi-IG (TW Core and others) profiles, ValueSets, terminology validation, skeleton-fill authoring and deterministic grounding checks.
- [Health supplements (1)](https://healthymind-tech.github.io/Taiwan-Health-MCP/tools/health-supplements-tools/): Search Taiwan FDA-approved health food products.
- [Food & nutrition (4)](https://healthymind-tech.github.io/Taiwan-Health-MCP/tools/nutrition-tools/): Taiwan food composition data: nutrients, ingredients and meal analysis.
- [FHIR servers (3)](https://healthymind-tech.github.io/Taiwan-Health-MCP/tools/fhir-server-tools/): Read and (with explicit confirmation) write to external FHIR servers registered by an admin, such as a hospital FHIR Box.
- [Clinical calculators (11)](https://healthymind-tech.github.io/Taiwan-Health-MCP/tools/clinical-calculator-tools/): CHA₂DS₂-VASc, Wells PE / DVT, DAS28, CDAI, BMI, eGFR, HAS-BLED, CURB-65, qSOFA and GCS.
- [System (1)](https://healthymind-tech.github.io/Taiwan-Health-MCP/): Runtime readiness of the server and every data module.

## FHIR Box and TW Core

- [FHIR IG tools](https://healthymind-tech.github.io/Taiwan-Health-MCP/tools/fhir-ig-tools/): TW Core profiles, ValueSets, terminology validation, skeleton-fill authoring, validation aligned with HL7 validator_cli 7.0.1
- [FHIR server tools](https://healthymind-tech.github.io/Taiwan-Health-MCP/tools/fhir-server-tools/): read/write admin-registered external FHIR servers (e.g. FHIR Box); writes need allow-list + confirm_write=true
- [TW Core IG](https://twcore.mohw.gov.tw/ig/twcore/): Taiwan's FHIR core implementation guide (Ministry of Health and Welfare)

## Data sources

- [ICD-10-CM / ICD-10-PCS](https://www.cms.gov/medicare/coding-billing/icd-10-codes): CMS 2026-04-01
- [LOINC](https://loinc.org/): 2.80
- [SNOMED CT International](https://www.snomed.org/): International Edition
- [RxNorm](https://www.nlm.nih.gov/research/umls/rxnorm/): NLM
- [TW Core IG](https://twcore.mohw.gov.tw/ig/twcore/): FHIR R4
- [TFDA open data](https://data.fda.gov.tw/): Taiwan FDA
- [HL7 FHIR R4](https://hl7.org/fhir/R4/): validator_cli 7.0.1 aligned

## Pricing

- Community: MIT, self-hosted, free forever, no usage limits
- Hosted (operated by HealthyMind Tech): coming soon, monthly subscription; waitlist via https://www.healthymind-tech.com/en#contact
- Enterprise: OAuth / SSO, audit logs, on-premises hospital rollout, support; quoted per deployment, support@healthymind-tech.com

## Docs

- [FAQ](https://tw-health-mcp.healthymind-tech.com/en/faq): ten direct answers (FHIR Box, pricing, clients, licensing, PHI, offline deployment)
- [Documentation](https://healthymind-tech.github.io/Taiwan-Health-MCP/en/): getting started, deployment, modules, tools
- [About](https://tw-health-mcp.healthymind-tech.com/en/about): why the project exists and who maintains it (HealthyMind Tech)
- [Contact](https://tw-health-mcp.healthymind-tech.com/en/contact): GitHub Issues, hosted waitlist, Enterprise, security
- [Privacy Policy](https://tw-health-mcp.healthymind-tech.com/en/privacy) and [Data Processing Addendum](https://tw-health-mcp.healthymind-tech.com/en/dpa)
- [Source code](https://github.com/healthymind-tech/Taiwan-Health-MCP)

## Optional

- [Full tool list and FAQ](https://tw-health-mcp.healthymind-tech.com/llms-full.txt)
- [OpenAPI spec](https://tw-health-mcp.healthymind-tech.com/openapi.json)