Malaysia Transit MCP

A Model Context Protocol server that taps access to real-time bus and train information across 12 Malaysian cities.

CommunityOnlineNo sign-inGlobalFreeRead-only

What it can do

  • List Service Areas: List all available transit service areas in Malaysia (e.g., Klang Valley, Penang, Kuantan)
  • Detect Location Area: Automatically detect which transit service area a location belongs to using geocoding. Use this when the user mentions a place name without specifying the area (e.g., "KTM Alor S
  • Get Area Info: Get detailed information about a specific transit service area

What data it sees

Do you need an account

No: the server works without sign-in

A Model Context Protocol server that taps access to real-time bus and train information across 12 Malaysian cities. Get live arrivals, vehicle tracking, and route details from Rapid KL, Rapid Penang, and various BAS.MY services across Malaysia.

Currently covering the following areas:

  • Kangar
  • Alor Setar
  • Penang
  • Klang Valley (Kuala Lumpur, Selangor, Putrajaya)
  • Melaka
  • Johor Bahru
  • Kota Bharu
  • Kuala Terengganu
  • Kuching
  • Ipoh
  • Seremban

More areas to be covered soon!

Note: this is NOT an official MCP server by the Government of Malaysia or anyone from Prasarana Malaysia, Ministry of Transport (MOT), Agensi Pengangkutan Awam Darat (APAD), KTM Berhad, or operators involved in BAS.MY operations.

How to connect

How to connect Malaysia Transit MCP to Claude

The server address to paste into Claude settings:

https://mcp-malaysiatransit--hithereiamaliff.run.tools

  1. Open Claude (claude.ai or the desktop app).
  2. Go to Settings → Connectors.
  3. Click Add custom connector.
  4. Paste the server address copied below into Remote MCP server URL and click Add.
  5. In a chat, click + → Connectors and switch the new connector on.

Custom connectors are available on Free, Pro, Max, Team and Enterprise plans (Free is limited to one). On Team and Enterprise an organization Owner adds the connector first under Organization settings → Connectors.

Authorization

After you click Add, a sign-in window for the service opens. Sign in with your own account and approve access. Claude never sees your password.

How to connect Malaysia Transit MCP to ChatGPT

The server address to paste into ChatGPT settings:

https://mcp-malaysiatransit--hithereiamaliff.run.tools

  1. Open ChatGPT in a browser (chatgpt.com). A Plus, Pro, Business, Enterprise or Edu plan is required.
  2. Turn on developer mode once: Settings → Apps → Advanced settings → Developer mode.
  3. Open Settings → Connectors and click Create.
  4. Fill in the form: Name (anything), Description (one line about what the service does), MCP server URL (copy it below).
  5. Under Authentication choose OAuth if the service requires sign-in, otherwise None. Click Create.
  6. In a new chat open + → Apps/Connectors and enable the connector.

OpenAI has renamed this section before (Connectors → Apps/Plugins). If the label differs, search settings for "developer mode". On Business/Enterprise workspaces an admin must allow custom connectors first.

Authorization

On first use ChatGPT opens the service's sign-in window. Sign in and approve access.

How to connect Malaysia Transit MCP to Cursor

The server address to paste into Cursor settings:

https://mcp-malaysiatransit--hithereiamaliff.run.tools

Fastest: click Open in Cursor below and confirm the prompt.

Manually:

  1. In Cursor open Settings → Cursor Settings → MCP and click Add new global MCP server.
  2. Paste the JSON copied below into ~/.cursor/mcp.json (per project: .cursor/mcp.json in the repo root).
  3. Save the file. The server appears in the MCP list; authorize it there if asked.

Authorization

If the service needs sign-in, an authorize button appears next to the server in the MCP list.

Server tool list (43)

Raw names from tools/list. Only developers need these.

list_service_areasList all available transit service areas in Malaysia (e.g., Klang Valley, Penang, Kuantan)
detect_location_areaAutomatically detect which transit service area a location belongs to using geocoding. Use this when the user mentions a place name without specifying the area (e.g., "KTM Alor Setar", "Komtar", "KLCC"). IMPORTANT: After detecting the area, use find_nearby_stops_with_arrivals or find_nearby_stops with the location parameter - these tools handle geocoding automatically and are more reliable than using coordinates from this tool.
get_area_infoGet detailed information about a specific transit service area
search_stopsSearch for bus or train stops by name in a specific area. The middleware will automatically geocode place names (like "Ideal Foresta") and find nearby stops if no exact stop name match is found. IMPORTANT: If you are unsure which area a location belongs to, use detect_location_area first to automatically determine the correct area.
get_stop_detailsGet detailed information about a specific bus or train stop
get_stop_arrivalsGet real-time arrival predictions for buses/trains at a specific stop
find_nearby_stopsFind bus or train stops near a specific location AND get all routes serving those stops. You can provide EITHER coordinates (lat/lon) OR a location name - the middleware will geocode place names automatically.
find_nearby_stops_with_arrivalsFind bus stops near a location AND get real-time arrival predictions in one call. RECOMMENDED: Use this tool when users ask about nearby bus stops and arrival times together. Accepts a place name (e.g., "Ideal Foresta") - the middleware handles geocoding automatically.
find_nearby_stops_with_routesFind bus stops near a location AND get all routes serving those stops in one call. Accepts a place name (e.g., "Ideal Foresta") - the middleware handles geocoding automatically.
list_routesList all available bus or train routes in a specific area
get_route_stopsGet all stops on a specific route. Use this to find which stops a bus/train route serves. IMPORTANT: First call list_routes to get the correct route_id.
get_route_detailsGet detailed information about a specific route including stops and geometry. IMPORTANT: First call list_routes to get the correct route_id.
get_route_geometryGet the geographic path and stops for a specific route (for map visualization)
get_live_vehiclesGet real-time positions of all buses and trains in a specific area
get_provider_statusCheck the operational status of transit providers in a specific area
get_route_departuresGet the next N departures for a specific route (both directions). Useful for showing upcoming bus/train times. IMPORTANT: Use route_short_name (e.g., "K10", "A32", "R10", "101") NOT the numeric route_id. Works for: penang, ipoh, seremban, kangar, alor-setar, kota-bharu, kuala-terengganu, melaka, johor, kuching.
get_next_departureGet the single next departure for a route in a specific direction. Quick way to find when the next bus/train leaves. IMPORTANT: Use route_short_name (e.g., "101", "K10", "A32") NOT numeric route_id. Works for: penang, ipoh, seremban, kangar, alor-setar, kota-bharu, kuala-terengganu, melaka, johor, kuching.
get_stop_routesGet all routes serving a specific stop with their next departures. Shows which buses/trains stop here and when. Works for: penang, ipoh, seremban, kangar, alor-setar, kota-bharu, kuala-terengganu, melaka, johor, kuching.
get_route_scheduleGet the complete daily schedule for a route. Shows all departure times throughout the day. IMPORTANT: Use route_short_name (e.g., "101", "K10", "A32") NOT numeric route_id. Works for: penang, ipoh, seremban, kangar, alor-setar, kota-bharu, kuala-terengganu, melaka, johor, kuching.
get_route_originGet the origin stop name for a route in a specific direction. Useful for showing where the bus/train starts. IMPORTANT: Use route_short_name (e.g., "101", "K10", "A32") NOT numeric route_id. Works for: penang, ipoh, seremban, kangar, alor-setar, kota-bharu, kuala-terengganu, melaka, johor, kuching.
get_route_statusCheck if a route is currently operating based on its schedule. Shows if buses/trains are running now. IMPORTANT: Use route_short_name (e.g., "101", "K10", "A32") NOT numeric route_id. Works for: penang, ipoh, seremban, kangar, alor-setar, kota-bharu, kuala-terengganu, melaka, johor, kuching.
get_fare_routesGet all routes available for fare calculation in a specific area. MUST call this FIRST before calculate_fare to get valid route_id values. Supports: ipoh, seremban, kangar, alor-setar, kota-bharu, kuala-terengganu, melaka, johor, kuching, penang.
get_route_stops_for_fareGet all stops on a route with their distances for fare calculation. MUST call this SECOND (after get_fare_routes) to get valid stop_id values for calculate_fare. Returns stop IDs and names.
calculate_fareCalculate the bus fare between two stops on a route. IMPORTANT: You MUST first call get_fare_routes to get route_id, then get_route_stops_for_fare to get valid stop_id values. Do NOT guess IDs.
calculate_journey_fareCalculate the total fare for a multi-leg journey with bus transfers. Each leg is a separate fare since BAS.MY does not have integrated transfers.
get_route_directions_for_fareGet available directions for a route when calculating fares. Use this to determine which direction (outbound/inbound) to use for fare calculation.
get_ktm_komuter_stationsGet all 23 KTM Komuter Utara stations (Padang Besar - Butterworth - Ipoh line). Returns station codes, names, and coordinates.
calculate_ktm_komuter_fareCalculate KTM Komuter Utara fare between two stations. Use station codes (e.g., "BU" for Butterworth, "IP" for Ipoh, "PB" for Padang Besar).
get_ktm_komuter_fare_matrixGet the full KTM Komuter Utara fare matrix showing fares between all station pairs.
get_ktm_station_departuresGet departure times for a specific KTM station. Supports both KTM Komuter Utara and KTM Intercity schedules.
get_ktm_stationsGet all KTM stations for a specific schedule type (Komuter Utara or Intercity).
get_ktm_schedulesGet full KTM schedule data for a specific schedule type. Returns complete timetable information.
find_nearby_ktm_stationsFind KTM stations near a specific location. You can provide EITHER coordinates (lat/lon) OR a location name - the middleware will geocode place names automatically.
get_penang_ferry_overviewGet Penang Ferry service overview including terminals, operating hours, frequency, and contact information. The ferry operates between Butterworth and George Town.
get_penang_ferry_scheduleGet full Penang Ferry schedule with departure times. Supports filtering by direction and day type.
get_penang_ferry_next_departureGet next ferry departures from both Butterworth and George Town terminals in real-time. Shows minutes until departure.
get_penang_ferry_terminalsGet detailed information about Penang Ferry terminals including facilities, connections, parking, and nearby attractions.
get_penang_ferry_fareGet Penang Ferry fare information, payment methods, and terminal coordinates.
get_system_healthCheck the health status of the Malaysia Transit middleware service
get_debug_infoGet comprehensive debug information about the middleware service including memory usage and initialized areas
get_api_analyticsGet API usage analytics and statistics from the middleware. Shows total requests, requests per hour, error rates, and usage by service area. Useful for monitoring API health and usage patterns.
get_area_analyticsGet detailed API usage analytics for a specific service area. Shows which endpoints are most used for that area.
helloA simple test tool to verify that the MCP server is working correctly