kobis-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| KOBIS_API_KEY | No | KOBIS open API key. Can be provided directly as an environment variable or via a .env file. | |
| KOBIS_ENV_FILE | No | Path to a .env file containing KOBIS_API_KEY. Equivalent to using the --env-file option. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
영화진흥위원회(KOBIS) 오픈 API로 한국 박스오피스와 영화·영화인·영화사 정보를 조회합니다. 일별 박스오피스는 어제까지만 집계되며, 날짜는 YYYYMMDD 또는 YYYY-MM-DD 로 넣습니다. 영화 상세는 search_movies 로 movie_cd 를 찾은 뒤 get_movie_info 로 조회하세요 (영화인·영화사도 같은 방식). 지역·국적 코드는 get_code_list 로 찾습니다. [CONFIG_ERROR]/[AUTH_ERROR] 는 API 키 문제이니 사용자에게 키 설정을 안내하고, [UPSTREAM_ERROR] 는 서버 장애이지 대상이 없다는 뜻이 아닙니다.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| logging | {} |
| prompts | {
"listChanged": true
} |
| resources | {
"subscribe": false,
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_daily_box_officeA | 일별 박스오피스 순위(관객수, 매출액, 누적관객 등)를 조회합니다. 기본값은 어제(KST)입니다. 오늘 이후 날짜는 집계되지 않습니다. |
| get_weekly_box_officeA | 주간/주말 박스오피스 순위를 조회합니다. target_date 가 속한 주의 결과를 돌려주며, 기본값은 지난주(오늘-7일)입니다. |
| search_moviesA | 영화를 검색합니다 (영화명·감독·개봉/제작연도·국적·유형). 결과의 movie_cd 로 get_movie_info 를 호출할 수 있습니다. |
| get_movie_infoB | 영화 상세 정보(상영시간, 개봉일, 장르, 감독, 배우, 관람등급, 제작/배급사 등)를 조회합니다. |
| search_peopleA | 영화인(감독, 배우, 스태프)을 검색합니다. 결과의 people_cd 로 get_person_info 를 호출할 수 있습니다. |
| get_person_infoA | 영화인 상세 정보(성별, 대표 분야, 필모그래피 등)를 조회합니다. |
| search_companiesA | 영화사(제작사, 배급사 등)를 검색합니다. 결과의 company_cd 로 get_company_info 를 호출할 수 있습니다. |
| get_company_infoB | 영화사 상세 정보(대표자, 분류, 필모그래피 등)를 조회합니다. |
| get_code_listA | KOBIS 공통코드(광역지역, 국적, 영화유형 등)를 조회합니다. 다른 도구의 코드 인자에 넣을 값을 찾을 때 씁니다. |
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 9 tools
Each tool targets a distinct resource plus action: daily vs weekly box office are clearly separated by aggregation period, and each entity (movie, person, company) has a paired search vs detail lookup that is unambiguous. get_code_list is a clearly scoped reference tool that does not overlap with anything else.
All nine tools follow a strict snake_case verb_noun pattern with only two verbs (get_*/search_*) used consistently by intent: search_ for discovery, get_ for detail/list retrieval. No mixed conventions or vague verbs.
Nine tools is well within the ideal 3-15 range and each earns its place, forming three symmetric search/detail pairs plus box office and code lookups. Nothing appears redundant or missing from the set structurally.
Coverage of the KOBIS domain is solid: box office rankings, movie/person/company search and detail, and code lookup all form closed workflows with explicit ID handoffs. Minor gaps exist, such as regional box office, advance ticket/reservation stats, or monthly aggregations, but core agent workflows are not blocked.