Seoul 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.

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 type
• limit (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-seou

... [View full README on GitHub](https://github.com/do-droid/seoul-essentials#readme)