Skip to main content
Glama
Sign In
enesjakozh
Seoul Public Data MCP Server

Seoul Public Data MCP Server

by pinnaclesoft-ko
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

Seoul Public Data MCP Server Example

This is an example of an MCP server that provides various public data of Seoul using the Seoul Public Data API.

List of examples

  • Information on the number of passengers getting on and off at each subway line and station in Seoul

  • Seoul City Cultural Event Information

Related MCP server: k-skill-korea

How to set up

Setting up Seoul Public Data API Key

Information on the number of passengers getting on and off at each subway line and station in Seoul

Add the following {API key} to the file modules/KoreaSeoulCulturalEventInfo.ts .

import {
    Tool,
} from "@modelcontextprotocol/sdk/types.js";

const API_URL = "http://openapi.seoul.go.kr:8088/{authKey}/json/culturalEventInfo/{StartIndex}/{EndIndex}";
const API_KEY = "{API 키}";

Seoul City Cultural Event Information

Add the following {API key} to the file modules/KoreaSeoulSubwayStatus.ts .

import {
    Tool,
} from "@modelcontextprotocol/sdk/types.js";

const API_URL = "http://openapi.seoul.go.kr:8088/{authKey}/json/culturalEventInfo/{StartIndex}/{EndIndex}";
const API_KEY = "{API 키}";

Build it

npm i; npm run build

Adding MCP Settings to Claude Desktop

Add the following to claude_desktop_config.json file. Replace {built path} with your own.

{
  "mcpServers": {
    "KoreaSeoulData": {
      "command": "node",
      "args": [
        "{빌드된 경로}/seoul_korea/dist/index.js"
      ]
    }
  }
}

Usage examples

Information on the number of passengers getting on and off at each subway line and station in Seoul

image

Seoul City Cultural Event Information

image

Available Tools

2 tools
CulturalEventInfoC

서울시 문화행사 정보를 조회할 수 있는 도구입니다.

서울문화포털에서 제공하는 문화행사 정보입니다. 공연, 행사에 대한 장소, 날짜, 기관명, 이용대상, 이용요금, 출연자, 프로그램 등의 정보를 제공합니다.

반환되는 데이터는 JSON 형식으로 제공되며, 반환되는 데이터의 구조는 다음과 같습니다:

list_total_count: 총 데이터 건수
RESULT.CODE: 결과 코드
RESULT.MESSAGE: 결과 메시지
row: 데이터 배열
  
  각 데이터는 다음과 같은 필드를 포함합니다:

  CODENAME: 분류
  GUNAME: 자치구
  TITLE: 공연/행사명
  DATE: 날짜/시간
  PLACE: 장소
  ORG_NAME: 기관명
  USE_TRGT: 이용대상
  USE_FEE: 이용요금
  PLAYER: 출연자정보
  PROGRAM: 프로그램소개
  ETC_DESC: 기타정보
  ORG_LINK: 홈페이지 주소
  MAIN_IMG: 대표이미지
  RGSTDATE: 등록일
  TICKET: 시민/기관
  STRTDATE: 시작일
  END_DATE: 종료일
  THEMECODE: 테마분류
  LOT: 위도
  LAT: 경도
  IS_FREE: 무료여부
  HMPG_ADDR: 문화포털상세URL

Inputs: startIndex (required), endIndex (required).

KoreaSeoulSubwayStatusB

서울시 지하철호선별 역별 승하차 인원 정보를 조회할 수 있는 도구입니다.

날짜는 YYYYMMDD 형식으로 입력해야 하며, 지하철역 이름은 한글로 입력해야 합니다. 예를 들어, "서울역"은 "서울"과 같은 형식입니다. 지하철 노선 번호는 "1호선", "2호선"과 같은 형식으로 입력해야 합니다.

반환되는 데이터는 JSON 형식으로 제공되며, 반환되는 데이터의 구조는 다음과 같습니다:

list_total_count: 총 데이터 건수
RESULT.CODE: 결과 코드
RESULT.MESSAGE: 결과 메시지
row: 데이터 배열
  
  각 데이터는 다음과 같은 필드를 포함합니다:

  USE_YMD: 사용일자
  SBWY_ROUT_LN_NM: 호선명
  SBWY_STNS_NM: 역명
  GTON_TNOPE: 승차인원
  GTOFF_TNOPE: 하차인원
  REG_YMDT: 등록일자

Inputs: date (required), subwayLineNo (required), subwayStationName (required), startIndex, +1 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    B3/5.0

    Scored across 2 tools

    Disambiguation5/5

    The two tools have completely distinct purposes with no overlap. CulturalEventInfo retrieves cultural event information from Seoul's cultural portal, while KoreaSeoulSubwayStatus provides subway station passenger count data. An agent can easily differentiate between these two unrelated domains.

    Naming Consistency3/5

    The naming is mixed with no consistent pattern. CulturalEventInfo uses a descriptive noun phrase format, while KoreaSeoulSubwayStatus follows a different descriptive naming style. Both are readable but lack a consistent verb_noun or other predictable convention across the set.

    Tool Count2/5

    With only 2 tools, this server feels severely under-scoped for what appears to be a general 'Seoul Public Data' server. The tools cover two specific data endpoints, but the server name suggests broader public data access that would typically require more comprehensive coverage of Seoul's public data APIs.

    Completeness2/5

    Given the server name 'Seoul Public Data MCP Server,' there are significant gaps in coverage. Seoul likely offers numerous public data APIs beyond just cultural events and subway passenger counts. The surface is severely incomplete for what the server name promises, with no coverage of transportation, weather, demographics, or other typical public data domains.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • 네이버 길찾기 MCP 서버

      Chaeyun06
      -
      license
      A
      quality
      Not graded
      maintenance
      Enables users to access Naver Maps API functionality including directions, place search, geocoding, and reverse geocoding through a Model Context Protocol server.
      4
      -

    • k-skill-korea

      taeyoung1005
      F
      license
      Not graded
      quality
      D
      maintenance
      A read-only MCP server providing access to various Korean public data such as subway arrivals, weather, fine dust, bike availability, real estate, and more.
      -

    • Disclosure Compass

      MLOpsEngineer
      A
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol server that exposes seven read-only tools for querying Korean public company disclosures from the OpenDART system, returning normalized JSON.
      MIT

    • Seoul OpenData MCP

      whchoi98
      A
      license
      A
      quality
      C
      maintenance
      An MCP server that provides access to Seoul's real-time city data (population, transit, air quality, weather, cultural events, etc.) and batch statistics, enabling natural language queries about Seoul. It also includes a catalog of raw Seoul Open Data Plaza datasets.
      19
      1
      MIT

    Appeared in Searches