Skip to main content
Glama

law_article

Read-onlyIdempotent

Fetch Korean statute text as in force on a chosen date, including Act → Decree → Rule delegation chains, annexes, and administrative-rule fallback for point-in-time tax analysis.

Instructions

Get statute text as in force on a date, with optional Act → Decree → Rule chain. 조문 원문(기준일 시행본)과 3단 위임.

사실관계에 사업연도·귀속연도·과세기간이 있으면 as_of에 그 기간 말일을 넣는다(생략하면 오늘 시행본). 언제: 세액·요건 판단처럼 사실 발생 시점의 법령이 필요할 때. 해석·판례는 회신 당시 법 기준이므로 이 도구로 적용 연도 조문과 대조. 별표: article='별표 1'(가지번호는 '별표 3의2')이면 그 시행본의 별표 원문(표는 글자 그림 그대로), article='별표'면 별표 목록. 긴 별표는 keyword로 그 낱말이 든 줄과 앞뒤 줄만. 조문 번호를 모르면 find_article로 먼저 찾는다. 긴 조문(4,000자 초과)은 keyword(키워드가 든 항만) 또는 paragraph(특정 항)로 필요한 항만 조회 — 둘 다 없으면 항 목록과 안내 반환. 결과의 '연결'에 상위·하위 조문 위치가 있으니 그 조를 law_article로 이어서 조회. 행정규칙(외국환거래규정·국세청 고시 등)은 법령에 없을 때 자동 폴백 — as_of를 주면 그 날짜에 시행 중이던 연혁본(법제처 등록분)과 부칙, 생략하면 현행본. 반환: {법령, 조, 적용 시행일, 적용 기준일, 본문, 링크, 반환 범위, 연결, 읽기 주의(돌려준 본문의 단서·우선·제외 구절 원문, 최대 3개), 기준일 안내?, 최근 개정?, 다시 조회?} 또는 {위임체계: [{단계, 법령, 조, 적용 시행일, 본문}]} (+ 기본통칙·집행기준). 읽기 전용. 법제처 공식 API — 환경변수 LAW_OC(무료) 필요, 없으면 발급 안내 오류. 전체 시간 예산 약 45초 — 넘으면 받은 부분(본문 등)만 돌려주고 '부분 결과'에 빠진 항목을 적는다.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "law_name": "<law_name>",
      "article": "<article>"
    },
    "name": "law_article"
  }
}

Input Schema

NameRequiredDescriptionDefault
langNoOutput language. 'en': English keys and labels, official English texts where available (tax treaties, statutes), other Korean texts returned with a host_ai_translate instruction (your AI translates); Solar machine translation only when UPSTAGE_API_KEY or on-prem Solar is configured. 기본 'ko'ko
as_ofNo기준일 YYYYMMDD. 사실관계에 사업연도·귀속연도·과세기간이 있으면 그 기간 말일을 넣는다(생략하면 오늘 시행본). 거래처·거래일처럼 특정 날짜가 필요하면 그 날짜
articleYes조문 번호. '제52조' 또는 '제28조의2' 형식. '제52조 제1항'처럼 항을 함께 줄 수 있음. 별표는 '별표 1', 목록은 '별표'
keywordNo키워드가 들어간 항만 반환. 긴 조문(4,000자 초과)에서 항 번호 모를 때 사용
law_nameYes법령 정식 명칭. 예: '법인세법', '법인세법 시행령', '법인세법 시행규칙'
paragraphNo원하는 항만 지정. '1'·'제1항'·'2' 등. 호 지정: '제2항 제2호', 여러 호: '제1항 제5호,제6호'·'제1항 제5호~제6호'(항을 빼면 제1항의 호로 봄), 여러 항: '2,3'·'제2항, 제3항'. 그 항·호만 반환
with_rulesNoTrue면 그 조의 기본통칙 전문과 집행기준 항목도 함께
with_delegationNoTrue면 법률 조문에 연결된 시행령·시행규칙 위임 조문 전부(3단)

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changedv0.12.22
    • changedInput schema / properties / article / description
      Previous value: -"조문 번호. '제52조' 또는 '제28조의2' 형식. '제52조 제1항'처럼 항을 함께 줄 수 있음"New value: +"조문 번호. '제52조' 또는 '제28조의2' 형식. '제52조 제1항'처럼 항을 함께 줄 수 있음. 별표는 '별표 1', 목록은 '별표'"
  2. Changed2 schema fields changedv0.12.10
    • changedInput schema / properties / keyword / description
      Previous value: -"키워드가 들어간 항(①②…/제1항…)만 반환. 긴 조문(4,000자 초과)에서 항 번호 모를 때 사용"New value: +"키워드가 들어간 항만 반환. 긴 조문(4,000자 초과)에서 항 번호 모를 때 사용"
    • changedInput schema / properties / paragraph / description
      Previous value: -"원하는 항만 지정. '①'·'1'·'제1항'·'②' 등. 호 지정: '②2호'·'제2항 제2호', 여러 항: '2,3'·'②,③'·'제2항, 제3항'. 그 항만 반환"New value: +"원하는 항만 지정. '1'·'제1항'·'2' 등. 호 지정: '제2항 제2호', 여러 호: '제1항 제5호,제6호'·'제1항 제5호~제6호'(항을 빼면 제1항의 호로 봄), 여러 항: '2,3'·'제2항, 제3항'. 그 항·호만 반환"
  3. Changed1 schema field changedv0.11.1
    • changedInput schema / properties / as_of / description
      Previous value: -"기준일 YYYYMMDD. 그날 시행 중이던 연혁본. 생략하면 오늘"New value: +"기준일 YYYYMMDD. 사실관계에 사업연도·귀속연도·과세기간이 있으면 그 기간 말일을 넣는다(생략하면 오늘 시행본). 거래처·거래일처럼 특정 날짜가 필요하면 그 날짜"
  4. Changed1 schema field changedv0.11.0
    • changedInput schema / properties / paragraph / description
      Previous value: -"원하는 항만 지정. '①'·'1'·'제1항'·'②' 등. 그 항만 반환"New value: +"원하는 항만 지정. '①'·'1'·'제1항'·'②' 등. 호 지정: '②2호'·'제2항 제2호', 여러 항: '2,3'·'②,③'·'제2항, 제3항'. 그 항만 반환"
  5. Changed4 schema fields changedv0.9.1
    • changedInput schema / properties / article / description
      Previous value: -"조문 번호. '제52조' 또는 '제28조의2' 형식"New value: +"조문 번호. '제52조' 또는 '제28조의2' 형식. '제52조 제1항'처럼 항을 함께 줄 수 있음"
    • addedInput schema / properties / keyword
      Added value: +{
      +  "default": "",
      +  "description": "키워드가 들어간 항(①②…/제1항…)만 반환. 긴 조문(4,000자 초과)에서 항 번호 모를 때 사용",
      +  "title": "Keyword",
      +  "type": "string"
      +}
    • changedInput schema / properties / lang / description
      Previous value: -"Output language. 'en': English keys and labels, official English texts where available (tax treaties, statutes), titles/summaries machine-translated by Upstage Solar when UPSTAGE_API_KEY is set. 기본 'ko'"New value: +"Output language. 'en': English keys and labels, official English texts where available (tax treaties, statutes), other Korean texts returned with a host_ai_translate instruction (your AI translates); Solar machine translation only when UPSTAGE_API_KEY or on-prem Solar is configured. 기본 'ko'"
    • addedInput schema / properties / paragraph
      Added value: +{
      +  "default": "",
      +  "description": "원하는 항만 지정. '①'·'1'·'제1항'·'②' 등. 그 항만 반환",
      +  "title": "Paragraph",
      +  "type": "string"
      +}
  6. Changed6 schema fields changedv0.4.0
    • addedInput schema / properties / article / description
      Added value: +"조문 번호. '제52조' 또는 '제28조의2' 형식"
    • addedInput schema / properties / as_of / description
      Added value: +"기준일 YYYYMMDD. 그날 시행 중이던 연혁본. 생략하면 오늘"
    • addedInput schema / properties / lang
      Added value: +{
      +  "default": "ko",
      +  "description": "Output language. 'en': English keys and labels, official English texts where available (tax treaties, statutes), titles/summaries machine-translated by Upstage Solar when UPSTAGE_API_KEY is set. 기본 'ko'",
      +  "enum": [
      +    "ko",
      +    "en"
      +  ],
      +  "title": "Lang",
      +  "type": "string"
      +}
    • addedInput schema / properties / law_name / description
      Added value: +"법령 정식 명칭. 예: '법인세법', '법인세법 시행령', '법인세법 시행규칙'"
    • addedInput schema / properties / with_delegation / description
      Added value: +"True면 법률 조문에 연결된 시행령·시행규칙 위임 조문 전부(3단)"
    • addedInput schema / properties / with_rules / description
      Added value: +"True면 그 조의 기본통칙 전문과 집행기준 항목도 함께"
  7. First observedv0.1.1

TDQS

A4.4/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Goes well past the readOnly/idempotent annotations: it discloses the LAW_OC environment-variable requirement and the error path when it is absent, a ~45-second time budget with partial-result behavior, automatic fallback to administrative rules (외국환거래규정·국세청 고시) with historical versions when as_of is given, and the 4,000-character truncation rule for long articles. The main remaining gap is rate-limit or retry behavior against the 법제처 API, which is not mentioned.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Front-loaded with a one-sentence English purpose statement, then organized by labeled sections (언제 / 별표 / 반환 / 예산) so an agent can skim to the needed part. It is dense and long, and the as_of guidance is duplicated between the description and the schema, which costs it a point.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With no output schema, the description fully carries the return contract, enumerating the 본문/링크/연결/읽기 주의/기준일 안내 fields and the alternative 위임체계 shape for the three-tier chain. Auth requirements, the partial-result failure mode, and the long-article narrowing strategy are all covered, leaving nothing an agent needs in order to call it correctly.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100% and the description largely restates what the per-parameter descriptions already say (as_of fiscal-period guidance, 별표 forms, paragraph ranges, the 4,000-character keyword threshold). It adds some cross-parameter meaning — notably that article='별표' returns a list rather than text, and that the '연결' field is meant to feed follow-up calls — but the net addition beyond the schema is modest.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

"Get statute text as in force on a date, with optional Act → Decree → Rule chain" states a specific verb, resource, and temporal scope in one line. It also separates itself from siblings by naming find_article for article-number discovery and by distinguishing statute text from 해석·판례 tools, which it says are keyed to the reply date rather than the applicable year.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The "언제" line gives an explicit trigger (assessing tax amount/requirements at the time the facts occurred), and the as_of paragraph tells the agent exactly which date to supply for 사업연도·귀속연도·과세기간 facts, including the default when omitted. It also routes the agent to find_article first when the article number is unknown, and states the keyword/paragraph fallback when neither is supplied.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.