# com.vhishongkong/vhis

> Price all 579 VHIS certified plans in Hong Kong, read filed terms, see premium increases since 2021

- name: com.vhishongkong/vhis
- version: 1.0.0
- connection class: R0 (autonomous)
- trust: 90/100
- quality: 86/100 (good)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/com.vhishongkong%2Fvhis
- tools: https://api.protogrid.dev/v1/servers/com.vhishongkong%2Fvhis/tools

**An agent can connect right now, no human step.** Remote endpoint, no authentication, reachable on the last probe.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "vhis": {
      "type": "http",
      "url": "https://mcp.vhishongkong.com/mcp"
    }
  }
}
```


## Trust

- hygiene: 100
- liveness: 100
- freshness: 85
- provenance: 75
- drivers: +repository +dns-namespace +reachable +uptime-100% ~updated-33d-ago
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 86/100 (good)

### protocol: 75 (weight 25)

- warn `protocol.modern`: newest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
- n/a `protocol.stateless`: only applies to 2026-07-28 servers
- pass `protocol.transport`: streamable HTTP
- n/a `protocol.list_ttl`: only applies to 2026-07-28 servers

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 100 (weight 30)

- pass `tools.descriptions`: every tool has a description
- pass `tools.description_length`: descriptions are concise
- pass `tools.schemas`: every tool has an object input schema
- pass `tools.annotations`: 16 of 16 tools declare readOnlyHint or destructiveHint
- pass `tools.directory_hints`: every tool declares readOnlyHint, destructiveHint, idempotentHint and openWorldHint
- pass `tools.token_cost`: about 4,029 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: 75 (weight 15)

- warn `stability.changes`: 18 tool changes in 30 days
- pass `stability.rug_pull`: no tool changed its meaning under the same name

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 16, about 4,029 tokens to load them all
- tool set hash: ef6dffa03921f91cbabf70740cc6790b
- tools last changed: 2026-09-28T04:12:30.535Z
- badge: [![protogrid quality](https://protogrid.dev/badge/com.vhishongkong/vhis.svg)](https://protogrid.dev/servers/com.vhishongkong/vhis)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

- 2026-09-28 `fetch` changed (annotations)
- 2026-09-28 `search` changed (annotations)
- 2026-09-28 `treatment_cost` changed (annotations)
- 2026-09-28 `list_insurers` changed (annotations)
- 2026-09-28 `adviser_notes` changed (annotations)
- 2026-09-28 `search_plan_terms` changed (annotations)
- 2026-09-28 `estimate_renewal` changed (annotations)
- 2026-09-28 `insurer_increases` changed (annotations)
- 2026-09-28 `premium_history` changed (annotations)
- 2026-09-28 `compare_plans` changed (annotations)

Full history: https://api.protogrid.dev/v1/servers/com.vhishongkong%2Fvhis/changes

## Remotes

- https://mcp.vhishongkong.com/mcp (streamable-http, auth none, reachable true, uptime30d 1)

## Packages

_none_

## Tools (16)

- `adviser_notes`: Curated notes from licensed advisers and the scheme rules: how underwriting works, what usually happens with
    common conditions, switching, claims practice, tax. Guidance, not plan terms.
- `compare_plans`: Side by side on what actually differs: premium now and at 65, next-year range, deductible, room class, limits,
    area and each insurer's rate record. Use it for "which is better" and "why is one cheaper"; state the trade-off and
    let the person choose. Needs a key on the public server; without one it returns key_required and tells the user where to get one.
- `create_lead`: Pass the person to a licensed adviser: saves the enquiry, emails them their shortlist, emails the adviser and
    returns a WhatsApp link and a reference. Only call it once they have given a name and a phone number or email and
    have said they want to be contacted. Never put a health detail in the note; the adviser asks directly. Needs a key on the public server; without one it returns key_required and tells the user where to get one.
- `estimate_renewal`: The premium at age plus one on the current schedule, which is certain unless the insurer refiles, plus a low,
    mid and high range built from this plan's own rate changes since 2021. Needs a key on the public server; without one it returns key_required and tells the user where to get one.
- `fetch`: The full record behind a search id: what the plan pays and every term as filed, with the page of each clause.
- `find_plans`: The plan finder. Ranks every eligible VHIS plan on what it covers and what it really costs, and returns three
    explained picks (lowest cost over the period, best coverage for the money, most comprehensive) with a ranked list
    behind them. Coverage is read from each plan's Benefit Schedule; cost is the published premium for every year from
    this age, and the same again with the insurer's own filed rate changes applied. Age is the only thing it needs;
    pass whatever else the person has actually said.
- `insurer_increases`: An insurer's rate record across all its VHIS plans since 2021, by year, alongside the market table with every
    insurer ranked from lowest average annual change to highest.
- `list_insurers`: Every insurer this server can price, with how many certified plans and rate tables each has loaded.
- `plan_coverage`: What one plan actually pays, item by item from its own Benefit Schedule: full cover or the published cap on
    room and board, hospital charges, surgeon's fee, imaging, cancer treatment and psychiatric care, plus the annual
    and lifetime limits, room class, territory, extras and a coverage score. Use it for "what does this cover", "is
    surgery covered in full", "does it include outpatient".
- `plan_options`: Every option sold under one certification number, with its room class, deductible and area, priced at this age
    when an age is given, plus what the premium becomes every five years to twenty years out.
- `plan_terms`: The plan's terms as filed with the Health Bureau, field by field with the page each came from: guaranteed
    renewal age, entry ages, pre-existing condition schedule, waiting period, room class and higher-room rule,
    territory, full cover, limits, deductible basis, coinsurance, outpatient, psychiatric, cancer, extras, cancellation,
    switching and exclusions beyond the standard list. Use it for "does it cover X", "what is the rule on Y" and terms
    comparisons; cite the page.
- `premium_history`: How a plan's premium has moved since 2021: every schedule the insurer filed, the premium at this age under each
    one with the age held constant, the year-on-year changes and the average. Use it for "has this gone up" and "is
    this insurer stable".
- `price_plans`: Every matching plan ranked by annual premium alone, with no view on coverage. Use it when someone asks for the
    cheapest, for a full list, or for one insurer's prices. When what the plan covers matters, use find_plans. Needs a key on the public server; without one it returns key_required and tells the user where to get one.
- `search`: Search every certified plan document and return matching records, each with an id, a title, a page link and the
    clause text. Call fetch with an id for that plan's full record. search_plan_terms is the same search with richer
    output; this pair exists because some clients look for tools named search and fetch.
- `search_plan_terms`: Search the official Terms and Benefits of the certified plans and return the clauses, each with the plan, Part,
    Section, page and a link to that page. Use it for exclusions, waiting periods, limits, room class rules,
    territorial scope, definitions, renewal and cancellation. Never state what a plan says without it.
- `treatment_cost`: What Hong Kong private hospitals published they actually billed for a procedure, hospital by hospital, with
    the doctor's fee and the hospital's charge separately, and what a named plan would pay of it. From the
    government's price transparency platform, not an estimate. Bills differ several-fold between hospitals, so never
    quote a single figure for Hong Kong without saying which hospital it belongs to.
