한국 세법 자료 통합 조회 MCP 서버 — 현재 국세청 국세법령정보시스템 원본 조회 지원
Strong domain-specific tool design with comprehensive parameter schemas and detailed descriptions in Korean. All 10 tools have explicit registration with JSON Schema input definitions. Descriptions are domain-optimized (100-300+ chars) and include usage guidance (e.g., 'lookup_tax_document' warns against confusing similarDocuments with correct answers). Parameters consistently include type, enum constraints, and min/max bounds. However, output schemas are not documented in the visible code, responses are shaped via _ok() and _envelope_errors() wrappers but the structure is not formally declared. Error handling is structured (NtsError with detail envelope) but recovery guidance is minimal. Tool composition is excellent: 9 search/lookup tools + 1 research tool follow a clear domain pattern. No security issues detected (read-only operations, no secrets in params).
문서번호로 지방세 문서(해석례·판례·결정례 자동 판별)를 **정확히 일치할 때만** 본문까지 반환한다. 표기 편차는 자동 정규화한다. 없으면 NOT_FOUND — similarDocuments 는 번호가 일부 겹치는 별개 문서이며 정답이 아니다. 문서번호를 아는 경우 검색 대신 항상 이 도구를 먼저 쓸 것.
문서번호로 국세청 문서(해석례·판례·결정례 자동 판별)를 **정확히 일치할 때만** 본문까지 반환한다. 표기 편차('서면 2026 법규재산 0119' 등)는 자동 정규화한다. 없으면 NOT_FOUND — similarDocuments 는 번호가 일부 겹치는 별개 문서이며 정답이 아니다. 문서번호를 아는 경우 검색 대신 항상 이 도구를 먼저 쓸 것.
기본통칙·집행기준 조항을 상세 조회한다. 조항ID를 알고 있으면 항상 이 도구를 먼저 쓸 것.
세법 자료를 종합 조사한다. 사용자 질문을 분석해 국세·지방세 도구를 자동 선택하고 여러 번 조회해 종합 답변을 만든다. 단순 조회는 search_tax_* / lookup_tax_* / search_local_tax_* / lookup_local_tax_* 를 직접 쓸 것.
한국지방세연구원 지방세 판례·결정례(조세심판원·감사원·법원·헌재)를 검색한다. 결과는 요지까지만 담은 후보 목록이며 본문은 포함하지 않는다 — 필요한 문서만 lookup_local_tax_document 로 상세 조회할 것. 공백 구분 낱말은 AND, match='any' 는 OR, exclude 는 NOT. 문서번호를 알면 lookup_local_tax_document 를 쓸 것.
한국지방세연구원 지방세 행정해석(행정안전부 유권해석)을 검색한다. 결과는 요지까지만 담은 후보 목록이며 본문은 포함하지 않는다 — 필요한 문서만 lookup_local_tax_document 로 상세 조회할 것. 공백 구분 낱말은 AND, match='any' 는 OR, exclude 는 NOT. 문서번호를 알면 lookup_local_tax_document 를 쓸 것.
Output schemas not formally documented. Responses are shaped via _ok() wrapper and error envelope, but the structure of successful results (fields, types, pagination) is not declared in tool definitions. LLMs cannot plan downstream tool calls without knowing what fields to expect.
research_tax tool lacks input validation and output structure documentation. It accepts a free-form 'question' string and internally routes to other tools, but the response format and which tools it may call are not declared. This violates single-responsibility and makes the tool's behavior opaque to LLMs.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 64 | 2026-07-28+ | v2 |
국세청 판례·결정례(과세적부·이의신청·심사청구·심판청구·판례·헌재)를 검색한다. 결과는 요지까지만 담은 후보 목록이며 본문은 포함하지 않는다 — 필요한 문서만 lookup_tax_document 로 상세 조회할 것. 공백 구분 낱말은 AND, match='any' 는 OR, exclude 는 NOT. 문서번호를 알면 lookup_tax_document 를 쓸 것.
국세청 세무서식(신청·신고·신청서 등)을 검색한다. 결과는 서식 목록이며 본문은 포함하지 않는다.
국세청 행정 해석기준(기본통칙·집행기준·고시·훈령)을 검색한다. 결과는 조항 목록이며 본문은 포함하지 않는다 — 필요한 조항만 lookup_tax_guidance 로 상세 조회할 것. 공백 구분 낱말은 AND, match='any' 는 OR, exclude 는 NOT.
국세청 세법해석례(예규: 사전답변·질의회신·과세기준자문·고시서면질의)를 검색한다. 결과는 요지까지만 담은 후보 목록이며 본문은 포함하지 않는다 — 필요한 문서만 get_tax_document 로 상세 조회할 것. 공백 구분 낱말은 AND, match='any' 는 OR, exclude 는 NOT. 문서번호를 알면 lookup_tax_document 를 쓸 것.
Error recovery guidance is minimal. NtsError envelope includes detail (similarDocuments, guardrail) but tool descriptions do not explain what to do when NOT_FOUND is returned or how to interpret similarDocuments. LLMs need explicit guidance: 'If NOT_FOUND, try search_tax_* with partial keywords instead.'
Pagination parameters (page, limit) present but total count and next_cursor not documented. search_* tools accept page/limit but responses do not declare whether they include total_count or has_more, making it unclear when to stop paginating.
Tool descriptions use Korean exclusively. While domain-appropriate, descriptions lack English translations, limiting accessibility for non-Korean-speaking developers and LLMs trained primarily on English. Consider bilingual descriptions or English summaries.