HK Transit Cost — MTR fares and the government fare subsidy

Official4 tools

by hk-transit

Hong Kong MTR fares and the government fare subsidy, computed and recorded.

app.rowb.hk-transit/fares — Model Context Protocol (MCP) Server

This MCP server provides Hong Kong MTR fares along with the government fare subsidy. It computes and records fare information, exposing that data for use by developer tools and applications that integrate via MCP.

🛠️ Key Features

Hong Kong MTR fares data
Government fare subsidy information
Fare computation and recording

🚀 Use Cases

Retrieving computed MTR fare and subsidy values
Using recorded fare data in downstream MCP-enabled workflows

⚡ Developer Benefits

Structured access to fare and subsidy data via MCP
Reusable computed outputs stored for subsequent retrieval

⚠️ Limitations

Limited details are available beyond fare computation/recording and the two data categories (fares and subsidy).

Captured live from the server via tools/list.

mtr_fare

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.

Parameters2

from	string	required	Origin station name (e.g. "Central") or MTR station id (e.g. "1").
to	string	required	Destination station name (e.g. "Tsim Sha Tsui") or MTR station id (e.g. "3").

Raw 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

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.

Parameters2

octopus	number	optional	Public transport expenses in HKD recorded under the Octopus account this month (0 if none).
alipay	number	optional	Public transport expenses in HKD recorded under the AlipayHK account this month (0 if none).

Raw 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

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.

Parameters6

date	string	required	Travel date, YYYY-MM-DD.
from	string	required	Origin, e.g. "Central".
to	string	required	Destination, e.g. "Tsim Sha Tsui".
fare	number	required	Fare paid in HKD, e.g. 10.6
mode	string	required	Transport mode.
paid_with	string	required	Which account paid the fare.

Raw 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

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.

Parameters1

month

string

optional

Month as YYYY-MM. Defaults to the current month.

Raw schema

{
  "type": "object",
  "properties": {
    "month": {
      "type": "string",
      "description": "Month as YYYY-MM. Defaults to the current month."
    }
  },
  "required": [],
  "additionalProperties": false
}

Install

Tools (4)

mtr_faresubsidy_amountlog_tripmonthly_summary

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://hk-transit.rowb.app/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "fares": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://hk-transit.rowb.app/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

app.rowb.hk-transit/fares — Model Context Protocol (MCP) Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

mtr_fare

subsidy_amount

log_trip

monthly_summary

Install

Remote endpoint

Related servers