tdx-taiwan-mcp
One-line summary: An unofficial MCP server for Taiwan's TDX transport API that answers real-time travel questions about bikes, buses, rail, flights, ferries, roads, parking, and EV charging, with readable output.
YouBike / cycling — find nearest stations with bikes or empty docks, look up stations by name/address, and list cycle paths by city, keyword, or coordinate.
Buses — finds stops and routes by name or terminal, lists route stops, gives live arrival estimates (with low-floor/ramp info), timetables, first/last bus, fares, service alerts, and live vehicle positions.
Rail — THSR timetables, seat availability, fares, and per-train stops; TRA timetables, live station boards, train tracking, and fares; metro live boards, fares, first/last trains, journey times with transfers, and line frequencies; Alishan Forest Railway timetable and fares; plus station search, station exits/facilities, station departures, and rail service alerts.
Flights — live flight status, airport departure/arrival boards with weather, domestic and international schedules with fares, and domestic seat availability.
Ferries — timetables with live status, port live boards, fares, service alerts, and live AIS vessel positions.
Roads — live congestion/speeds, live freeway travel times between interchanges, incidents/roadworks/closures, traffic cameras, and changeable message signs.
Parking & EV charging — nearest or keyword-searched car parks and on-street parking with free spaces, and nearest EV chargers filtered by connector type, AC/DC, power, and availability.
Raw access —
tdx_getqueries any TDX API path with ODatafilter,select,orderBy,top,skip.Practical behaviors — accepts city/station/port/airport names in Chinese or English (or TDX/IATA/port IDs), caps result sizes, caches static data for a day and live data for 15 s, and lets you load only chosen tool groups via
TDX_TOOLS.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@tdx-taiwan-mcp Find the nearest YouBike station to Taipei 101 with bikes available"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
tdx-taiwan-mcp
An unofficial MCP server for Taiwan's
TDX (Transport Data eXchange) API, built on the
tdx-taiwan SDK. It lets Claude and other MCP
clients answer questions such as "where is the nearest YouBike with bikes?", "when does the
307 reach Ximen?", "which high speed trains to Zuoying still have seats tonight?", "is CI100
delayed?" or "where can I charge a CCS2 car near Taipei Main Station?".
Task-shaped tools: search by name (Chinese or English, 台/臺 folded) or by location, with readable output ("4 min", "last bus has passed") instead of raw status codes
City names as TDX codes or in Chinese (
Taipei,臺北市,台北)Results capped in size; static lists kept on disk for a day, live data cached for 15 s
tdx_getfor any TDX endpoint the tools do not cover yetRuns over stdio; Node.js 20+
Get TDX keys
Register at tdx.transportdata.tw, then copy the Client Id and Client Secret from 會員中心 → 資料服務 → API金鑰.
Related MCP server: mcp-swisstransport
Set up
Claude Code
claude mcp add tdx \
-e TDX_CLIENT_ID=your-client-id -e TDX_CLIENT_SECRET=your-client-secret \
-- npx -y tdx-taiwan-mcpClaude Desktop
Download tdx-taiwan-mcp-<version>.mcpb from the
latest release and open it
(or drag it into Settings → Extensions). Claude Desktop asks for your TDX Client Id and Secret,
stores the secret in the system keychain, and runs the server with its own Node.js. The
settings also take the tool groups to load (see TDX_TOOLS below).
Other clients
Add the server to the client's MCP configuration (or Claude Desktop's
claude_desktop_config.json, instead of the extension):
{
"mcpServers": {
"tdx": {
"command": "npx",
"args": ["-y", "tdx-taiwan-mcp"],
"env": {
"TDX_CLIENT_ID": "your-client-id",
"TDX_CLIENT_SECRET": "your-client-secret"
}
}
}
}Environment
Variable | Default | Meaning |
| required | TDX API key Client Id |
| required | TDX API key Client Secret |
|
| Client-side rate limit; match it to your TDX plan ( |
|
| Most items any tool returns |
| see below | Where static data is kept between runs; |
|
| Tool groups to load, e.g. |
A .env file in the working directory is read too; variables already set take precedence.
Disk cache. Station, route and timetable lists are kept on disk for a day, so a new
session answers from them instead of calling TDX again. A first metro journey that took close
to two minutes on the free plan's per-minute quota then takes a fraction of a second. The
default folder is ~/.cache/tdx-taiwan-mcp ($XDG_CACHE_HOME if set; %LOCALAPPDATA% on
Windows), a few MB at most. Live data (arrivals, availability, positions) is never stored.
Loading fewer tools. Every tool's description goes into the model's context, and with 47 of
them a model can pick the wrong one. If you only need some areas, list them in TDX_TOOLS:
bike, bus, rail (THSR, TRA, metro, Alishan), flight, ferry, road, parking, ev
and raw (tdx_get). A list loads only those groups (bus,rail); names with a minus leave
groups out of all of them (-road,-raw). The server's instructions to the model cover only the
loaded groups.
Tools
YouBike, cycling and buses
Tool | What it answers |
| Nearest YouBike / Moovo stations to a coordinate with bikes (or empty docks) right now |
| YouBike stations by name or address, with live bikes, e-bikes and empty docks |
| Cycle paths near a coordinate or by name, road or district, with length and end points |
| Bus stops near a coordinate, with their heading and the city and coach routes there |
| Every bus due at one stop, all routes at once, soonest first |
| Bus routes by name or terminal stop, with endpoints, operators and fare |
| The stops of a route in order, per direction and sub-route |
| Live arrival estimates at the stops of a route, and whether the coming bus has a ramp |
| Scheduled departures of a route on a day, or how often it runs |
| When the first and last bus of a route leave on a day |
| A route's fares per passenger and ticket: between two stops, or per section |
| Current and upcoming detours, suspensions and moved stops, with the latest news |
| Where the buses on a route are now: speed, last stop, low-floor and ramp |
Bus tools take a city (Taipei, NewTaipei, ...) or InterCity for 公路客運 / 國道客運
coaches. Whether a bus is low-floor with a wheelchair ramp comes from the fleet lists that
Taipei, New Taipei, Taoyuan, Taichung, Tainan and Kaohsiung publish; Taipei and New Taipei do
not say which bus an arrival estimate is for, so bus_eta estimates it from where each bus
last stopped.
Rail
Tool | What it answers |
| High speed rail (高鐵) trains between two stations on a day |
| Standard and business seat availability for those trains |
| THSR fares per car and passenger type |
| Every stop of one THSR train, with its non-reserved (自由座) cars |
| Taiwan Railway (臺鐵) trains between two stations, with train type |
| Trains about to arrive at or leave a TRA station, with delays |
| One TRA train today: stops, current position and delay |
| TRA fares per train type and passenger type |
| Minutes to the next metro trains (Kaohsiung, Taoyuan; Taipei arrivals only) |
| Metro fares between two stations |
| First and last trains at a metro station |
| Metro journey time between two stations, with line changes and expected waits |
| Minutes between metro trains through the day, per line (incl. 文湖線) |
| A TRA, THSR or metro station's departures on a day, toward every destination |
| Station exits (nearest to your destination first), lifts and toilets |
| Alishan Forest Railway (阿里山林業鐵路) regular timetable |
| Alishan Forest Railway fares per train type |
| Stations of any rail system by name, or nearest to a coordinate |
| Service status and disruptions of THSR, TRA or a metro |
Rail tools take station names in Chinese or English (台北, Taipei, 台北車站) or station
IDs. For today, timetables start from the current time in Taiwan.
Flights
Tool | What it answers |
| Times, delay, gate and status of a flight ( |
| A Taiwan airport's departure or arrival board, with the current weather |
| Flights between two airports on a day: domestic (華信, 立榮, 德安) with fares, or international |
| Seats left on a domestic flight (available, fewer than 5, sold out); slow, asks the airline |
Airports are IATA codes or names (TSA, 松山, Kinmen).
Ferries
Tool | What it answers |
| Sailings between two ports on a day, with live status and alerts (typhoons) today |
| A port's departures and arrivals today, with delays and cancellations |
| Fares between two ports per ticket, cabin and passenger type |
| Current suspensions and changes to ferry service |
| Where ferries are now (AIS): position, speed, status and nearest port |
Ports are names (富岡, 綠島, 小琉球) or port IDs. Lines run by a county (Penghu
inter-island boats, 旗津, 淡水) need city, e.g. PenghuCounty.
Roads
Tool | What it answers |
| Live speed and congestion per road section, worst first, with a count per level |
| Car travel time between two freeway interchanges now, from live eTag data, per segment |
| Accidents, roadworks, closures and announced events (parades), with the latest road news |
| Live traffic cameras by road, place or distance, with their stream links |
| What the message signs over the road show now: travel times, warnings |
Road tools take a network: freeway (國道), highway (省道) or a city; traffic_travel_time
takes freeway interchange names in Chinese (林口, 新竹). Freeway sections are
named after interchanges, so search them by keyword (林口).
Parking and EV charging
Tool | What it answers |
| Nearest car parks and on-street parking with free car or scooter spaces now |
| Car parks and on-street parking by name, address or road, with free spaces |
| Nearest EV chargers with a free connector (CCS2, Tesla, ...), AC or DC, prices |
Coverage differs per city: NewTaipei has on-street parking only, and not every car park
publishes live spaces (those show "no live data"). ev_charger_nearby takes freeway for the
freeway service areas.
Other
Tool | What it answers |
| Any TDX API path with OData |
MCP registry
The server is listed in the MCP registry as
io.github.amangeldievkuu/tdx-taiwan-mcp, so clients that browse the registry can install it
with the two TDX variables above.
Use as a library
import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
import { TdxClient } from 'tdx-taiwan';
import { createServer } from 'tdx-taiwan-mcp';
const tdx = new TdxClient({ clientId: '…', clientSecret: '…', cache: true });
await createServer({ tdx }).connect(new StdioServerTransport());Rate limits and billing
TDX limits requests per second by plan and bills by call count and response size. The server
caches static lists (stations, routes) for an hour and live data for 15 seconds, and spaces
requests at TDX_REQUESTS_PER_SECOND. When TDX still answers 429 (the basic plan also limits
calls per minute), the server waits as TDX asks and retries, so a tool call can take up to a
minute during a burst of questions.
繁體中文
tdx-taiwan-mcp 是交通部 TDX 運輸資料流通服務的非官方 MCP 伺服器(與交通部無隸屬或合作關係),讓 Claude 等 MCP 用戶端以即時資料回答「最近哪個 YouBike 站有車?」「307 公車幾分鐘到西門?」「今晚往左營的高鐵還有座位嗎?」「CI100 有沒有誤點?」等問題,涵蓋 YouBike 與自行車道、市區公車與公路客運(含票價與首末班車)、高鐵、臺鐵、捷運、阿里山林業鐵路、國內外航班、船運、即時路況與路況影像、停車場及充電樁。
取得金鑰:註冊 TDX 會員後,至「會員中心 → 資料服務 → API金鑰」取得 Client Id 與 Client Secret。
安裝
Claude Desktop:從最新版本下載
tdx-taiwan-mcp-<版本>.mcpb並開啟,依提示填入 Client Id 與 Client Secret(密鑰存於系統鑰匙圈)。Claude Code:
claude mcp add tdx \ -e TDX_CLIENT_ID=你的-client-id -e TDX_CLIENT_SECRET=你的-client-secret \ -- npx -y tdx-taiwan-mcp其他用戶端:以
npx -y tdx-taiwan-mcp啟動,並設定上述兩個環境變數(需要 Node.js 20 以上版本)。
設定(環境變數)
TDX_TOOLS:只載入部分工具群組,例如bus,rail;加上減號可排除,例如-road,-raw。群組有bike、bus、rail(高鐵、臺鐵、捷運、阿里山)、flight、ferry、road、parking、ev與raw(tdx_get)。工具愈少,模型愈容易選對工具。TDX_CACHE_DIR:站點、路線、時刻表等靜態資料會在磁碟保存一天(預設~/.cache/tdx-taiwan-mcp),新的工作階段不必再向 TDX 下載;設為off可關閉。即時資料不會存檔。TDX_REQUESTS_PER_SECOND:用戶端限流,預設每秒 5 次,請依您的 TDX 方案調整。TDX_MAX_ITEMS:每個工具最多回傳的筆數,預設 200。
使用提示:站名、港口與機場可用中文或英文(台北、Taipei、松山、TSA);城市可用 TDX 代碼或中文(Taipei、臺北市);時間皆為臺灣時間(UTC+8)。公車工具需要完整路線名稱,可先用 bus_route_search 查詢;bus_eta 與 bus_positions 會標示公車是否為低地板、有無輪椅斜坡(依各縣市公布的車輛資料)。
Data source
資料來源:交通部 TDX 運輸資料流通服務平臺 (MOTC Transport Data eXchange). TDX data is subject to the TDX 資料授權利用條款. This project is not affiliated with MOTC or TDX.
License
Available Tools
50 toolsafr_fareAlishan Forest Railway faresARead-only
Alishan Forest Railway (阿里山林業鐵路) single-journey fares in NT$ between two stations, per train type and passenger type, with the distance. Example: from "嘉義", to "奮起湖".
Inputs: to (required), from (required).
afr_timetableAlishan Forest Railway timetableARead-only
The regular timetable of the Alishan Forest Railway (阿里山林業鐵路): every train, or the trains from one station to another with their times. Services change with the season and weather; the result says when to check the official site. Example: from "嘉義", to "奮起湖".
Inputs: to, from.
bus_alertsBus service alertsARead-only
Current and upcoming bus detours, suspensions, moved stops and extra services in a city or on the InterCity coaches, with the routes and stops they affect, plus the latest operator news. Example: city "Taipei"; or city "Taipei", route "307".
Inputs: city (required), limit, route, keyword.
bus_etaBus arrival timesARead-only
Live estimated arrival of the next buses at the stops of a route ("4 min", "arriving now", "last bus has passed"), with the minutes to the buses after it and, in cities that publish their fleet, whether the coming bus is low-floor with a wheelchair ramp. Give stop to see one stop only. Example: city "Taipei", routeName "307", stop "西門".
Inputs: city (required), routeName (required), stop, limit, +1 more.
bus_fareBus faresARead-only
What a bus route costs, per passenger type and ticket (cash single ticket, smart card such as EasyCard): the fare between two stops for coaches and routes priced by distance, or the fare per section for city routes. Example: city "InterCity", routeName "1610", from "臺北", to "高雄"; or city "Taipei", routeName "307".
Inputs: city (required), routeName (required), to, from, +2 more.
bus_first_lastFirst and last busARead-only
When the first and the last bus of a route leave on a day, per direction and sub-route. Taipei, New Taipei and Tainan publish no first/last list, so there it is worked out from the timetable. Example: city "Taichung", routeName "300"; or city "InterCity", routeName "1610".
Inputs: city (required), routeName (required), date, direction.
bus_positionsLive bus positionsARead-only
Where the buses on a route are right now: position, speed, direction and status of each vehicle, whether it is low-floor with a ramp (where the city publishes its fleet), and the stop each one last arrived at or left. Example: city "Taipei", routeName "307".
Inputs: city (required), routeName (required), direction.
bus_route_searchSearch bus routesARead-only
Bus routes whose name, or first or last stop, contains a keyword, with their endpoints, operators and fare. Use it to find the exact route name the other bus tools need. Example: city "Taipei", keyword "307"; or city "InterCity", keyword "1610".
Inputs: city (required), keyword (required), limit.
bus_route_stopsStops of a bus routeBRead-only
The stops of a bus route in order, for each direction and sub-route. Example: city "Taipei", routeName "307", direction "outbound".
Inputs: city (required), routeName (required), direction.
bus_stop_arrivalsBuses arriving at a stopARead-only
Every bus due at one stop, all routes at once, soonest first: minutes to arrival, where each bus is heading, and the buses after it. Give the stationUID from bus_stops_nearby, or the stop name. Example: city "Taipei", stationUID "TPE1895"; or city "Taipei", stop "臺北車站(鄭州)".
Inputs: city (required), stop, limit, stationUID.
bus_stops_nearbyBus stops nearbyARead-only
Bus stops nearest to a coordinate, each with its heading and the city bus and InterCity coach routes that stop there, nearest first. Pass a stop and route to bus_eta for live arrivals. Example: lat 25.0478, lon 121.517, city "Taipei".
Inputs: lat (required), lon (required), city (required), limit, +1 more.
bus_timetableBus timetableARead-only
Scheduled departures of a bus route on a day, from its first stop or a given stop, or how often it runs for routes run by frequency. Use it for planning ahead and for coaches and rural routes; use bus_eta for live arrivals. Kaohsiung publishes no timetables. Example: city "InterCity", routeName "1610", stop "臺北轉運站".
Inputs: city (required), routeName (required), date, stop, +3 more.
cycling_routesCycle pathsARead-only
Cycle paths (自行車道) of a city: name, district, the roads where each starts and ends, length and its end points; near a coordinate (nearest first) or by a keyword in the name, road or district. Example: city "Taipei", keyword "河濱"; or lat 25.0478, lon 121.517, city "Taipei".
Inputs: city (required), lat, lon, limit, +2 more.
ev_charger_nearbyNearest EV chargersARead-only
EV charging stations nearest to a coordinate, with their connectors (type, AC/DC, power) and how many are free, in use or out of order right now, plus opening hours and prices. Use city "freeway" for the freeway service areas. Example: lat 25.0478, lon 121.517, city "Taipei", connector "CCS2".
Inputs: lat (required), lon (required), city (required), want, +4 more.
ferry_alertsFerry service alertsARead-only
Current ferry service alerts: suspensions for typhoons or rough seas, cancelled or changed sailings, with the routes and ports they affect. Example: keyword "綠島"; or no input for every alert.
Inputs: city, keyword.
ferry_fareFerry faresARead-only
Ferry fares in NT$ between two ports, per route, ticket, cabin and passenger type. Example: from "基隆", to "南竿".
Inputs: to (required), from (required), city.
ferry_live_boardFerry port live boardARead-only
A ferry port's live departures and arrivals for today: scheduled, estimated and actual times, vessel and status (on time, departed, cancelled with the reason). About 25 ports have a board (小琉球, 東港, 綠島, 富岡, 南竿, 金門水頭, ...); use ferry_timetable for the others. Example: port "小琉球".
Inputs: port (required), limit.
ferry_positionsFerry positionsARead-only
Where ferries and other passenger vessels around Taiwan are right now (AIS): position, speed, course, status (under way, moored, ...) and the nearest port. Search by vessel name, near a port, or near a point. Positions are not tied to routes, and names are as the ships broadcast them (often English). Example: port "小琉球"; or keyword "TAIMA".
Inputs: lat, lon, port, limit, +3 more.
ferry_timetableFerry timetableARead-only
Ferry sailings from one port to another on a day, with times and, for today, live status (on time, departed, cancelled) and service alerts such as typhoon suspensions. Example: from "富岡", to "綠島"; or from "馬公", to "七美", city "PenghuCounty".
Inputs: to (required), from (required), city, date, +2 more.
flight_boardAirport departures and arrivalsARead-only
An airport's live departure or arrival board for passenger flights: times, delay, status, terminal and gate, from an hour ago on for today, with the current weather. Covers the Taiwan airports. Example: airport "TSA", direction "departures", otherAirport "金門".
Inputs: airport (required), date, after, limit, +3 more.
flight_scheduleFlight scheduleARead-only
Scheduled flights between two airports on a day. Between Taiwan airports: the domestic flights of Mandarin Airlines, UNI Air and Daily Air with cancellations and fares in NT$. To or from abroad: the published international timetable, code-share numbers grouped under one flight. Use flight_status or flight_board for live status. Example: from "松山", to "金門", date "2026-11-02"; or from "TPE", to "NRT".
Inputs: to (required), from (required), date, after, +1 more.
flight_seatsDomestic flight seatsARead-only
Whether seats are left on a domestic flight of Mandarin Airlines (AE), UNI Air (B7) or Daily Air (DA): available, fewer than 5 left, or sold out, per cabin when the airline says. TDX asks the airline live, so this can take up to 30 s, and UNI Air allows few requests; call it for one flight at a time. Example: flight "AE1273", date "2026-11-02".
Inputs: flight (required), date.
flight_statusFlight statusARead-only
Live status of a flight to or from Taiwan: scheduled, estimated and actual times, delay, terminal, gate and status (on time, delayed, departed, cancelled, ...). TDX lists flights around today. Example: flight "CI100"; or "B7 8751".
Inputs: flight (required), date.
metro_fareMetro faresARead-only
Metro single-journey fares between two stations in NT$, per passenger type, with the distance. Example: system "TRTC", from "台北車站", to "淡水".
Inputs: to (required), from (required), system (required).
metro_first_last_trainMetro first and last trainsARead-only
First and last train times at a metro station for each line and direction. Example: system "TRTC", station "台北車站".
Inputs: system (required), station (required).
metro_frequencyMetro train frequencyARead-only
How often metro trains run on each line through the day (minutes between trains, peak and off-peak) and its operating hours, for a day of the week. Covers the Taipei Wenhu line (文湖線), which has no timetable. Example: system "TRTC", line "BR".
Inputs: system (required), date, line.
metro_live_boardMetro next trainsARead-only
Minutes until the next metro trains at a station, per line and destination. KRTC, TYMC and KLRT list every station; TRTC (Taipei) only lists trains arriving right now, so an empty Taipei board is normal. Example: system "KRTC", station "美麗島".
Inputs: system (required), station.
metro_travel_timeMetro journey timeARead-only
How long a metro journey takes between two stations, with the line changes: each leg with its line, direction (toward) and stops, the walking time at each change, how often trains run now and the expected wait. TRTC covers Taipei and New Taipei (including the Circular line); also Kaohsiung, Taichung and the Taoyuan airport line (express and local). Example: system "TRTC", from "台北車站", to "台北101/世貿".
Inputs: to (required), from (required), system (required), date.
parking_nearbyNearest parkingARead-only
Car parks and on-street parking nearest to a coordinate, with free spaces right now for cars or scooters, fare and opening status, nearest first. Coverage differs per city (NewTaipei has on-street parking only). Example: lat 25.0478, lon 121.517, city "Taipei".
Inputs: lat (required), lon (required), city (required), kind, +4 more.
parking_searchFind parking by name or roadBRead-only
Car parks and on-street parking whose name, address or road contains a keyword, with free spaces right now. Example: city "Taipei", keyword "市府"; or keyword "復興北路".
Inputs: city (required), keyword (required), want, limit, +1 more.
rail_alertsRail service alertsARead-only
Current service status and disruption alerts of THSR, TRA or a metro system ("normal" when everything runs). Example: system "TRA".
Inputs: system (required).
rail_station_departuresStation departuresARead-only
A station's departures on a day toward every destination, from its timetable: TRA, THSR or a metro (including Taipei Metro, whose live board shows arrivals only). Use tra_timetable or thsr_timetable for trains between two stations. Example: system "TRA", station "板橋"; or system "TRTC", station "台北車站", toward "淡水".
Inputs: system (required), station (required), date, after, +2 more.
rail_station_infoStation exits and facilitiesARead-only
Exits of a TRA, THSR or metro station with where they come out and whether they have stairs, an escalator or a lift, plus where its lifts, toilets and information desks are. Give the coordinates of where you are going to sort the exits by distance. Example: system "TRTC", station "台北101/世貿", lat 25.0336, lon 121.5648.
Inputs: system (required), station (required), lat, lon, +1 more.
rail_station_searchFind rail stationsARead-only
Stations of a rail system by name (Chinese or English) or nearest to a coordinate, with their IDs. The other rail tools accept names directly, so use this to explore, to find the nearest station, or when a name is ambiguous. Example: system "TRTC", lat 25.0478, lon 121.517; or system "TRA", keyword "新竹".
Inputs: system (required), lat, lon, limit, +1 more.
tdx_getQuery any TDX endpointARead-only
GET any TDX API path (https://tdx.transportdata.tw/api-service/swagger) with OData options. Use it only when no specific tool covers the data. Field names in filter, select and orderBy are TDX field names (e.g. StationName/Zh_tw). Results are not cached and null or empty fields are dropped. Example: path "/v2/Rail/THSR/Station", select ["StationID","StationName"], top 5.
Inputs: path (required), top, skip, filter, +2 more.
thsr_fareHigh speed rail faresARead-only
THSR single-journey fares between two stations in NT$, per car (standard, business, non-reserved) and passenger type (adult, child, senior, ...). Example: from "台北", to "台南".
Inputs: to (required), from (required).
thsr_seatsHigh speed rail seat availabilityARead-only
Reserved-seat availability (available, limited, sold out) in standard and business class for THSR trains between two stations, with their times. Updated about every 10 minutes. Example: from "台北", to "台中".
Inputs: to (required), from (required), date, after, +1 more.
thsr_timetableHigh speed rail timetableARead-only
THSR (高鐵) trains from one station to another on a day, with departure, arrival and travel time, from now on for today. TDX covers about four weeks ahead. Example: from "台北", to "左營", date "2026-10-23", after "08:00".
Inputs: to (required), from (required), date, after, +1 more.
thsr_trainHigh speed rail train stopsARead-only
Every stop of one THSR train on a day, with arrival and departure times. Example: trainNo "0803" (or "803").
Inputs: trainNo (required), date.
tra_fareTaiwan Railway faresARead-only
TRA single-journey fares between two stations in NT$ per train type (自強, 莒光, 區間, ...) and passenger type, with the distance. Example: from "臺北", to "高雄".
Inputs: to (required), from (required).
traffic_camerasTraffic camerasARead-only
Live traffic cameras on the national freeways, provincial highways or a city’s roads, by road, place or distance, with the link to each live stream (open it to watch; TDX gives no still images). Example: network "freeway", keyword "林口"; or network "Taipei", lat 25.0478, lon 121.517.
Inputs: network (required), lat, lon, limit, +3 more.
traffic_eventsRoad incidents and closuresARead-only
Current road events: accidents, roadworks, congestion, traffic control and weather closures, plus announced events (parades, planned works) for cities and provincial highways, with where they are and how much they block. Example: network "freeway", type "accident"; or network "Taipei", lat 25.0478, lon 121.517.
Inputs: network (required), lat, lon, type, +3 more.
traffic_liveLive road trafficARead-only
Live speed and congestion of road sections on the national freeways, provincial highways or a city’s roads, most congested first, with a count of sections per congestion level. Freeway sections are named after interchanges, so search them by keyword; city sections can also be searched by lat/lon. Example: network "freeway", keyword "林口"; or network "Taipei", lat 25.0478, lon 121.517.
Inputs: network (required), lat, lon, limit, +3 more.
traffic_signsRoad message signsARead-only
What the changeable message signs over the national freeways, provincial highways or a city’s roads show right now: travel times to the next interchanges, congestion, incidents and roadworks warnings. Example: network "freeway", keyword "汐止", direction "S".
Inputs: network (required), lat, lon, limit, +3 more.
traffic_travel_timeFreeway travel timeARead-only
How long a car takes right now between two national freeway (國道) interchanges, from live eTag gantry times: the fastest route, its distance and average speed, and the time and speed of each segment so slow stretches stand out. Example: from "林口", to "新竹".
Inputs: to (required), from (required).
tra_live_boardTaiwan Railway station live boardARead-only
Trains about to arrive at or leave a TRA station now, with delay and platform. Only imminent trains are listed; use tra_timetable for later ones. Example: station "板橋".
Inputs: station (required).
tra_timetableTaiwan Railway timetableARead-only
TRA (臺鐵) trains from one station to another on a day: train type, departure, arrival, travel time, from now on for today. TDX covers about two months ahead. Example: from "臺北", to "花蓮", date "2026-10-23".
Inputs: to (required), from (required), date, after, +1 more.
tra_trainTaiwan Railway train todayARead-only
One TRA train today: its stops with times, and where it is now and how late it runs. Example: trainNo "123".
Inputs: trainNo (required).
youbike_nearbyNearest YouBike stationsARead-only
YouBike / Moovo stations nearest to a coordinate, with live bikes (regular and e-bike) and empty docks, nearest first. Example: lat 25.0478, lon 121.517, city "Taipei".
Inputs: lat (required), lon (required), city (required), want, +2 more.
youbike_stationFind YouBike stations by nameARead-only
YouBike / Moovo stations whose name or address contains a keyword (Chinese or English), with live bikes and empty docks. Example: city "Taipei", keyword "臺北車站".
Inputs: city (required), keyword (required), want, limit.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 50 tools
Tools are mostly distinct by transport mode and action, and descriptions clarify live vs scheduled vs station vs route. Some subtle overlaps remain, such as bus_stop_arrivals vs bus_eta, rail_station_departures vs mode-specific timetables, and flight_status vs flight_board, so an agent could occasionally misselect among the 50.
All names use snake_case and a predictable domain-prefix plus descriptor pattern (bus_*, thsr_*, metro_*, traffic_*). Minor inconsistencies include singular/plural variation (bus_stops_nearby vs bus_stop_arrivals), noun vs action suffixes, and the generic tdx_get outlier.
50 tools is heavy, but the server covers a genuinely broad multi-modal transport domain, so many tools are justified. Still, the count is unwieldy and several mode-specific tools could be consolidated or grouped to reduce selection load.
Coverage is extensive across buses, rail, metro, ferries, flights, traffic, parking, EV charging, and bike share, including live data, timetables, fares, alerts, and station information. The main gap is integrated cross-modal journey planning/trip routing; tdx_get helps fill obscure data gaps but not complex workflows.
Maintenance
Related MCP Connectors
Swiss Transport MCP — wraps Transport Open Data API (free, no auth)
MBTA MCP — Boston real-time transit via the MBTA v3 API (api-v3.mbta.com)
SEPTA MCP — Philadelphia SEPTA real-time transit (www3.septa.org/api, keyless)
NJ Transit rail, bus and PATH schedules via MCP (scheduled, plus live PATH)
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceMCP server that provides tools for querying live transit data (stops, departures, routes, vehicles, alerts) from any WP GTFS Pro site, enabling AI assistants to answer rider questions.8 npmGPL 2.0
- AlicenseNot gradedqualityCmaintenanceEnables querying Swiss public transport data (stations, departures, connections) from the Transport Open Data API via natural language through an MCP gateway.312 npmMIT
- AlicenseNot gradedqualityDmaintenanceEnables querying real-time BART and SF Muni transit data, including departures, trip planning, fares, advisories, routes, alerts, vehicle positions, and schedules, from any MCP-compatible client.1MIT
- AlicenseAqualityBmaintenanceEnables public-transport journey planning, place search, realtime departures and timetables, usable from any MCP client.9MIT