korea-benefits-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| DATA_GO_KR_SERVICE_KEY | Yes | Your data.go.kr API service key. Required for accessing the public service catalog. | |
| KOREA_BENEFITS_CACHE_DIR | No | Directory for caching the benefit catalog. Defaults to %LOCALAPPDATA%\korea-benefits-mcp on Windows or ~/.cache/korea-benefits-mcp on Unix. |
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 |
|---|---|
| find_benefitsA | 사용자 조건으로 받을 수 있는 정부·지자체 혜택을 찾는다. 코드화된 자격조건으로 판정하고, 부족한 정보는 되물을 질문으로 돌려준다. Args: age: 만 나이. gender: 남성 / 여성. sido: 거주 시도(예: 서울, 경기도, 부산광역시). sigungu: 거주 시군구(예: 강남구, 수원시). 시도와 함께 쓴다. median_income_percent: 가구 소득이 기준중위소득의 몇 %인지(예: 80). 모르면 비운다. traits: 생애·직업·가구 상황(예: ["직장인", "1인가구", "무주택"]). 해당 없으면 빈 목록 [], 모르면 비운다. 선택지는 list_profile_options 참고. keyword: 분야·키워드 필터(예: 주거, 월세, 출산, 취업). small_business: 소상공인·예비창업자면 true. include_needs_info: 정보가 부족해 판정 보류된 혜택도 포함할지. limit: 최대 결과 수(기본 20, 최대 50). |
| search_benefitsA | 키워드로 정부·지자체 혜택을 검색한다(자격 판정 없이). 예: 월세, 청년 주거, 산후조리, 전기차. Args: query: 검색어. 공백으로 여러 단어를 주면 모두 포함하는 것만 찾는다. sido: 거주 시도로 지자체 사업을 거른다(선택). sigungu: 거주 시군구(선택). limit: 최대 결과 수(기본 20, 최대 50). |
| get_benefit_detailA | 혜택 상세: 지원대상, 선정기준 원문, 지원내용, 신청방법, 구비서류, 문의처, 온라인 신청 링크, 코드화된 자격조건. Args: service_id: find_benefits / search_benefits 결과의 service_id. |
| check_eligibilityA | 특정 혜택 하나에 대해 자격을 판정하고, 불가 사유나 부족한 정보를 알려준다. Args: service_id: 혜택 service_id. age: 만 나이. gender: 남성 / 여성. median_income_percent: 기준중위소득 대비 %. traits: 생애·직업·가구 상황 목록. 해당 없으면 [], 모르면 비운다. small_business: 소상공인·예비창업자 여부. |
| upcoming_deadlinesA | 신청 마감이 다가오는 혜택 목록(마감 날짜가 명시된 것만). 상시신청은 제외된다. Args: days: 오늘부터 며칠 안에 마감되는 것(기본 30). sido: 거주 시도(선택). sigungu: 거주 시군구(선택). keyword: 키워드 필터(선택). limit: 최대 결과 수(기본 30). |
| list_profile_optionsA | find_benefits의 traits에 넣을 수 있는 생애·직업·가구 상황 선택지와 소득 입력 방법. |
| catalog_statusA | 로컬에 동기화된 보조금24 카탈로그 상태(건수, 마지막 동기화 시각). |
| refresh_catalogA | 보조금24 전체 목록과 자격조건을 지금 다시 받아온다(보통은 하루 한 번 자동). |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| benefit_checkup | 정부 혜택 점검 인터뷰를 시작하는 프롬프트. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 8 tools
find_benefits and search_benefits could be confused, but the former is filter-based with eligibility while the latter is keyword-only. check_eligibility and get_benefit_detail are distinct. Most tools have clear unique roles.
All tool names follow a consistent verb_noun or noun_noun pattern (get_, check_, upcoming_, catalog_, refresh_, find_, search_, list_) in snake_case. No mixing of conventions.
8 tools is well-scoped for a benefits discovery server: search, filter, detail, eligibility, deadlines, catalog management, and profile options. Each tool earns its place.
Core discovery and eligibility functions are present, but there's no way to save/bookmark benefits, no application tracking, and no user profile persistence. The surface is functional but lacks lifecycle support beyond initial search.