KOBIS MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| KOBIS_API_KEY | Yes | Your KOBIS Open API key. It can be provided in the project's .env file or through the MCP client's environment variables. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
영화진흥위원회 KOBIS의 읽기 전용 영화·박스오피스 데이터를 제공합니다. 날짜는 YYYYMMDD 형식입니다. 영화·영화인·영화사 상세정보가 필요하면 먼저 검색 도구로 코드를 찾은 뒤 상세정보 도구를 호출하세요.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| kobis_daily_box_officeB | 특정 날짜의 한국 영화관 일별 박스오피스 순위를 조회합니다. |
| kobis_weekly_box_officeB | 특정 날짜가 포함된 주의 주간·주말·주중 박스오피스 순위를 조회합니다. |
| kobis_search_moviesC | 영화명, 감독명, 제작연도, 개봉일 등의 조건으로 영화를 검색합니다. |
| kobis_movie_detailsB | KOBIS 영화 코드로 영화의 상세정보를 조회합니다. |
| kobis_search_peopleB | 영화인 이름이나 참여 영화명으로 영화인을 검색합니다. |
| kobis_person_detailsB | KOBIS 영화인 코드로 상세정보와 필모그래피를 조회합니다. |
| kobis_search_companiesC | 영화사명이나 대표자명으로 영화사를 검색합니다. |
| kobis_company_detailsB | 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 8 tools
Each tool maps to a distinct resource and action: box office (daily vs weekly), movie search vs details, people search vs details, company search vs details. The only mild overlap is between the two box office tools, but their descriptions clearly differentiate a single date from a week range.
All names share a consistent kobis_ prefix and snake_case convention. There is a minor structural deviation between verb-first search tools (kobis_search_movies) and noun-first detail tools (kobis_movie_details), but the pattern remains highly readable.
Eight tools is a well-scoped set that mirrors the natural structure of the KOBIS domain without redundancy. Each tool earns its place, pairing one search and one detail lookup per entity plus two box office views.
The surface covers box office rankings, movie search/details, people search/details, and company search/details, which spans the core KOBIS API workflows. Minor gaps remain, such as monthly or genre box office and bulk list endpoints, but agents can work around these via date-based and search queries.