# Korea Flight MCP

> 14 Korean airports flight info + Incheon arrival/departure congestion + facility search.

- name: io.github.kimnchai/korea-flight-mcp
- version: 1.3.0
- connection class: R0 (autonomous)
- trust: 69/100 flags: no-repository
- quality: 88/100 (good)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/io.github.kimnchai%2Fkorea-flight-mcp
- tools: https://api.protogrid.dev/v1/servers/io.github.kimnchai%2Fkorea-flight-mcp/tools

**An agent can connect right now, no human step.** Remote endpoint, no authentication, reachable on the last probe.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "korea-flight-mcp": {
      "type": "http",
      "url": "https://korea-flight.kimnchai.com/mcp"
    }
  }
}
```


## Trust

- hygiene: 80
- liveness: 98
- freshness: 65
- provenance: 35
- drivers: +reachable +uptime-94% ~updated-107d-ago -no-repository
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 88/100 (good)

### protocol: 75 (weight 25)

- warn `protocol.modern`: newest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
- n/a `protocol.stateless`: only applies to 2026-07-28 servers
- pass `protocol.transport`: streamable HTTP
- n/a `protocol.list_ttl`: only applies to 2026-07-28 servers

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 93 (weight 30)

- pass `tools.descriptions`: every tool has a description
- warn `tools.description_length`: 1 tools have descriptions over 1,024 characters, which crowds the context
- pass `tools.schemas`: every tool has an object input schema
- pass `tools.annotations`: 8 of 8 tools declare readOnlyHint or destructiveHint
- pass `tools.directory_hints`: every tool declares readOnlyHint, destructiveHint, idempotentHint and openWorldHint
- pass `tools.token_cost`: about 2,257 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: 100 (weight 15)

- pass `stability.changes`: no tool changes in 30 days
- pass `stability.rug_pull`: no tool changed its meaning under the same name

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 8, about 2,257 tokens to load them all
- tool set hash: ae64df4111755104fc0254acc688bfe3
- badge: [![protogrid quality](https://protogrid.dev/badge/io.github.kimnchai/korea-flight-mcp.svg)](https://protogrid.dev/servers/io.github.kimnchai/korea-flight-mcp)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

_No tool definition changes recorded._

## Remotes

- https://korea-flight.kimnchai.com/mcp (streamable-http, auth none, reachable true, uptime30d 0.9385965)

## Packages

_none_

## Tools (8)

- `airport_overview`: [한국 공항 실시간 운항정보] 공항 오늘 개요 — 운항량, 상위 항공사·노선, 터미널 분포.
    Airport overview — today's volume, top airlines/routes, terminal split (ICN only).
    Useful for first-time visitors.

    Examples:
    - "What's GMP like?" → airport_overview("GMP")
    - "ICN T1 departures" → airport_overview("ICN", "T1")  # T1 → P01 자동 변환

    Args:
        airport: Airport IATA (e.g. GMP, ICN, CJU)
        terminal: (optional) Terminal ID. ICN 만 의미. 다음 입력 모두 허용:
                  - "T1"/"T2"/"터미널1"/"터미널2"/"1"/"2" → 내부적으로 P01/P03 으로 자동 변환
                  - "탑승동"/"concourse" → P02
                  - "P01"/"P02"/"P03" 정식 코드 그대로
                  ICN 외 공항에선 무시됨.
        lang: Response language 'E' (default) / 'K' / 'C' / 'J'. Match user's language.
    
- `codeshare_info`: [한국 공항 실시간 운항정보] 인천공항편의 코드쉐어 정보 — 마스터편명·파트너편 (ICN 전용).
    Codeshare info for ICN flights — master flight number + codeshare partners.
    ICN-only (other airports don't provide codeshare data).

    Examples:
    - "Is OZ117 a codeshare?" → codeshare_info("OZ117")
    - "Master flight of ET1291?" → codeshare_info("ET1291")

    Args:
        flight_id: Flight number (e.g. OZ117, ET1291)
        lang: Response language 'E' (default) / 'K' / 'C' / 'J'. Match user's language.
    
- `get_flight_status`: [한국 공항 실시간 운항정보] 한국 14개 공항의 실시간 출도착 정보를 조회합니다.
    Look up real-time arrival/departure status for 14 Korean airports.

    Rendering: every line already carries the gate ('게이트 267' / 'Gate 267'), the
    terminal, and — for departures — the check-in counter ('체크인 A B C D' /
    'check-in B01-B18'). When you render a table, give the gate AND the check-in
    counter their own columns next to 편명·목적지·시각·상태·터미널 — do not drop them.
    A departing passenger moves check-in → security → gate, so a table without those
    two sends them back to ask again. '-' means not assigned yet; show '-' rather than
    inventing or guessing a gate or counter.

    Args:
        airport: Airport IATA (ICN/GMP/PUS/CJU/TAE/CJJ etc., 14 total)
        direction: 'arrival' or 'departure'
        flight_date: date — omit or 'today' for live; 'yesterday'/'YYYY-MM-DD' for snapshot.
                     Up to 30 days back. ICN historical data only on dates the nightly
                     snapshot ran.
        lang: Response language — 'E' English (default) / 'K' 한국어 / 'C' 中文 / 'J' 日本語.
              MUST be filled to match user's language: 한국어 질문이면 'K', 中文이면 'C',
              日本語면 'J'. Default 'E' is the safest pivot for any other language.
    
- `incheon_arrivals`: [한국 공항 실시간 운항정보] 인천공항 입국 도착 정보 (H-2~H+2 시간 윈도우). 편명·도착시간·게이트·입국장(A-F)·내외국인 수.
    Incheon Airport arrival info (H-2~H+2 window). Per-flight schedule/actual time,
    aircraft gate, entry gate (A-F), domestic/foreign passenger counts.

    Examples:
    - "How busy is Incheon T1 arrivals right now?" → incheon_arrivals(terno="T1")
    - "Any arrivals from Hanoi?" → incheon_arrivals(airport="HAN")
    - "Where is VN416 arriving?" → incheon_arrivals(flight_id="VN416")

    Args:
        terno: Terminal filter — 'T1' / 'T2' / '' (all). Default ''.
        airport: Origin airport IATA filter (e.g., HAN, NRT). Default '' (all).
        flight_id: Specific flight ID filter (e.g., 'VN416'). Default '' (all).
        lang: Response language — 'E' English (default) / 'K' 한국어 / 'C' 中文 / 'J' 日本語.
              MUST match user's language.
    
- `incheon_departure_congestion`: [한국 공항 실시간 운항정보] 인천공항 출국장 혼잡도 (1분 주기 실시간). 출국장 게이트별 대기인원 + 발생일시.
    Incheon Airport departure hall congestion (1-min real-time). Per-gate wait count.
    T1 (P01) currently available; T2 (P02) coming soon per data.go.kr.

    Examples:
    - "How crowded is Incheon T1 departure right now?" → incheon_departure_congestion(terminal="T1")

    Args:
        terminal: 'T1' (or 'P01') — Terminal 1. 'T2'/'P02' pending data.go.kr release.
        lang: Response language — 'E' (default) / 'K' / 'C' / 'J'. Match user's language.
    
- `incheon_facilities`: [한국 공항 실시간 운항정보] 인천공항 입점 상업시설(매장·서비스) 정보 — 약 1,227개. dataset 15095043 (B551177 family).
    Incheon Airport commercial facilities (~1,227 stores/services). Filter by query.

    Examples:
    - "Where is Starbucks at Incheon?" → incheon_facilities(query="Starbucks")
    - "면세점 어디 있어?" → incheon_facilities(query="면세점", lang="K")
    - "Toilets in departure area?" → incheon_facilities(query="Toilet", area="departure")
    - "출국장 음식점" → incheon_facilities(query="식당", area="departure", lang="K")

    Args:
        query: Facility name / item / location filter (case-insensitive partial match). '' = top by area.
        area: 'arrival' (A=입국장) / 'departure' (D=출국장) / '' (all).
        lang: 'E' English (default — uses EN endpoint) / 'K' 한국어 (uses KR endpoint).
              C/J fall back to English.
    
- `search_by_route`: [한국 공항 실시간 운항정보] 두 공항 사이 오늘 운항편을 검색합니다 (양방향, 한쪽은 한국 공항).
    Find today's flights between an origin and a destination airport.
    Bidirectional — at least one side must be a Korean hub.

    Examples:
    - "GMP→CJU schedule" → search_by_route("GMP", "CJU")
    - "Flights from Vancouver to Incheon" → search_by_route("YVR", "ICN")
    - "ICN→Narita flights" → search_by_route("ICN", "NRT")

    Args:
        origin: Origin airport IATA (e.g. GMP, ICN, YVR)
        destination: Destination airport IATA (e.g. CJU, NRT, ICN)
        lang: Response language 'E' (default) / 'K' / 'C' / 'J'. Match user's language.
    
- `track_my_flight`: [한국 공항 실시간 운항정보] 편명을 추적해 예정/변경 시각, 게이트, 수취대, 상태를 알려줍니다. (픽업에 유용)
    Track a flight — scheduled/estimated times, gate, baggage carousel, status.
    Carousel is critical for airport pickup.

    Examples:
    - "Is KE093 delayed?" → track_my_flight("KE093")
    - "7C166 arrival time & carousel" → track_my_flight("7C166")
    - "BX804F departure gate" → track_my_flight("BX804F", "GMP")

    Args:
        flight_id: Flight number (e.g. KE093, 7C166, BX804F)
        hub_airport: Hub airport IATA. If known, narrows search. Empty triggers
                     30-day snapshot DB lookup → falls back to 4-hub fan-out.
        lang: Response language 'E' (default) / 'K' / 'C' / 'J'. Match user's language.