Skip to main content
Glama

tdx-taiwan-mcp

npm CI license

繁體中文說明

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_get for any TDX endpoint the tools do not cover yet

  • Runs 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-mcp

Claude 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

TDX_CLIENT_ID

required

TDX API key Client Id

TDX_CLIENT_SECRET

required

TDX API key Client Secret

TDX_REQUESTS_PER_SECOND

5

Client-side rate limit; match it to your TDX plan (0 turns it off)

TDX_MAX_ITEMS

200

Most items any tool returns

TDX_CACHE_DIR

see below

Where static data is kept between runs; off turns it off

TDX_TOOLS

all

Tool groups to load, e.g. bus,rail or -road,-raw (see below)

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

youbike_nearby

Nearest YouBike / Moovo stations to a coordinate with bikes (or empty docks) right now

youbike_station

YouBike stations by name or address, with live bikes, e-bikes and empty docks

cycling_routes

Cycle paths near a coordinate or by name, road or district, with length and end points

bus_stops_nearby

Bus stops near a coordinate, with their heading and the city and coach routes there

bus_stop_arrivals

Every bus due at one stop, all routes at once, soonest first

bus_route_search

Bus routes by name or terminal stop, with endpoints, operators and fare

bus_route_stops

The stops of a route in order, per direction and sub-route

bus_eta

Live arrival estimates at the stops of a route, and whether the coming bus has a ramp

bus_timetable

Scheduled departures of a route on a day, or how often it runs

bus_first_last

When the first and last bus of a route leave on a day

bus_fare

A route's fares per passenger and ticket: between two stops, or per section

bus_alerts

Current and upcoming detours, suspensions and moved stops, with the latest news

bus_positions

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

thsr_timetable

High speed rail (高鐵) trains between two stations on a day

thsr_seats

Standard and business seat availability for those trains

thsr_fare

THSR fares per car and passenger type

thsr_train

Every stop of one THSR train, with its non-reserved (自由座) cars

tra_timetable

Taiwan Railway (臺鐵) trains between two stations, with train type

tra_live_board

Trains about to arrive at or leave a TRA station, with delays

tra_train

One TRA train today: stops, current position and delay

tra_fare

TRA fares per train type and passenger type

metro_live_board

Minutes to the next metro trains (Kaohsiung, Taoyuan; Taipei arrivals only)

metro_fare

Metro fares between two stations

metro_first_last_train

First and last trains at a metro station

metro_travel_time

Metro journey time between two stations, with line changes and expected waits

metro_frequency

Minutes between metro trains through the day, per line (incl. 文湖線)

rail_station_departures

A TRA, THSR or metro station's departures on a day, toward every destination

rail_station_info

Station exits (nearest to your destination first), lifts and toilets

afr_timetable

Alishan Forest Railway (阿里山林業鐵路) regular timetable

afr_fare

Alishan Forest Railway fares per train type

rail_station_search

Stations of any rail system by name, or nearest to a coordinate

rail_alerts

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

flight_status

Times, delay, gate and status of a flight (CI100)

flight_board

A Taiwan airport's departure or arrival board, with the current weather

flight_schedule

Flights between two airports on a day: domestic (華信, 立榮, 德安) with fares, or international

flight_seats

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

ferry_timetable

Sailings between two ports on a day, with live status and alerts (typhoons) today

ferry_live_board

A port's departures and arrivals today, with delays and cancellations

ferry_fare

Fares between two ports per ticket, cabin and passenger type

ferry_alerts

Current suspensions and changes to ferry service

ferry_positions

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

traffic_live

Live speed and congestion per road section, worst first, with a count per level

traffic_travel_time

Car travel time between two freeway interchanges now, from live eTag data, per segment

traffic_events

Accidents, roadworks, closures and announced events (parades), with the latest road news

traffic_cameras

Live traffic cameras by road, place or distance, with their stream links

traffic_signs

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

parking_nearby

Nearest car parks and on-street parking with free car or scooter spaces now

parking_search

Car parks and on-street parking by name, address or road, with free spaces

ev_charger_nearby

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

tdx_get

Any TDX API path with OData filter, select, orderBy, top, skip

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

MIT

Available Tools

50 tools
afr_fareAlishan Forest Railway faresA
Read-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 timetableA
Read-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 alertsA
Read-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 timesA
Read-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 faresA
Read-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 busA
Read-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 positionsA
Read-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_stopsStops of a bus routeB
Read-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 stopA
Read-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 nearbyA
Read-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 timetableA
Read-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 pathsA
Read-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 chargersA
Read-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 alertsA
Read-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 faresA
Read-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 boardA
Read-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 positionsA
Read-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 timetableA
Read-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 arrivalsA
Read-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 scheduleA
Read-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 seatsA
Read-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 statusA
Read-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 faresA
Read-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 trainsA
Read-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 frequencyA
Read-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 trainsA
Read-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 timeA
Read-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 parkingA
Read-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.

rail_alertsRail service alertsA
Read-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 departuresA
Read-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 facilitiesA
Read-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.

tdx_getQuery any TDX endpointA
Read-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 faresA
Read-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 availabilityA
Read-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 timetableA
Read-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 stopsA
Read-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 faresA
Read-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 camerasA
Read-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 closuresA
Read-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 trafficA
Read-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 signsA
Read-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 timeA
Read-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 boardA
Read-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 timetableA
Read-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 todayA
Read-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 stationsA
Read-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 nameA
Read-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

    A3.7/5.0

    Scored across 50 tools

    Disambiguation4/5

    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.

    Naming Consistency4/5

    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.

    Tool Count3/5

    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.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers