HK Express MCP server for AI agents
Let Claude, ChatGPT or your own agent read HK Express: 2 typed functions through one MCP server. No HK Express API key needed.
- Site
- hkexpress.com
- Functions
- 2
- Sign-in
- Not needed
- Works with
- MCP, HTTP, Node, Python
Connect
Just HK Express
An MCP server for HK Express alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.
https://api.bowmark.ai/mcp/site/hkexpressEvery site
One MCP server for HK Express and every other site Bowmark covers. Your agent looks up what it needs and calls it.
https://api.bowmark.ai/mcpSet it up in your clientBoth need a Bowmark API key. The quickstart gets you one and a first result in a few minutes.
Functions
Open a function to see its arguments, what it returns and how to call it.
Read 2
getFareCalendarThe lowest cached one-way HK Express fare for each departure day on one route and date range, from the fare cache HK Express's own fare pages display.Arguments
Name Type Required originstringYes destinationstringYes fromstringNo tostringNo Returns
HkexpressFareCalendarinterface HkexpressFare { departureDate: string; price: number; currency: string; usdPrice: number | null; seenAt: string | null; } interface HkexpressFareCalendar { origin: string; destination: string; from: string; to: string; days: HkexpressFare[]; lowest: HkexpressFare | null; bookingUrl: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/hkexpress/getFareCalendarCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.hkexpress.getFareCalendar({ origin: "HKG", destination: "BKK" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.hkexpress.getFareCalendar({"origin": "HKG", "destination": "BKK"}))curl -X POST https://api.bowmark.ai/v1/sites/hkexpress/getFareCalendar \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"origin":"HKG","destination":"BKK"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.hkexpress.getFareCalendar({ origin: "HKG", destination: "BKK" });listRoutesHK Express's route network as its fare cache knows it: every origin/destination pair with city and country names and the cheapest cached one-way fare.Arguments
Name Type Required originstringNo destinationstringNo Returns
{ routes: HkexpressRoute[] }interface HkexpressFare { departureDate: string; price: number; currency: string; usdPrice: number | null; seenAt: string | null; } interface HkexpressRoute { origin: string; originCity: string | null; originCountry: string | null; destination: string; destinationCity: string | null; destinationCountry: string | null; lowestFare: HkexpressFare | null; bookingUrl: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/hkexpress/listRoutesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.hkexpress.listRoutes({ origin: "HKG" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.hkexpress.listRoutes({"origin": "HKG"}))curl -X POST https://api.bowmark.ai/v1/sites/hkexpress/listRoutes \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"origin":"HKG"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.hkexpress.listRoutes({ origin: "HKG" });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/hkexpress/<function> - OpenAPI
/v1/sites/hkexpress/openapi.json