tour-crowding-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| DATA_GO_KR_SERVICE_KEY | Yes | Decoding key from data.go.kr for Korea Tourism Organization APIs |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| resolve_areaA | 지역명을 시군구 코드로 변환한다. 예: "경주", "전북 전주", "제주시". status 가 ambiguous 면 candidates 를 사용자에게 보여주고 되물어라. 이후 도구들은 여기서 받은 cd 를 사용한다. |
| get_crowdingB | 지역의 관광지 혼잡도(집중률). names 를 주면 그 관광지들만, 없으면 지역 요약. 수치는 한국관광공사가 산출한 예측값이며 실측이 아니다 — 답할 때 반드시 언급하여라. 등급은 혼잡·보통·한적 세 단어만 사용한다. 지역 요약에는 coverage(전체 몇 곳을 본 결과인지)가 있으니 같이 언급한다. 데이터가 모든 관광지에 있는 것은 아니다. |
| recommend_quietA | 지역에서 앞으로 며칠간 한적할 것으로 예측되는 관광지 추천. 같은 지역의 집중률 평균이 낮은 순서다. 순서를 바꾸지 말고 그대로 안내하되, 혼잡도 기준 추천이라는 것과 예측값이라는 것을 언급한다. 카테고리(캠핑·웰니스·음식 등)를 콕 집은 요청에는 이 도구가 아니라 list_places 를 사용한다 — 집중률은 관광지 대상이라 갈래와 결합되지 않는다. |
| find_attractionA | 관광지명으로 관광지를 찾는다. 지역을 알면 cd 를 넣어야 동명 관광지가 섞이지 않는다. |
| get_attraction_detailB | 관광지 상세: 개요, 주소, 운영시간·휴무일 등. 응답에 없는 항목은 명백하게 모른다고 응답하라. |
| list_placesB | 지역에서 카테고리별로 갈 만한 곳 목록. 카테고리는 한국관광공사 분류체계 기준. 캠핑·야영·글램핑은 category="캠핑", 의료·온천·스파·한방·찜질방·힐링은 category="웰니스" 로 호출한다. 목록 순서는 인기순이 아니다. "한적한 웰니스" 처럼 갈래가 섞인 요청도 이 목록이 답의 중심이다. 갈래 목록에는 혼잡도가 없으니 아는 것처럼 말하지 말고, 목록을 준 뒤 카테고리별 혼잡도는 집계되지 않는다고 응답하여라. |
| list_festivalsC | 지역에서 진행 중이거나 예정된 축제·행사. date_from(YYYY-MM-DD) 생략 시 오늘. 각 항목의 기간을 같이 안내하고, 물어본 날짜가 기간 안일 때만 '그때 한다'고 말해라. |
| usageA | 이번 세션에서 사용자 키로 나간 상류 호출 수. 쿼터가 걱정될 때 확인한다. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 8 tools
Most tools have clearly separate roles—area resolution, attraction lookup, detail, crowding, festivals, and quota usage are easy to tell apart. However, get_crowding and recommend_quiet both deal with crowding-derived information, and find_attraction versus list_places could initially be confused, though the descriptions provide enough guidance.
The tool names follow a mostly consistent snake_case verb-first pattern such as find_*, get_*, list_*, and resolve_*. Minor deviations include usage, which is a bare noun, and recommend_quiet, which uses an adjective rather than a noun object.
Eight tools is well within the ideal range and each tool covers a distinct part of the tourism/crowding workflow: area resolution, attraction search and detail, crowding data, quiet recommendations, category place lists, festivals, and quota checking. Nothing feels redundant or unnecessary.
The toolset covers the core workflow end-to-end, including resolving areas, finding and inspecting attractions, getting crowding forecasts, listing places and festivals, and monitoring usage. Minor gaps exist—such as no direct combination of category lists with crowding and no explicit date-scoped crowding query—but the descriptions acknowledge these limitations and give agents a workaround.