Busan Essentials MCP server

Busan Essentials — MCP Server

Find the nearest restroom, pharmacy, free WiFi, AED, or tourist information center in Busan, South Korea. 8,680 places from Korean government open data, every record in both Korean and English.

What is this?

Busan Essentials is an MCP (Model Context Protocol) server that answers "where is the nearest X in Busan?" for AI agents helping travellers and residents. Every record carries a Korean and English name and address, so an agent can hand the Korean text to a taxi driver and the English to the traveller.

Available Data

8,680 places live across all 16 Busan districts, sourced from data.go.kr. Each record has GPS coordinates, opening hours, accessibility flags, and a trust_score.

Not covered: subway and bus timetables, taxis, restaurants, hotels, attractions, and anywhere outside Busan. getsubwaytimetable is registered but has no data loaded — see Known Data Limitations.

MCP Tools

find_places

Search by type, district, and attributes. Use findnearby instead when the user has a location or asks for the nearest* one.

Parameters:

• type (required): "toilet" | "pharmacy" | "wifi" | "aed" | "tourist_info"
• district (optional): Busan district name in English or Korean (e.g., "haeundae", "해운대구")
• filters (optional): Attribute filters, all of which must match. Only these exist:

pharmacy, wifi, and aed carry no usable filter — the upstream sources record no per-facility variation. An unknown filter key returns zero results rather than being ignored.

• limit (optional): Max results, 1-50 (default: 10)

getplacedetail

Get the full record for one facility by its ID. IDs come from findplaces or findnearby — don't guess them.

Parameters:

• id (required): Place ID (e.g., "toilet00001", "pharmacy0538", "aed00001", "touristinfo_08")

find_nearby

Find the nearest facilities to a GPS point, sorted by distance. The right default for "nearest", "closest", or "around here" — and for urgent needs.

Parameters:

• lat (required): Latitude (Busan spans ~35.04 to ~35.40)
• lng (required): Longitude (Busan spans ~128.78 to ~129.30)
• radius_m (optional): Search radius in meters, 100-5000 (default: 500). Widen it if the first call comes back empty — 500m is dense downtown but sparse in outer districts.
• type (optional): Restrict to one facility type. Omit to get whatever is closest.
• limit (optional): Max results, 1-20 (default: 5)

Each result includes distance_m, the straight-line distance from the search point.

getsubwaytimetable

Not available yet. No timetable data is loaded, so every call returns nothing for every station. The tool stays registered so it starts working the moment the data lands — see Known Data Limitations.

submit_feedback

Report missing, wrong, or stale data. Reports are read and acted on: earlier reports about empty English fields led to all 8,680 records being filled.

Shortened. The full README is on GitHub.