korea-transit-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| DATA_GO_KR_SERVICE_KEY | Yes | Your data.go.kr (공공데이터포털) API Decoding service key, issued after applying for the TAGO bus APIs. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_citiesA | 국토교통부(TAGO) 버스 API가 지원하는 도시와 도시 코드(cityCode)를 조회합니다. 다른 버스 도구를 호출하기 전에 cityCode를 알아내는 데 사용하세요. query를 주면 도시명에 해당 문자열이 포함된 것만 돌려줍니다. 서울특별시는 TAGO에서 지원하지 않습니다. |
| search_bus_stopsA | 도시 코드와 정류소명(또는 정류소 번호)으로 버스 정류소를 검색합니다. 결과는 이름이 검색어와 정확히 일치 → 앞부분 일치 → 포함 순으로 정렬됩니다. 같은 이름의 정류소가 여러 개면 도로 반대편 등 방향이 다른 정류소입니다(get_routes_at_stop으로 방향 확인). 하나의 도시 코드에 인접 시·군이 함께 묶여 있을 수 있습니다. 결과의 nodeId는 도착 정보 조회 등 다른 도구에서 사용됩니다. |
| find_nearby_stopsA | 위도·경도 주변의 버스 정류소를 가까운 순으로 찾습니다(distanceM: 미터). 도시 코드가 필요 없고, 결과에 cityCode가 포함됩니다. 같은 정류소가 인접 도시 시스템에 중복 등록되어 cityCode만 다르게 두 번 나올 수 있습니다. |
| get_routes_at_stopA | 정류소를 지나는 버스 노선 목록입니다. 각 노선에 이 정류소의 다음 정류소(nextStop)와 향하는 종점(towards)을 붙여 줍니다. 같은 이름의 정류소가 여러 개일 때 어느 쪽 방면인지 구분하는 데 사용하세요. 노선이 20개를 넘으면 방향 정보는 생략됩니다. |
| get_bus_arrivalsA | 정류소에 도착 예정인 버스를 도착이 빠른 순으로 조회합니다. nodeId는 search_bus_stops 결과에서 얻습니다. routeId를 주면 해당 노선만 조회합니다. arrivalMin은 남은 시간(분, 반올림), stopsAway는 몇 정류장 전인지입니다. arrivingSoon이 true이면 1분 이내이므로 분 대신 '곧 도착'으로 안내하세요. 결과가 비어 있으면 현재 운행 중인 도착 예정 버스가 없는 것입니다. |
| search_routesA | 노선 번호로 버스 노선을 검색합니다. 기점·종점과 첫차·막차 시각(HH:MM)을 함께 돌려줍니다. 결과의 routeId는 다른 노선 도구에서 사용됩니다. 같은 번호라도 지역·유형별로 여러 노선이 나올 수 있습니다. |
| get_route_infoA | 노선의 기점·종점, 첫차·막차 시각, 배차간격(분: 평일/토요일/일요일·공휴일)을 조회합니다. |
| get_route_stopsB | 노선이 지나는 정류소를 순서대로 조회합니다. direction이 0이면 기점→종점, 1이면 종점→기점 방향 구간입니다. 정류소가 수십~수백 개일 수 있으니 필요할 때만 호출하세요. |
| get_bus_locationsA | 노선에서 현재 운행 중인 버스들의 위치(차량번호, 현재 정류소, 노선 내 순번)를 조회합니다. towards는 그 버스가 향하는 종점 방향입니다. 결과가 비어 있으면 운행 중인 버스가 없는 것입니다. |
| find_direct_routesA | 출발 정류소에서 도착 정류소까지 갈아타지 않고 가는 버스 노선을 찾습니다(이동 정류장 수가 적은 순). 이름이 같은 출발·도착 후보를 모두 넘기면, 어느 쪽 정류소에서 타고 내려야 하는지(fromNodeId/toNodeId)까지 판별합니다. 결과가 비어 있으면 직통 노선이 없는 것이니 find_transfer_routes로 환승 경로를 찾으세요. viaTurnaround가 true면 종점에서 회차해 가는 경로라 안내 시 언급하세요. |
| find_transfer_routesA | 직통 노선이 없을 때, 한 번 갈아타서 가는 경로를 찾습니다(두 구간 이동 정류장 수 합이 적은 순). 출발 정류소를 지나는 노선과 도착 정류소를 지나는 노선의 경유 순서·방향을 대조해서, 실제로 이어지는 경로만 돌려줍니다. 같은 정류소에서 갈아타면 sameStop=true, 근처 정류소로 걸어가 갈아타면 walkM(직선거리, m)을 줍니다. 먼저 find_direct_routes를 쓰고, 결과가 비었을 때 같은 후보 목록으로 호출하세요. 정류장 수 기준이라 실제 소요 시간과는 다를 수 있습니다. |
| analyze_headwayA | 노선에서 운행 중인 버스들의 앞뒤 차 간격을 계산합니다. 각 간격의 정류장 수(gapStops), 균등 배치 대비 비율(ratio, 1이 균등), 추정 시간 간격(estMin, 분)을 돌려줍니다. ratio가 작으면 앞차와 붙어 있는 것(몰림)이고, 크면 간격이 벌어진 것(공백)입니다. 마지막 간격(crossesOrigin)은 노선 끝에서 기점을 지나 첫 차까지의 순환 간격이고, 위치를 모르는 차량은 unlocatedBuses로 따로 돌려줍니다. 판단 기준은 이 도구가 정하지 않으니, 결과의 notes에 적힌 가정과 한계를 함께 안내하세요. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 12 tools
Most tools have sharply distinct roles, and the descriptions explicitly sequence dependent tools (list_cities → search_bus_stops → get_bus_arrivals, and find_direct_routes → find_transfer_routes as a fallback). The only real overlap is search_routes vs get_route_info, which both return origin/destination and first/last times, and search_bus_stops vs find_nearby_stops, though those differ by name vs coordinates.
Every tool follows a consistent snake_case verb_noun pattern (list_cities, get_bus_locations, find_direct_routes, search_bus_stops, analyze_headway). Verb choice is also semantically meaningful: list/search for discovery, get for direct lookup, find for route computation.
12 tools is well within the ideal 3-15 range, and each one earns its place by covering a distinct step in a bus-trip workflow (city → stop → route → arrival → routing → headway). No obvious filler or near-duplicate tools.
The bus domain is covered end to end: discovery by name and by coordinates, route lookup, stop sequences, real-time arrivals and vehicle positions, single-transfer routing, and headway analysis. Minor gaps remain, such as no fare/service-alert information and no subway or intercity coverage despite the 'korea-transit' server name (Seoul is also explicitly unsupported).