nhplug-mcp provides 6 tools with complete Zod schemas and descriptions in Korean. Naming follows verb_noun convention (list_apis, describe_api, call_api, get_stock_price, get_stock_balance, list_accounts). Descriptions are substantive (100-250 chars) and explain purpose and prerequisites. However, parameter descriptions lack format constraints (e.g., stock_code should specify '6-digit format'), output schemas are not documented, and error handling is present but generic. No tool annotations (readOnlyHint/destructiveHint). The call_api tool accepts arbitrary objects, risking invalid input. Overall solid foundation with room for schema rigor and output documentation.
operationId 와 입력값으로 NH Open API 를 실제 호출합니다. 인증/헤더/Input_0 봉투는 자동 처리됩니다. 주문(거래) API 는 서버가 거래 활성화 모드(NHPLUG_ENABLE_TRADING=true)일 때만 호출됩니다.
특정 operationId 의 입력 필드(Input_0) 스키마를 반환합니다. call_api 호출 전에 어떤 파라미터가 필요한지 확인하는 용도입니다.
국내주식 계좌 잔고를 조회합니다. (단축 도구 = krstockInquiryBalance)
국내주식 현재가 시세를 조회합니다. (단축 도구 = call_api 로 krstockQuoteCurrentPrice 를 호출하는 것과 동일)
로그인 자격증명(앱키/시크릿)에 연결된 보유 계좌 목록을 조회합니다. 잔고조회·주문 전에 계좌번호(act_no)를 확보하는 용도입니다. 입력값은 없습니다. (플랫폼 공통 엔드포인트 POST /n2/acctinfo)
NH투자증권 Open API 에서 호출 가능한 엔드포인트 목록을 조회합니다. 자산군(domain)·카테고리·키워드로 필터링할 수 있습니다. 먼저 이 도구로 원하는 API 의 operationId 를 찾은 뒤 describe_api / call_api 로 이어가세요. 주문(거래) API 는 서버가 거래 활성화 모드일 때만 표시됩니다.
Output schemas not documented. Tools return textResult() with unstructured JSON, but LLMs cannot plan downstream calls without knowing field names and types. E.g., list_apis returns 'apis' array but structure of each element is not specified.
Parameter format constraints missing. stock_code should document '6-digit format (e.g., 005930)' but only says '종목코드 6자리'. account_no lacks format spec. call_api's 'input' param accepts z.record(z.any()), allowing invalid payloads without validation.
No tool annotations. call_api and get_stock_balance are read-only but lack readOnlyHint. call_api with trading enabled is destructive but lacks destructiveHint. Agents cannot distinguish safe from risky calls.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 68 | 2026-07-28+ | v2 |
Error messages are generic. toErrorResult() returns structured error detail but errorResult() returns plain text. No guidance on recovery steps (e.g., 'operationId not found, call list_apis to discover valid IDs').
No pagination support. list_apis returns all matching APIs without limit or offset. Large result sets could exhaust context window. Should cap at 20-50 items and offer pagination.