CLI + MCP wrappers for FSS Open API data access
Server defines 7 tools with complete input schemas and descriptions. All tools follow verb_noun naming (search_*). Descriptions are present and moderately detailed (100-250 chars), explaining purpose and parameters. However, descriptions lack actionable guidance on when to use each tool vs. alternatives, and output schemas are documented only in docstrings, not in structured form. Parameter descriptions are adequate but generic. No error handling guidance, no examples of recovery paths. Tools are well-composed (each does one thing), but descriptions could better explain the financial product taxonomy and when to call search_financial_company first.
정기예금 상품 조회 (finlife depositProductsSearch). Args: - query: 회사명/코드 검색어. 내부적으로 financeCd로 매핑됨 - company_code: 금융회사 코드(fin_co_no). 지정 시 query보다 우선 - page, size: 페이지네이션 - top_group: 단일 조회 시 권역코드(topFinGrpNo), 기본값 020000(은행) - all_groups: True면 은행(020000)+저축은행(030300) 통합 조회 Returns: - products, total, page, size, kind, raw_endpoint - all_groups=True인 경우 groups=["020000","030300"] 포함
금융회사 검색. 용도: - 금융회사 코드(fin_co_no) 확인용 - 이후 products 계열 툴에서 company_code로 정밀 조회할 때 사용 Args: - query: 회사명/키워드 (예: "농협", "하나") - page, size: 페이지네이션 - top_group: 권역코드(topFinGrpNo), 기본값 020000(은행) Returns: - companies, total, page, size, kind, raw_endpoint
전세자금대출 상품 조회 (finlife rentHouseLoanProductsSearch). Args: - query: 회사명/코드 검색어. 내부적으로 financeCd로 매핑됨 - company_code: 금융회사 코드(fin_co_no). 지정 시 query보다 우선 - page, size: 페이지네이션 - top_group: 권역코드(topFinGrpNo), 기본값 020000(은행) Returns: - products, total, page, size, kind, raw_endpoint
주택담보대출 상품 조회 (finlife mortgageLoanProductsSearch). Args: - query: 회사명/코드 검색어. 내부적으로 financeCd로 매핑됨 - company_code: 금융회사 코드(fin_co_no). 지정 시 query보다 우선 - page, size: 페이지네이션 - top_group: 권역코드(topFinGrpNo), 기본값 020000(은행) Returns: - products, total, page, size, kind, raw_endpoint
Output schemas documented only in docstrings, not in structured MCP response format. LLMs cannot parse docstring descriptions of return fields; they need explicit JSON Schema definitions for output.
Descriptions lack dependency hints and selection guidance. E.g., search_savings/search_deposits/search_mortgage do not explain that search_financial_company should be called first to obtain company_code for precise queries.
No error handling guidance. Descriptions do not explain what happens if query/company_code is invalid, if API rate limits are hit, or how to recover. LLMs have no recovery path.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 62 | 2026-07-28+ | v2 |
연금저축 상품 조회. 기본 동작: - all_groups=False: top_group 단일 권역 조회 통합 동작: - all_groups=True: 보험(050000) + 금융투자(060000) 2회 조회 후 병합/중복제거 Args: - query: 회사명/코드 검색어. 내부적으로 financeCd로 매핑됨 - company_code: 금융회사 코드(fin_co_no). 지정 시 query보다 우선 - page, size: 페이지네이션 - top_group: 단일 조회 시 권역코드(topFinGrpNo) - all_groups: True면 050000+060000 통합 조회 Returns: - products, total, page, size, kind, raw_endpoint - all_groups=True인 경우 groups=["050000","060000"] 포함
개인신용대출 상품 조회 (finlife creditLoanProductsSearch). Args: - query: 회사명/코드 검색어. 내부적으로 financeCd로 매핑됨 - company_code: 금융회사 코드(fin_co_no). 지정 시 query보다 우선 - page, size: 페이지네이션 - top_group: 권역코드(topFinGrpNo), 기본값 020000(은행) Returns: - products, total, page, size, kind, raw_endpoint
적금 상품 조회 (finlife savingProductsSearch). Args: - query: 회사명/코드 검색어. 내부적으로 financeCd로 매핑됨 - company_code: 금융회사 코드(fin_co_no). 지정 시 query보다 우선 - page, size: 페이지네이션 - top_group: 단일 조회 시 권역코드(topFinGrpNo), 기본값 020000(은행) - all_groups: True면 은행(020000)+저축은행(030300) 통합 조회 Returns: - products, total, page, size, kind, raw_endpoint - all_groups=True인 경우 groups=["020000","030300"] 포함
Parameter descriptions use Korean examples ('농협', '하나') without explaining what these represent or how they map to internal codes. LLMs may not understand Korean financial institution names.
top_group parameter accepts arbitrary strings (권역코드) with no enum constraint. Descriptions mention '020000' (은행) and '030300' (저축은행) but do not enumerate all valid values. LLMs may hallucinate invalid codes.