Skip to main content
Glama
KOBIS MCP Server

KOBIS MCP Server

by una4199

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
KOBIS_API_KEYYesYour 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

CapabilityDetails
tools
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
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

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A3.5/5.0

Scored across 8 tools

Disambiguation4/5

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.

Naming Consistency4/5

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.

Tool Count5/5

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.

Completeness4/5

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.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues