Hong Kong MTR fares and the government fare subsidy, computed and recorded.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Record one public transport trip (date, from, to, fare, mode, which account paid) so it counts towards a monthly total and the subsidy estimate. Writes to your own ledger; a bearer API key is required and the call counts against the same monthly allowance as the REST endpoint.
Destination, e.g. "Tsim Sha Tsui".
Travel date, YYYY-MM-DD.
Fare paid in HKD, e.g. 10.6
Origin, e.g. "Central".
Transport mode.
Which account paid the fare.
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Record one public transport trip (date, from, to, fare, mode, which account paid) so it counts towards a monthly total and the subsidy estimate. Writes to your own ledger; a bearer API key is required and the call counts against the same monthly allowance as the REST endpoint.
| Argument | Type | Description |
|---|---|---|
| to* | string | Destination, e.g. "Tsim Sha Tsui". |
| date* | string | Travel date, YYYY-MM-DD. |
| fare* | number | Fare paid in HKD, e.g. 10.6 |
| from* | string | Origin, e.g. "Central". |
| mode* | string | Transport mode. |
| paid_with* | string | Which account paid the fare. |
{
"type": "object",
"required": [
"date",
"from",
"to",
"fare",
"mode",
"paid_with"
],
"properties": {
"to": {
"type": "string",
"description": "Destination, e.g. \"Tsim Sha Tsui\"."
},
"date": {
"type": "string",
"description": "Travel date, YYYY-MM-DD."
},
"fare": {
"type": "number",
"description": "Fare paid in HKD, e.g. 10.6"
},
"from": {
"type": "string",
"description": "Origin, e.g. \"Central\"."
},
"mode": {
"enum": [
"mtr",
"bus",
"ferry",
"minibus",
"tram"
],
"type": "string",
"description": "Transport mode."
},
"paid_with": {
"enum": [
"octopus",
"alipayhk"
],
"type": "string",
"description": "Which account paid the fare."
}
},
"additionalProperties": false
}Totals for one month from the trips you recorded: trip count, total fare, breakdown by mode and by payment account, and the subsidy estimate computed separately for the Octopus and AlipayHK accounts. Requires a bearer API key.
| Argument | Type | Description |
|---|---|---|
| month | string | Month as YYYY-MM. Defaults to the current month. |
{
"type": "object",
"required": [],
"properties": {
"month": {
"type": "string",
"description": "Month as YYYY-MM. Defaults to the current month."
}
},
"additionalProperties": false
}Look up the published MTR fare between two stations in Hong Kong, by station name or MTR station id. Returns the Octopus adult/student/JoyYou-sixty/child/elderly/PWD fares and the single-journey adult fare in HKD, with the open-data source URL. Deterministic: same input, same answer. Read-only. No key required.
| Argument | Type | Description |
|---|---|---|
| to* | string | Destination station name (e.g. "Tsim Sha Tsui") or MTR station id (e.g. "3"). |
| from* | string | Origin station name (e.g. "Central") or MTR station id (e.g. "1"). |
{
"type": "object",
"required": [
"from",
"to"
],
"properties": {
"to": {
"type": "string",
"description": "Destination station name (e.g. \"Tsim Sha Tsui\") or MTR station id (e.g. \"3\")."
},
"from": {
"type": "string",
"description": "Origin station name (e.g. \"Central\") or MTR station id (e.g. \"1\")."
}
},
"additionalProperties": false
}Compute the Hong Kong Public Transport Fare Subsidy Scheme amount for one month, from the expenses recorded under an Octopus account and an AlipayHK account. Rule taken verbatim from the Government page: one-third of the monthly public transport expenses in excess of a $500 threshold, capped at $400 per month per account; the two accounts are never combined. Returns both the truncated whole-dollar figure and the exact one-third figure. Deterministic arithmetic only. Read-only. No key required.
| Argument | Type | Description |
|---|---|---|
| alipay | number | Public transport expenses in HKD recorded under the AlipayHK account this month (0 if none). |
| octopus | number | Public transport expenses in HKD recorded under the Octopus account this month (0 if none). |
{
"type": "object",
"required": [],
"properties": {
"alipay": {
"type": "number",
"description": "Public transport expenses in HKD recorded under the AlipayHK account this month (0 if none)."
},
"octopus": {
"type": "number",
"description": "Public transport expenses in HKD recorded under the Octopus account this month (0 if none)."
}
},
"additionalProperties": false
}