wheels-router

What I do

I help you plan public transit trips anywhere in the world by connecting to the Wheels Router MCP server.

For Hong Kong trips, I use the Wheels Router API which provides:

• Detailed routing with MTR, bus, tram, ferry, and walking


• Real-time schedules and accurate fares


• Platform information and exit details


• Interchange discounts (轉乘優惠) when available

For worldwide trips, I use the Transitous API which covers:

• Major cities globally with transit data


• Basic routing with public transportation


• Walking directions and transfers

When to use me

Use this skill whenever you need to:

• Plan a trip using public transportation


• Find the best route between two locations


• Check transit schedules and connections


• Get fare estimates for Hong Kong transit


• Search for locations before planning routes

Examples:

• "How do I get from Yau Tong MTR to Hong Kong Airport?"


• "What's the best way to Central from Causeway Bay right now?"


• "Plan a trip from Tokyo Station to Shibuya"


• "Search for locations near Victoria Park"

How to connect

If you're using mcporter (clawdbot, etc.)

Follow your mcporter skill, if you don't have one follow below:
Add to config/mcporter.json:

{
  "mcpServers": {
    "wheels-router": {
      "description": "Plan public transit trips globally",
      "baseUrl": ""
    }
  }
}

Then call tools directly:

npx mcporter call wheels-router.search_location query="Hong Kong Airport"
npx mcporter call wheels-router.plan_trip origin="22.28,114.24" destination="22.31,113.92"

For other MCP clients

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "wheels-router": {
      "command": "npx",
      "args": ["mcp-remote", ""]
    }
  }
}

Cursor/Windsurf/VS Code (.cursor/mcp.json or similar):

{
  "mcpServers": {
    "wheels-router": {
      "command": "npx",
      "args": ["mcp-remote", ""]
    }
  }
}

Available tools

search_location

Search for places before planning trips. Always use this first if you don't have exact coordinates.

Parameters:

• query (required): Place name or address (e.g., "Hong Kong Airport", "Yau Tong MTR Exit A2")


• limit (optional): Number of results (1-10, default 5)

Example:

search_location({
  query: "Hong Kong International Airport",
  limit: 3
})

Returns:

• display_name: Full address


• lat, lon: Coordinates for use in plan_trip


• type, class: Location category

plan_trip

Plan a transit route between two points.

Parameters:

• origin (required): Starting point as "lat,lon" or "stop:ID"


• destination (required): Ending point as "lat,lon" or "stop:ID"


• depart_at (optional): ISO 8601 departure time (e.g., "2026-01-26T10:00:00+08:00")


• arrive_by (optional): ISO 8601 arrival deadline


• modes (optional): Comma-separated modes like "mtr,bus,ferry" (only specify if needed)


• max_results (optional): Limit number of route options (1-5)

Example:

plan_trip({
  origin: "22.2836,114.2358",
  destination: "22.3080,113.9185",
  depart_at: "2026-01-26T14:30:00+08:00",
  max_results: 3
})

Returns:

• plans: Array of route options

- duration_seconds: Total trip time
- fares_min, fares_max: Fare range in HKD (Hong Kong only)
- legs: Step-by-step directions
- type: "walk", "transit", "wait", "station_transfer"
- Transit legs include: route name, headsign, stops, platform info
- Walk legs include: distance, duration

Best practices

Always search first: Use search_location to find coordinates before calling plan_trip

Use coordinates: Plan trips with lat,lon format for best results

Specify times: Include depart_at or arrive_by for accurate schedules

Check multiple options: Request 2-3 route options with max_results

Understand fares: fares_min and fares_max show the range—interchange discounts are noted separately when available

Important notes

• Interchange discounts (轉乘優惠): Only shown when explicitly present in Hong Kong routes, not all routes qualify
• Real-time data: Hong Kong routes use live schedules; worldwide coverage may vary
• Time zones: Use UTC or local timezone offsets (HKT is UTC+8)
• Coverage: Best for Hong Kong; worldwide coverage varies by city

Example workflow

// 1. Search for locations
const origins = await search_location({ 
  query: "Yau Tong MTR Station", 
  limit: 1 
});

const destinations = await search_location({ 
  query: "Hong Kong Airport", 
  limit: 1 
});

// 2. Plan the trip
const routes = await plan_trip({
  origin: `${origins[0].lat},${origins[0].lon}`,
  destination: `${destinations[0].lat},${destinations[0].lon}`,
  depart_at: "2026-01-26T15:00:00+08:00",
  max_results: 2
});

// 3. Present the best options to the user or present specific results but only if user asked specifically. By default just give them something like "[walk] > [3D] > [walk] > [Kwun Tong Line] > [walk]"- unless they ask for specifics.

Error handling

• "Could not find location": Try a more specific search query
• "No routes found": Check if coordinates are valid and in a covered area
• "Invalid time format": Ensure ISO 8601 format with timezone
• Rate limits: Be mindful of API usage, cache results when appropriate

Coverage areas

• ✅ Full coverage: Hong Kong (MTR, bus, tram, ferry, detailed fares)
• ✅ Good coverage: Major global cities with Transitous data
• ⚠️ Limited coverage: Smaller cities may have incomplete transit data