Seoul Essentials MCP server
Commit Sep 27, 2026Provides structured data about essential public facilities in Seoul to help AI agents assist foreign tourists with real-time queries.
Also known as do-droid/seoul-essentials
- Stars
- 0
- Tools
- 11
- Downloads, 30 days
- —
- Latest version
- 0.2.0
- Last commit
- Sep 27, 2026
- License
- —
What is Seoul Essentials MCP?
Seoul Essentials provides structured data about essential public facilities in Seoul to help AI agents assist foreign tourists with real-time queries. It exposes 11 tools, such as type, district, filters.
Summary generated from the project's README
About Seoul Essentials MCP server
Seoul Essentials provides structured data about public facilities in Seoul to assist AI agents in helping foreign tourists. The server contains information on over 37,900 locations across 17 categories, including WiFi hotspots, pharmacies, public restrooms, subway stations, and AED locations. It is designed for developers building agents that need to answer real-time queries about local services in South Korea.
Users can connect to the server via a remote URL in their MCP client configuration or run it locally using Python. The server offers specific tools like find_places to search by type and district, get_place_detail to retrieve specific information by ID, and find_nearby to locate facilities using GPS coordinates. It also includes get_subway_timetable to provide transit schedules for subway lines 1 through 9. This toolset allows agents to filter for specific needs, such as finding English-speaking pharmacies or 24-hour restrooms.
What you can do with it
- 1Locate multilingual pharmaciesAn AI agent can find pharmacies in a specific district that offer services in English, Chinese, or Japanese.
- 2Find nearby public amenitiesA user can ask for the closest public restroom or AED based on their current GPS coordinates.
- 3Check subway schedulesThe agent can retrieve specific timetable information for a subway station and line.
- 4Search for free WiFiTourists can identify locations with free public WiFi hotspots in specific areas of the city.
Written from the project's README. Every use case is checked against a quote from it.
How to install Seoul Essentials MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Seoul Essentials MCP in Claude Code
$ claude mcp add seoul-essentials -- docker run -i --rm ghcr.io/do-droid/seoul-essentials:0.2.0Install Seoul Essentials MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"seoul-essentials": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/do-droid/seoul-essentials:0.2.0"
]
}
}
}Install Seoul Essentials MCP in VS Code
.vscode/mcp.json
{
"servers": {
"seoul-essentials": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/do-droid/seoul-essentials:0.2.0"
]
}
}
}Install Seoul Essentials MCP in VS Code CLI
$ code --add-mcp '{"name":"seoul-essentials","type":"stdio","command":"docker","args":["run","-i","--rm","ghcr.io/do-droid/seoul-essentials:0.2.0"]}'Install Seoul Essentials MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"seoul-essentials": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/do-droid/seoul-essentials:0.2.0"
]
}
}
}Install Seoul Essentials MCP in Codex
$ codex mcp add seoul-essentials -- docker run -i --rm ghcr.io/do-droid/seoul-essentials:0.2.0Install Seoul Essentials MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.seoul-essentials] command = "docker" args = ["run", "-i", "--rm", "ghcr.io/do-droid/seoul-essentials:0.2.0"]
Install Seoul Essentials MCP in Gemini CLI
$ gemini mcp add -s user seoul-essentials docker -- run -i --rm ghcr.io/do-droid/seoul-essentials:0.2.0Install Seoul Essentials MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"seoul-essentials": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/do-droid/seoul-essentials:0.2.0"
]
}
}
}Seoul Essentials MCP tools 11
Detected from the READMEtypedistrictfilterslimitlatlngradius_mstationlineday_typedirection
| type | — | |
| district | — | |
| filters | — | |
| limit | — | |
| lat | — | |
| lng | — | |
| radius_m | — | |
| station | — | |
| line | — | |
| day_type | — | |
| direction | — |
Configuration
API_BASE_URL
| Name | Description | |
|---|---|---|
| API_BASE_URL | — |
Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachabledo-droid/seoul-essentials is public and reachablegithub.com/do-droid/seoul-essentials ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)No licenseFinding
- Commit or release in the last yearLast commit or release 2026-09-27github.com/do-droid/seoul-essentials ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model11 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubSeoul Essentials — MCP Server
Essential public facility data for AI agents helping foreign tourists in Seoul, South Korea.
What is this?
Seoul Essentials is an MCP (Model Context Protocol) server that provides structured data about essential public facilities in Seoul. Designed for AI agents that assist foreign tourists with real-time queries about nearby services.
Available Data (37,900+ places, 17 types)
Counts are the live Firestore document counts as of 2026-08-04.
| Type | Description | Count |
|---|---|---|
wifi |
Free public WiFi hotspots (Seoul WiFi) | 12,008 |
aed |
AED locations; a site with several units is one record carrying aed_count and unit_locations |
7,890 |
pharmacy |
Pharmacies in all 25 districts; ?filter.english=true narrows to the ~400 with surveyed English/Chinese/Japanese service |
5,849 |
toilet |
Public restrooms across all 25 districts (2,008 open 24h) | 4,416 |
bike |
따릉이 (Seoul Bike) sharing stations | 3,340 |
heritage |
Designated cultural properties | 2,009 |
future_heritage |
Seoul Future Heritage sites | 485 |
traditional_market |
Korean traditional markets (Gwangjang, Namdaemun, ...) | 433 |
metro_facility |
Subway lockers & facilities | 340 |
taxi_stand |
Taxi stands | 255 |
post_office |
Post offices (EMS / international mail) | 227 |
ev_charger |
EV charging stations | 187 |
museum |
Museums & galleries | 171 |
baeknyeon |
Century-old designated shops & restaurants | 168 |
park |
Major parks | 133 |
tourist_info |
Tourist information centers | 16 |
tourist_zone |
Tourist special zones | 7 |
subway |
Subway timetables, Lines 1–9 | 405 stations |
MCP Tools
find_places
Search for public facilities by type and conditions.
Parameters:
type(required): one of the 17 types listed above (e.g.,"toilet","pharmacy","post_office","traditional_market","ev_charger")district(optional): Seoul district name in English or Korean (e.g.,"gangnam","강남구")filters(optional): Service-specific filters (e.g.,{"english": true},{"is_24h": true},{"indoor": true})limit(optional): Max results, 1-50 (default: 10)
get_place_detail
Get full details of a specific place by its ID.
Parameters:
id(required): Place ID (e.g.,"toilet_00001","pharmacy_001","aed_00001")
find_nearby
Find public facilities near GPS coordinates, sorted by distance.
Parameters:
lat(required): Latitude (Seoul range: ~37.4 to ~37.7)lng(required): Longitude (Seoul range: ~126.7 to ~127.2)radius_m(optional): Search radius in meters, 100-5000 (default: 500)type(optional): Filter by facility typelimit(optional): Max results, 1-20 (default: 5)
get_subway_timetable
Get subway timetable for a specific station.
Parameters:
station(required): Station name in Korean or English (e.g.,"강남"or"Gangnam")line(optional): Line number (e.g.,"2")day_type(optional):"weekday"|"saturday"|"holiday"(default:"weekday")direction(optional):"up"|"down"
Quick Start
Option A: Smithery (Recommended)
Visit Seoul Essentials on Smithery and follow the setup instructions for your MCP client.
Option B: Direct Connection
Add to your MCP client config (e.g., Claude Desktop claude_desktop_config.json):
{
"mcpServers": {
"seoul-essentials": {
"url": "https://seoul-essentials-mcp-230987091625.asia-northeast3.run.app/mcp"
}
}
}
Option C: Run Locally
git clone https://github.com/do-droid/seoul-essentials.git
cd seoul-essentials
API_BASE_URL="https://asia-northeast3-seoul-essentials.cloudfunctions.net/api" \
uv run python -m src.server
Example Queries
An AI agent can use these tools to answer questions like:
English
- "Find an English-speaking pharmacy near Gangnam Station"
- "Where is the nearest public restroom to my location?"
- "What's the subway schedule at Myeongdong Station?"
- "Find free WiFi hotspots in Hongdae area"
- "Where is the closest AED to Itaewon?"
日本語
- 「明洞で日本語が通じる薬局を探して」
- 「弘大の近くで無料Wi-Fiが使える場所は?」
- 「江南駅周辺のEV充電スポットを教えて」
中文
- "在明洞附近找会说中文的药店"
- "弘大附近哪里有24小时便利的公共厕所?"
- "梨泰院附近的清真餐厅在哪里?"
Feedback
We actively review and incorporate feedback to improve data quality and coverage.
For AI agents: Use the submit_feedback tool during a conversation to report issues or suggest improvements.
For developers: Open a feedback issue on GitHub.
Categories: new_data | data_quality | coverage | format | frequency | other
Known Data Limitations
pharmacy: Two layers. 417 records come from Seoul Open Data Plaza's "Foreign-language Capable Pharmacy Status" survey and carryservices.english/chinese/japanese; Gangnam-gu is absent from that upstream survey entirely (origin gap, not a parser bug), which is why?filter.english=true&district=gangnamstill returns nothing. The remaining 5,455 come from the MOIS LOCALDATA licence register and cover all 25 districts with precise coordinates and phone numbers. Licence-sourced records carryservices.language_support: "not surveyed"and deliberately omit the language keys — they are never advertised as English-capable, and?filter.english=trueexcludes them.post_office/traditional_market/ev_charger: Upstream datasets do not include lat/lng. Coordinates fall back to the centroid of each Seoul district (coordinates_approximate: true). District-level filters (?district=mapo) are exact;find_nearbyranking against these types is district-grained rather than building-grained.toilet: Opening hours come from a free-text field with 234 distinct formats. 2,008 records are confirmed 24-hour; 445 publish no usable hours and carry an explanatoryhours.noteinstead of open/close times.- Opening hours in general:
is_24h: trueappears only where the source supports it — toilets, 따릉이 docks, outdoor WiFi, EV chargers and tourist zones. Every other type's source publishes no hours at all, so those records carryis_24h: falseplus ahours.notesaying what is actually known. Filtering?filter.is_24h=truetherefore returns only verified round-the-clock places. address_en: 71.9% of records carry an English road address generated by Revised Romanization (scripts/romanize.pyin the backend repo). Building number, road and district are exact; a few loanword road names romanize phonetically rather than to their official spelling (올림픽로 → "Ollimpik-ro", officially "Olympic-ro"). Lot-number (지번) addresses carry no road name and are left empty rather than guessed.- Roadmap (next round):
halal_friendly(data.go.kr 15111159 was withdrawn — searching alternative sources) andemergency_room(data.go.kr 3043449 not findable — switching to e-gen.or.kr OpenAPI) are planned for the following refresh. Both were removed from the tool schema in 0.4.0 — they had been advertised as valid types while holding zero documents, so every call returned an empty result.
Data Sources
All data sourced from official Seoul government open data:
License
MIT
Seoul Essentials MCP questions
How do I add Seoul Essentials MCP to Claude Code?
Run claude mcp add seoul-essentials -- docker run -i --rm ghcr.io/do-droid/seoul-essentials:0.2.0 in your terminal. Add --scope user to make it available in every project.
How do I add Seoul Essentials MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does Seoul Essentials MCP provide?
It exposes 11 tools, including type, district, filters, limit, lat.
What kind of data does Seoul Essentials provide?
It provides data for over 17 types of facilities including WiFi hotspots, AED locations, pharmacies, public restrooms, subway stations, and more.
Can I find pharmacies that speak English?
Yes, you can use the English filter to narrow results to approximately 400 pharmacies that have surveyed English, Chinese, or Japanese service capabilities.