HK Transit Cost — MTR fares and the government fare subsidy
Hong Kong MTR fares and the government fare subsidy, computed and recorded.
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"fares": {
"url": "https://hk-transit.rowb.app/mcp"
}
}
}Remote endpoints
https://hk-transit.rowb.app/mcpstreamable-httpWhat it can do
Tool inventory
Tools (4)
🟢mtr_fare(from, to)
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.
Input Schema
{
"type": "object",
"properties": {
"from": {
"type": "string",
"description": "Origin station name (e.g. \"Central\") or MTR station id (e.g. \"1\")."
},
"to": {
"type": "string",
"description": "Destination station name (e.g. \"Tsim Sha Tsui\") or MTR station id (e.g. \"3\")."
}
},
"required": [
"from",
"to"
],
"additionalProperties": false
}🟢subsidy_amount(octopus, alipay)
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.
Input Schema
{
"type": "object",
"properties": {
"octopus": {
"type": "number",
"description": "Public transport expenses in HKD recorded under the Octopus account this month (0 if none)."
},
"alipay": {
"type": "number",
"description": "Public transport expenses in HKD recorded under the AlipayHK account this month (0 if none)."
}
},
"required": [],
"additionalProperties": false
}⚪log_trip(date, from, to, fare, mode, ...)
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.
Input Schema
{
"type": "object",
"properties": {
"date": {
"type": "string",
"description": "Travel date, YYYY-MM-DD."
},
"from": {
"type": "string",
"description": "Origin, e.g. \"Central\"."
},
"to": {
"type": "string",
"description": "Destination, e.g. \"Tsim Sha Tsui\"."
},
"fare": {
"type": "number",
"description": "Fare paid in HKD, e.g. 10.6"
},
"mode": {
"type": "string",
"enum": [
"mtr",
"bus",
"ferry",
"minibus",
"tram"
],
"description": "Transport mode."
},
"paid_with": {
"type": "string",
"enum": [
"octopus",
"alipayhk"
],
"description": "Which account paid the fare."
}
},
"required": [
"date",
"from",
"to",
"fare",
"mode",
"paid_with"
],
"additionalProperties": false
}⚪monthly_summary(month)
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.
Input Schema
{
"type": "object",
"properties": {
"month": {
"type": "string",
"description": "Month as YYYY-MM. Defaults to the current month."
}
},
"required": [],
"additionalProperties": false
}Community
Evidence