eflaw_search
Search current laws by effective date (시행일 기준 현행법령 검색).
This tool searches Korean laws organized by effective date.
Use this when you need to find laws that are currently in effect.
Args:
query: Search keyword (law name or content)
display: Number of results per page (max 100, default 20). **Recommend 50-100 for law searches (법령 검색) to ensure exact matches are found.**
page: Page number (1-based, default 1)
oc: Optional OC override (defaults to env var)
type: Response format - "JSON" (default), "XML", or "HTML"
sort: Sort order - "lasc"|"ldes"|"dasc"|"ddes"|"nasc"|"ndes"|"efasc"|"efdes"
ef_yd: Effective date range (YYYYMMDD~YYYYMMDD, e.g., "20240101~20241231")
org: Ministry/department code filter
knd: Law type filter
Returns:
Search results with law list or error
Examples:
Search for "자동차관리법":
>>> eflaw_search(query="자동차관리법", display=10, type="JSON")
Search with date range:
>>> eflaw_search(
... query="자동차",
... ef_yd="20240101~20241231",
... type="JSON"
... )
law_search
Search current laws by announcement date (공포일 기준 현행법령 검색).
This tool searches Korean laws organized by announcement (publication) date.
Args:
query: Search keyword (law name or content)
display: Number of results per page (max 100, default 20). **Recommend 50-100 for law searches (법령 검색) to ensure exact matches are found.**
page: Page number (1-based, default 1)
oc: Optional OC override (defaults to env var)
type: Response format - "JSON" (default), "XML", or "HTML"
sort: Sort order
date: Announcement date (YYYYMMDD)
org: Ministry/department code filter
knd: Law type filter
Returns:
Search results with law list or error
eflaw_service
Retrieve full law content by effective date (시행일 기준 법령 본문 조회).
Retrieves the complete text of a law organized by effective date.
**IMPORTANT: For specific article queries (e.g., "제174조"), ALWAYS use the `jo` parameter.
Some laws (e.g., 자본시장법) have 400+ articles and the full response can exceed 1MB.
Using `jo` returns only the requested article, which is much faster and cleaner.**
Args:
id: Law ID (either id or mst is required)
mst: Law serial number (MST/lsi_seq)
ef_yd: Effective date (YYYYMMDD) - required when using mst
jo: **REQUIRED for specific articles.** Article number in XXXXXX format.
Format: first 4 digits = article number (zero-padded), last 2 digits = branch suffix (00=main).
Examples: "017400" (제174조), "017200" (제172조), "000300" (제3조), "001502" (제15조의2)
chr_cls_cd: Language code - "010202" (Korean, default) or "010201" (Original)
oc: Optional OC override (defaults to env var)
type: Response format - "JSON" (default), "XML", or "HTML"
Returns:
Full law content or specific article content
Examples:
Retrieve specific article (RECOMMENDED):
>>> eflaw_service(mst="279823", jo="017400", type="XML") # 자본시장법 제174조
Retrieve full law (WARNING: large response for some laws):
>>> eflaw_service(id="1747", type="XML")
law_service
Retrieve full law content by announcement date (공포일 기준 법령 본문 조회).
Retrieves the complete text of a law organized by announcement (publication) date.
**IMPORTANT: For specific article queries (e.g., "제174조"), ALWAYS use the `jo` parameter.
Some laws (e.g., 자본시장법) have 400+ articles and the full response can exceed 1MB.
Using `jo` returns only the requested article, which is much faster and cleaner.**
Args:
id: Law ID (either id or mst is required)
mst: Law serial number (MST)
lm: Law modification parameter
ld: Law date parameter (YYYYMMDD)
ln: Law number parameter
jo: **REQUIRED for specific articles.** Article number in XXXXXX format.
Format: first 4 digits = article number (zero-padded), last 2 digits = branch suffix (00=main).
Examples: "017400" (제174조), "017200" (제172조), "000300" (제3조), "001502" (제15조의2)
lang: Language - "KO" (Korean) or "ORI" (Original)
oc: Optional OC override (defaults to env var)
type: Response format - "JSON" (default), "XML", or "HTML"
Returns:
Full law content or specific article content
Examples:
Retrieve specific article (RECOMMENDED):
>>> law_service(mst="279823", jo="017400", type="XML") # 자본시장법 제174조
Retrieve full law (WARNING: large response for some laws):
>>> law_service(id="009682", type="XML")
eflaw_josub
Query specific article/paragraph by effective date (시행일 기준 조·항·호·목 조회).
**BEST TOOL for querying specific articles like "제174조", "제3조" etc.**
This returns only the requested article/paragraph, avoiding large full-law responses.
Args:
id: Law ID (either id or mst is required)
mst: Law serial number (MST)
ef_yd: Effective date (YYYYMMDD) - required when using mst
jo: Article number in XXXXXX format.
Format: first 4 digits = article number (zero-padded), last 2 digits = branch suffix (00=main).
Examples: "017400" (제174조), "017200" (제172조), "000300" (제3조), "001502" (제15조의2)
hang: Paragraph number (6 digits, e.g., "000100" for 제1항)
ho: Item number (6 digits, e.g., "000200" for 제2호)
mok: Subitem (UTF-8 encoded, e.g., "다" for 다목)
oc: Optional OC override (defaults to env var)
type: Response format - "JSON" (default), "XML", or "HTML"
Returns:
Specific law section content
Examples:
Query 자본시장법 제174조:
>>> eflaw_josub(mst="279823", jo="017400", type="XML")
Query 건축법 제3조 제1항:
>>> eflaw_josub(mst="276925", jo="000300", hang="000100", type="XML")
law_josub
Query specific article/paragraph by announcement date (공포일 기준 조·항·호·목 조회).
**BEST TOOL for querying specific articles like "제174조", "제3조" etc.**
This returns only the requested article/paragraph, avoiding large full-law responses.
Args:
id: Law ID (either id or mst is required)
mst: Law serial number (MST)
jo: Article number in XXXXXX format.
Format: first 4 digits = article number (zero-padded), last 2 digits = branch suffix (00=main).
Examples: "017400" (제174조), "017200" (제172조), "000300" (제3조), "001502" (제15조의2)
hang: Paragraph number (6 digits, e.g., "000100" for 제1항)
ho: Item number (6 digits, e.g., "000200" for 제2호)
mok: Subitem (UTF-8 encoded, e.g., "다" for 다목)
oc: Optional OC override (defaults to env var)
type: Response format - "JSON" (default), "XML", or "HTML"
Returns:
Specific law section content
Examples:
Query 자본시장법 제174조:
>>> law_josub(mst="279823", jo="017400", type="XML")
Query 건축법 제3조 제1항:
>>> law_josub(mst="276925", jo="000300", hang="000100", type="XML")
elaw_search
Search English-translated Korean laws (영문법령 목록 조회).
This tool searches Korean laws that have been translated to English.
Useful for international users or bilingual legal research.
Args:
query: Search keyword (Korean or English, default "*")
display: Number of results per page (max 100, default 20). **Recommend 50-100 for law searches (법령 검색) to ensure exact matches are found.**
page: Page number (1-based, default 1)
oc: Optional OC override (defaults to env var)
type: Response format - "JSON" (default), "XML", or "HTML"
sort: Sort order - "lasc"|"ldes"|"dasc"|"ddes"|"nasc"|"ndes"|"efasc"|"efdes"
ef_yd: Effective date range (YYYYMMDD~YYYYMMDD)
org: Ministry/department code filter
knd: Law type filter
ctx: MCP context (injected automatically)
Returns:
Search results with English law list or error
Examples:
Search for "insurance":
>>> elaw_search(query="insurance", display=10, type="XML")
Search for "가정폭력방지":
>>> elaw_search(query="가정폭력방지", type="XML")
elaw_service
Retrieve English law full text (영문법령 본문 조회).
This tool retrieves the complete text of Korean laws translated to English.
Useful for international legal research and cross-border understanding.
Args:
id: Law ID (required if mst not provided)
mst: Law master number (required if id not provided)
lm: Law name (alternative search method)
ld: Announcement date (YYYYMMDD)
ln: Announcement number
oc: Optional OC override (defaults to env var)
type: Response format - "JSON" (default), "XML", or "HTML"
ctx: MCP context (injected automatically)
Returns:
Full English law text with articles or error
Examples:
Retrieve by ID:
>>> elaw_service(id="000744", type="XML")
Retrieve by MST:
>>> elaw_service(mst="127280", type="XML")
admrul_search
Search administrative rules (행정규칙 목록 조회).
This tool searches Korean administrative rules including 훈령, 예규, 고시, 공고, 지침, etc.
Administrative rules are detailed regulations issued by government agencies.
Args:
query: Search keyword (default "*")
display: Number of results per page (max 100, default 20). **Recommend 50-100 for law searches (법령 검색) to ensure exact matches are found.**
page: Page number (1-based, default 1)
oc: Optional OC override (defaults to env var)
type: Response format - "JSON" (default), "XML", or "HTML"
nw: 1=현행 (current), 2=연혁 (historical), default 1
search: 1=규칙명 (rule name), 2=본문검색 (full text), default 1
org: Ministry/department code filter
knd: Rule type - 1=훈령, 2=예규, 3=고시, 4=공고, 5=지침, 6=기타
date: Promulgation date (YYYYMMDD)
prml_yd: Promulgation date range (YYYYMMDD~YYYYMMDD)
mod_yd: Modification date range (YYYYMMDD~YYYYMMDD)
sort: Sort order
ctx: MCP context (injected automatically)
Returns:
Search results with administrative rules list or error
Examples:
Search for "학교":
>>> admrul_search(query="학교", display=10, type="XML")
Search by date:
>>> admrul_search(date=20250501, type="XML")
admrul_service
Retrieve administrative rule full text (행정규칙 본문 조회).
This tool retrieves the complete text of Korean administrative rules.
Includes rule content, addenda, and annexes (forms/attachments).
Args:
id: Rule sequence number (required if lid/lm not provided)
lid: Rule ID (alternative to id)
lm: Rule name (exact match search)
oc: Optional OC override (defaults to env var)
type: Response format - "JSON" (default), "XML", or "HTML"
ctx: MCP context (injected automatically)
Returns:
Full administrative rule text with content and annexes or error
Examples:
Retrieve by ID:
>>> admrul_service(id="62505", type="XML")
Retrieve by LID:
>>> admrul_service(lid="10000005747", type="XML")
lnkLs_search
Search laws linked to local ordinances (법령-자치법규 연계 목록 조회).
This tool searches Korean laws that have linkages to local ordinances.
Useful for understanding how national laws relate to local regulations.
Args:
query: Search keyword (default "*")
display: Number of results per page (max 100, default 20). **Recommend 50-100 for law searches (법령 검색) to ensure exact matches are found.**
page: Page number (1-based, default 1)
oc: Optional OC override (defaults to env var)
type: Response format - "JSON" (default), "XML", or "HTML"
sort: Sort order - "lasc"|"ldes"|"dasc"|"ddes"|"nasc"|"ndes"
ctx: MCP context (injected automatically)
Returns:
Search results with linked laws list or error
Examples:
Search for "자동차관리법":
>>> lnkLs_search(query="자동차관리법", type="XML")
lnkLsOrdJo_search
Search ordinance articles linked to law articles (연계 법령별 조례 조문 목록 조회).
This tool searches local ordinance articles that are linked to specific
national law articles. Shows which local ordinances implement or relate
to specific law provisions.
Args:
query: Search keyword (default "*")
display: Number of results per page (max 100, default 20). **Recommend 50-100 for law searches (법령 검색) to ensure exact matches are found.**
page: Page number (1-based, default 1)
oc: Optional OC override (defaults to env var)
type: Response format - "JSON" (default), "XML", or "HTML"
knd: Law type code (to filter by specific law)
jo: Article number (4 digits, zero-padded). Examples: "0002" (Article 2), "0020" (Article 20), "0100" (Article 100)
jobr: Branch article suffix (2 digits, zero-padded). Examples: "00" (main article), "02" (Article X-2)
sort: Sort order
ctx: MCP context (injected automatically)
Returns:
Search results with linked ordinance articles or error
Examples:
Search ordinances linked to 건축법 시행령:
>>> lnkLsOrdJo_search(knd="002118", type="XML")
Search specific article (제20조):
>>> lnkLsOrdJo_search(knd="002118", jo=20, type="XML")
lnkDep_search
Search law-ordinance links by ministry (연계 법령 소관부처별 목록 조회).
This tool searches local ordinances linked to laws managed by a specific
government ministry or department.
Args:
org: Ministry/department code (required, e.g., "1400000")
display: Number of results per page (max 100, default 20). **Recommend 50-100 for law searches (법령 검색) to ensure exact matches are found.**
page: Page number (1-based, default 1)
oc: Optional OC override (defaults to env var)
type: Response format - "JSON" (default), "XML", or "HTML"
sort: Sort order
ctx: MCP context (injected automatically)
Returns:
Search results with ministry's linked ordinances or error
Examples:
Search ordinances linked to ministry 1400000:
>>> lnkDep_search(org="1400000", type="XML")
drlaw_search
Retrieve law-ordinance linkage statistics (법령-자치법규 연계현황 조회).
This tool retrieves statistical information about how national laws
are linked to local ordinances. Returns HTML visualization/dashboard.
⚠️ Note: This API only supports HTML output format (no XML/JSON).
Response schema is not documented by the API provider.
Args:
oc: Optional OC override (defaults to env var)
ctx: MCP context (injected automatically)
Returns:
HTML response with linkage statistics or error
Examples:
Get linkage statistics:
>>> drlaw_search()
lsDelegated_service
Retrieve delegated laws/rules/ordinances (위임 법령 조회).
This tool retrieves information about laws, administrative rules, and
local ordinances that are delegated by a parent law. Shows the delegation
hierarchy and which specific articles delegate authority.
⚠️ Note: This API does NOT support HTML format (only XML/JSON).
Args:
id: Law ID (required if mst not provided)
mst: Law master number (required if id not provided)
oc: Optional OC override (defaults to env var)
type: Response format - "JSON" (default) or "XML" (HTML not available for this endpoint)
ctx: MCP context (injected automatically)
Returns:
Delegation hierarchy with delegated laws/rules/ordinances or error
Examples:
Retrieve delegations for 초·중등교육법:
>>> lsDelegated_service(id="000900", type="XML")
prec_search
Search court precedents (판례 목록 조회).
Search Korean court precedents from Supreme Court and lower courts.
Args:
query: Search keyword (default "*" for all)
display: Number of results per page (max 100, default 20)
page: Page number (1-based, default 1)
oc: Optional OC override (defaults to env var)
type: Response format - "JSON" (default), "XML", or "HTML"
search: Search type (1=case name, 2=full text, default 1)
sort: Sort order - "lasc"|"ldes"|"dasc"|"ddes"|"nasc"|"ndes"
org: Court type code (400201=Supreme Court, 400202=lower courts)
curt: Court name (대법원, 서울고등법원, etc.)
jo: Referenced law name (형법, 민법, etc.)
gana: Dictionary search (ga, na, da, ...)
date: Decision date (YYYYMMDD)
prnc_yd: Decision date range (YYYYMMDD~YYYYMMDD)
nb: Case number (comma-separated for multiple)
dat_src_nm: Data source name (국세법령정보시스템, 근로복지공단산재판례, 대법원)
pop_yn: Popup flag ("Y" or "N")
Returns:
Search results with precedent list or error
Examples:
Search for precedents mentioning "담보권":
>>> prec_search(query="담보권", display=10)
Search Supreme Court precedents:
>>> prec_search(query="담보권", curt="대법원")
prec_service
Retrieve court precedent full text (판례 본문 조회).
Args:
id: Precedent sequence number (판례일련번호)
lm: Precedent name (optional)
sections: Response detail level:
- "summary": Returns 판시사항, 판결요지, 참조조문, 참조판례 only (~5KB).
Excludes 판례내용 (full judgment text, often 15-25KB).
**Recommended for PlayMCP** to stay under 20KB limit.
- "full" or None: Returns everything including 판례내용 (default).
oc: Optional OC override
type: Response format - "JSON" (default), "XML", or "HTML"
Returns:
Full precedent text with details or error
Examples:
>>> prec_service(id="228541")
>>> prec_service(id="228541", sections="summary") # PlayMCP-safe
detc_search
Search Constitutional Court decisions (헌재결정례 목록 조회).
Search Korean Constitutional Court decisions.
Args:
query: Search keyword (default "*" for all)
display: Number of results per page (max 100, default 20)
page: Page number (1-based, default 1)
oc: Optional OC override (defaults to env var)
type: Response format - "JSON" (default), "XML", or "HTML"
search: Search type (1=decision name, 2=full text, default 1)
gana: Dictionary search (ga, na, da, ...)
sort: Sort order - "lasc"|"ldes"|"dasc"|"ddes"|"nasc"|"ndes"|"efasc"|"efdes"
date: Final date (YYYYMMDD)
ed_yd: Final date range (YYYYMMDD~YYYYMMDD)
nb: Case number
pop_yn: Popup flag ("Y" or "N")
Returns:
Search results with Constitutional Court decision list or error
Examples:
Search for decisions mentioning "벌금":
>>> detc_search(query="벌금", display=10)
Search by date:
>>> detc_search(date=20150210)
detc_service
Retrieve Constitutional Court decision full text (헌재결정례 본문 조회).
Args:
id: Constitutional Court decision sequence number (헌재결정례일련번호)
lm: Decision name (optional)
sections: "summary" to exclude 전문 (full text), or "full"/None for everything.
**Recommended: "summary" for PlayMCP** to stay under 20KB.
oc: Optional OC override
type: Response format - "JSON" (default), "XML", or "HTML"
Returns:
Full Constitutional Court decision text or error
Examples:
>>> detc_service(id="58386")
>>> detc_service(id="58386", sections="summary")
expc_search
Search legal interpretations (법령해석례 목록 조회).
This tool searches Korean legal interpretation precedents issued by government
agencies in response to inquiries about how to interpret specific laws.
Args:
query: Search keyword (default "*")
display: Number of results per page (max 100, default 20). **Recommend 50-100 for searches to ensure exact matches are found.**
page: Page number (1-based, default 1)
oc: Optional OC override (defaults to env var)
type: Response format - "JSON" (default), "XML", or "HTML"
search: 1=법령해석례명 (interpretation name, default), 2=본문검색 (full text)
inq: Inquiry organization name
rpl: Reply organization code
gana: Dictionary-style search (ga, na, da, ...)
itmno: Item number (e.g., 13-0217 → 130217)
reg_yd: Registration date range (YYYYMMDD~YYYYMMDD)
expl_yd: Interpretation date range (YYYYMMDD~YYYYMMDD)
sort: Sort order - "lasc"|"ldes"|"dasc"|"ddes"|"nasc"|"ndes"
pop_yn: Popup mode - "Y" or "N"
ctx: MCP context (injected automatically)
Returns:
Search results with legal interpretations list or error
Examples:
Search for "임차":
>>> expc_search(query="임차", display=10, type="XML")
Search by date range:
>>> expc_search(query="자동차", expl_yd="20240101~20241231", type="XML")
expc_service
Retrieve legal interpretation full text (법령해석례 본문 조회).
This tool retrieves the complete text of a legal interpretation precedent,
including the question summary, answer, and reasoning.
Args:
id: Legal interpretation sequence number (required)
lm: Legal interpretation name (optional)
sections: "summary" to exclude 이유 (detailed reasoning), or "full"/None for everything.
Returns 안건명, 질의요지, 회답 in summary mode (~2KB vs ~5KB full).
oc: Optional OC override (defaults to env var)
type: Response format - "JSON" (default), "XML", or "HTML"
ctx: MCP context (injected automatically)
Returns:
Full legal interpretation text with question, answer, and reasoning or error
Examples:
Retrieve by ID:
>>> expc_service(id="334617", type="XML")
Retrieve with name:
>>> expc_service(id="315191", lm="여성가족부 - 건강가정기본법 제35조 제2항 관련", type="XML")
decc_search
Search administrative appeal decisions (행정심판례 목록 조회).
This tool searches Korean administrative appeal decisions.
Administrative appeals are decisions made by administrative tribunals
on appeals against government agency dispositions.
Args:
query: Search keyword (default "*")
display: Number of results per page (max 100, default 20)
page: Page number (1-based, default 1)
oc: Optional OC override (defaults to env var)
type: Response format - "JSON" (default), "XML", or "HTML"
search: 1=사건명 (case name, default), 2=본문검색 (full text)
cls: Decision type filter (재결구분코드)
gana: Dictionary search (ga, na, da, ...)
date: Decision date (YYYYMMDD)
dpa_yd: Disposition date range (YYYYMMDD~YYYYMMDD)
rsl_yd: Decision date range (YYYYMMDD~YYYYMMDD)
sort: Sort order - "lasc"|"ldes"|"dasc"|"ddes"|"nasc"|"ndes"
pop_yn: Popup flag - "Y" or "N"
ctx: MCP context (injected automatically)
Returns:
Search results with administrative appeal decisions list or error
Examples:
Search for all decisions:
>>> decc_search(type="XML")
Search by keyword:
>>> decc_search(query="과징금", display=10, type="XML")
Search by date range:
>>> decc_search(rsl_yd="20200101~20201231", type="XML")
decc_service
Retrieve administrative appeal decision full text (행정심판례 본문 조회).
This tool retrieves the complete text of Korean administrative appeal decisions.
Includes case details, disposition information, decision summary, and reasoning.
Args:
id: Decision sequence number (required)
lm: Decision name (optional)
sections: "summary" to exclude 이유 (detailed reasoning), or "full"/None for everything.
Returns 사건명, 청구취지, 재결요지, 주문 in summary mode.
oc: Optional OC override (defaults to env var)
type: Response format - "JSON" (default), "XML", or "HTML"
ctx: MCP context (injected automatically)
Returns:
Full administrative appeal decision text with details or error
Examples:
Retrieve by ID:
>>> decc_service(id="243263", type="XML")
Retrieve with case name:
>>> decc_service(id="245011", lm="과징금 부과처분 취소청구", type="XML")
article_citation
Extract citations from a law article (조문 인용 조회).
This tool extracts all legal citations referenced by a specific law article.
It parses the official hyperlinked citations from law.go.kr HTML pages,
providing 100% accurate citation data with zero API cost.
The tool identifies:
- External citations (references to other laws)
- Internal citations (references within the same law)
- Article, paragraph, and item level references
Args:
mst: Law MST code (법령일련번호) - get this from eflaw_search or law_search results
law_name: Law name in Korean (e.g., "자본시장과 금융투자업에 관한 법률")
article: Article number (조번호, e.g., 3 for 제3조)
article_branch: Article branch number (조가지번호, e.g., 2 for 제37조의2, default 0)
oc: Optional OC override (defaults to env var)
Returns:
Citation extraction result with:
- success: Whether extraction succeeded
- law_id: MST code
- law_name: Law name
- article: Article display (e.g., "제3조" or "제37조의2")
- citation_count: Total number of citations found
- citations: List of citation objects with target law, article, paragraph, item
- internal_count: Number of same-law citations
- external_count: Number of other-law citations
Examples:
Get citations from 자본시장법 제3조:
>>> article_citation(
... mst="268611",
... law_name="자본시장과 금융투자업에 관한 법률",
... article=3
... )
Get citations from 건축법 제37조의2:
>>> article_citation(
... mst="270986",
... law_name="건축법",
... article=37,
... article_branch=2
... )
Workflow:
1. First use eflaw_search(query="법명") to find the law and get MST
2. Then use article_citation(mst=..., law_name=..., article=...) to get citations
3. Optionally use eflaw_service to get the full article text
aiSearch
⭐ PREFERRED TOOL for vague or natural language queries.
Use this FIRST when user's intent is unclear or conversational.
지능형 법령검색 시스템 검색 API (AI-powered semantic law search).
Uses intelligent/semantic search to find relevant law articles.
Returns FULL ARTICLE TEXT (조문내용) - more comprehensive than eflaw_search.
Best for: Natural language queries like "뺑소니 처벌", "음주운전 벌금"
Args:
query: Search query (natural language supported, e.g., "뺑소니 처벌")
search: Search scope:
- 0: 법령조문 (law articles, default)
- 1: 법령 별표·서식 (law appendix/forms)
- 2: 행정규칙 조문 (administrative rule articles)
- 3: 행정규칙 별표·서식 (administrative rule appendix/forms)
display: Results per page (default 20)
page: Page number (default 1)
oc: Optional OC override
type: Response format - "JSON" (default), "XML", or "HTML"
Returns:
AI search results with full article text (법령조문 items with 조문내용)
Example:
>>> aiSearch(query="뺑소니 처벌", search=0)
# Returns: 특정범죄 가중처벌 등에 관한 법률 제5조의3 (도주차량 운전자의 가중처벌)
aiRltLs_search
⭐ PREFERRED TOOL for discovering related laws from vague topics.
Use this when user wants to explore laws around a general subject.
지능형 법령검색 시스템 연관법령 API (AI-powered related laws search).
Finds laws semantically related to a given law name or keyword.
Best for: Finding related laws like "민법" → 상법, 의료법, 소송촉진법
Args:
query: Law name or keyword to find related laws (e.g., "민법", "형법")
search: Search scope:
- 0: 법령조문 (law articles, default)
- 1: 행정규칙조문 (administrative rule articles)
oc: Optional OC override
type: Response format - "JSON" (default), "XML", or "HTML"
Returns:
List of semantically related law articles (법령조문 items)
Example:
>>> aiRltLs_search(query="민법")
# Returns: 상법 제54조 (상사법정이율), 의료법 제50조 (「민법」의 준용), etc.
ordin_search
Search local ordinances (자치법규 목록 조회).
This tool searches Korean local ordinances (자치법규) including 조례, 규칙, and
other local government regulations.
Args:
query: Search keyword (default "*")
display: Number of results per page (max 100, default 20)
page: Page number (1-based, default 1)
oc: Optional OC override (defaults to env var)
type: Response format - "JSON" (default), "XML", or "HTML"
nw: 1=현행 (current), 2=연혁 (historical), default 1
search: 1=자치법규명 (ordinance name), 2=본문검색 (full text), default 1
sort: Sort order - "lasc"|"ldes"|"dasc"|"ddes"|"nasc"|"ndes"
date: Announcement date (YYYYMMDD)
ef_yd: Effective date range (YYYYMMDD~YYYYMMDD)
anc_yd: Announcement date range (YYYYMMDD~YYYYMMDD)
anc_no: Announcement number
org: Local government code filter (e.g., "6110000" for Seoul)
sborg: Sub-organization code filter
knd: Ordinance type - 1=조례, 2=규칙, 3=교육규칙
rr_cls_cd: Administrative district classification code
ordin_fd: Ordinance field code
gana: Dictionary search (ga, na, da, ...)
ctx: MCP context (injected automatically)
Returns:
Search results with local ordinance list or error
Examples:
Search for "서울시 건축 조례":
>>> ordin_search(query="건축", org="6110000", knd="1")
Search current ordinances:
>>> ordin_search(query="주차장", display=20, type="XML")
ordin_service
Retrieve local ordinance full text (자치법규 본문 조회).
This tool retrieves the complete text of a Korean local ordinance.
Args:
id: Ordinance ID (either id or mst is required)
mst: Ordinance master number (either id or mst is required)
oc: Optional OC override (defaults to env var)
type: Response format - "JSON" (default), "XML", or "HTML"
ctx: MCP context (injected automatically)
Returns:
Full ordinance text or error
Examples:
Retrieve by ID:
>>> ordin_service(id="000001", type="XML")
Retrieve by MST:
>>> ordin_service(mst="123456", type="XML")
ordinLsCon_search
Search ordinance-to-law linkage (자치법규 기준 법령 연계 관련 목록 조회).
This tool searches national law articles that are referenced or linked
by local ordinances. Useful for finding the legal basis (상위 법령) that
a specific ordinance is based on.
Args:
query: Search keyword (default "*")
display: Number of results per page (max 100, default 20)
page: Page number (1-based, default 1)
oc: Optional OC override (defaults to env var)
type: Response format - "JSON" (default), "XML", or "HTML"
ctx: MCP context (injected automatically)
Returns:
Search results with ordinance-law linkage list or error
Examples:
Search for linked laws:
>>> ordinLsCon_search(query="건축", type="XML")
trty_search
Search international treaties (조약 목록 조회).
This tool searches Korean international treaties concluded and
in effect with foreign countries and international organizations.
Args:
query: Search keyword (default "*")
display: Number of results per page (max 100, default 20)
page: Page number (1-based, default 1)
oc: Optional OC override (defaults to env var)
type: Response format - "JSON" (default), "XML", or "HTML"
search: Search type (1=조약명, 2=본문검색)
sort: Sort order - "lasc"|"ldes"|"dasc"|"ddes"|"nasc"|"ndes"
gana: Dictionary search (ga, na, da, ...)
eft_yd: Effective date range (YYYYMMDD~YYYYMMDD)
conc_yd: Conclusion date range (YYYYMMDD~YYYYMMDD)
cls: Treaty type - 1=양자 (bilateral), 2=다자 (multilateral)
nat_cd: Country code filter
ctx: MCP context (injected automatically)
Returns:
Search results with treaty list or error
Examples:
Search bilateral treaties with the US:
>>> trty_search(query="미합중국", cls=1)
Search multilateral treaties:
>>> trty_search(cls=2, display=20)
trty_service
Retrieve treaty full text (조약 본문 조회).
This tool retrieves the complete text of a Korean international treaty.
Args:
id: Treaty sequence number (조약일련번호, required)
oc: Optional OC override (defaults to env var)
type: Response format - "JSON" (default), "XML", or "HTML"
ctx: MCP context (injected automatically)
Returns:
Full treaty text with details or error
Examples:
Retrieve a treaty by ID:
>>> trty_service(id="123")
lstrm_ai_search
Search legal terms using AI (법령용어 AI 조회).
This tool searches Korean legal terminology using AI-powered semantic
matching. Returns definitions and explanations of legal terms.
Args:
query: Search keyword (default "*")
display: Number of results per page (max 100, default 20)
page: Page number (1-based, default 1)
oc: Optional OC override (defaults to env var)
type: Response format - "JSON" (default), "XML", or "HTML"
ctx: MCP context (injected automatically)
Returns:
Search results or error
dlytrm_search
Search everyday terms (일상용어 조회).
This tool searches plain-language (everyday) terms and their legal
equivalents, helping bridge common language with formal legal terminology.
Args:
query: Search keyword (default "*")
display: Number of results per page (max 100, default 20)
page: Page number (1-based, default 1)
oc: Optional OC override (defaults to env var)
type: Response format - "JSON" (default), "XML", or "HTML"
ctx: MCP context (injected automatically)
Returns:
Search results or error
lstrm_rlt_search
Legal term to everyday term linkage (법령용어→일상용어 연계 조회).
This tool searches the linkage between formal legal terms and their
plain-language (everyday) equivalents. Useful for finding how legal
terminology maps to everyday Korean.
Args:
query: Search keyword (default "*")
display: Number of results per page (max 100, default 20)
page: Page number (1-based, default 1)
oc: Optional OC override (defaults to env var)
type: Response format - "JSON" (default), "XML", or "HTML"
ctx: MCP context (injected automatically)
Returns:
Search results or error
dlytrm_rlt_search
Everyday term to legal term linkage (일상용어→법령용어 연계 조회).
This tool searches the linkage from plain-language (everyday) terms
back to their formal legal equivalents. Useful for finding the correct
legal terminology when starting from common language.
Args:
query: Search keyword (default "*")
display: Number of results per page (max 100, default 20)
page: Page number (1-based, default 1)
oc: Optional OC override (defaults to env var)
type: Response format - "JSON" (default), "XML", or "HTML"
ctx: MCP context (injected automatically)
Returns:
Search results or error
lstrm_rlt_jo_search
Legal term to article linkage (법령용어→조문 연계 조회).
This tool searches the linkage between legal terms and the specific
law articles where those terms are used or defined.
Args:
query: Search keyword (default "*")
display: Number of results per page (max 100, default 20)
page: Page number (1-based, default 1)
oc: Optional OC override (defaults to env var)
type: Response format - "JSON" (default), "XML", or "HTML"
ctx: MCP context (injected automatically)
Returns:
Search results or error
jo_rlt_lstrm_search
Article to legal term linkage (조문→법령용어 연계 조회).
This tool searches the linkage from specific law articles to the
legal terms defined or used within those articles. Useful for finding
all technical terms in a given article.
Args:
query: Search keyword (default "*")
display: Number of results per page (max 100, default 20)
page: Page number (1-based, default 1)
oc: Optional OC override (defaults to env var)
type: Response format - "JSON" (default), "XML", or "HTML"
ctx: MCP context (injected automatically)
Returns:
Search results or error
ls_rlt_search
Related law search (관련법령 조회).
This tool searches for laws related to a given query term. Part of the
법령정보 지식베이스, it identifies associations between laws based on
shared subject matter or cross-references.
Args:
query: Search keyword (default "*")
display: Number of results per page (max 100, default 20)
page: Page number (1-based, default 1)
oc: Optional OC override (defaults to env var)
type: Response format - "JSON" (default), "XML", or "HTML"
ctx: MCP context (injected automatically)
Returns:
Search results or error
committee_search
Search committee decisions (위원회 결정문 목록 조회).
Search decisions from Korean government committees.
Args:
committee: Committee name in Korean. Valid values:
개인정보보호위원회, 고용보험심사위원회, 공정거래위원회,
국민권익위원회, 금융위원회, 노동위원회, 방송미디어통신위원회,
산업재해보상보험재심사위원회, 중앙토지수용위원회,
중앙환경분쟁조정위원회, 증권선물위원회, 국가인권위원회
query: Search keyword (default "*")
display: Number of results per page (max 100, default 20)
page: Page number (1-based, default 1)
oc: Optional OC override (defaults to env var)
type: Response format - "JSON" (default), "XML", or "HTML"
search: 1=안건명 (case name), 2=본문검색 (full text)
sort: Sort order
gana: Dictionary search
ctx: MCP context (injected automatically)
Returns:
Committee decision list or error
Examples:
Search 공정거래위원회 decisions:
>>> committee_search(committee="공정거래위원회", query="담합")
committee_service
Retrieve committee decision full text (위원회 결정문 본문 조회).
Args:
committee: Committee name (same values as committee_search)
id: Decision serial number (결정문일련번호)
oc: Optional OC override
type: Response format - "JSON" (default), "XML", or "HTML"
ctx: MCP context (injected automatically)
Returns:
Full decision text or error
cgm_expc_search
Search ministry law interpretations (중앙부처 1차 해석 목록 조회).
Search law interpretation opinions from Korean central government ministries.
Args:
ministry: Ministry name in Korean. Valid values:
고용노동부, 국토교통부, 기획재정부, 해양수산부, 행정안전부,
기후에너지환경부, 관세청, 국세청, 교육부, 과학기술정보통신부,
국가보훈부, 국방부, 농림축산식품부, 문화체육관광부, 법무부,
보건복지부, 산업통상부, 성평등가족부, 외교부, 중소벤처기업부,
통일부, 법제처, 식품의약품안전처, 인사혁신처, 기상청,
국가유산청, 농촌진흥청, 경찰청, 방위사업청, 병무청, 산림청,
소방청, 재외동포청, 조달청, 질병관리청, 국가데이터처,
지식재산처, 해양경찰청, 행정중심복합도시건설청
query: Search keyword (default "*")
display: Number of results per page (max 100, default 20)
page: Page number (1-based, default 1)
oc: Optional OC override (defaults to env var)
type: Response format - "JSON" (default), "XML", or "HTML"
search: 1=사건명 (case name), 2=본문검색 (full text)
sort: Sort order
gana: Dictionary search
ctx: MCP context (injected automatically)
Returns:
Ministry interpretation list or error
Examples:
Search 고용노동부 interpretations:
>>> cgm_expc_search(ministry="고용노동부", query="퇴직금")
cgm_expc_service
Retrieve ministry interpretation full text (중앙부처 1차 해석 본문 조회).
Args:
ministry: Ministry name (same values as cgm_expc_search)
id: Interpretation serial number (해석례일련번호)
oc: Optional OC override
type: Response format - "JSON" (default), "XML", or "HTML"
ctx: MCP context (injected automatically)
Returns:
Full interpretation text or error
special_decc_search
Search special administrative appeal decisions (특별행정심판 목록 조회).
Search decisions from Korean special administrative appeal tribunals.
Args:
tribunal: Tribunal name in Korean. Valid values:
조세심판원, 해양안전심판원, 국민권익위원회,
인사혁신처 소청심사위원회
query: Search keyword (default "*")
display: Number of results per page (max 100, default 20)
page: Page number (1-based, default 1)
oc: Optional OC override (defaults to env var)
type: Response format - "JSON" (default), "XML", or "HTML"
search: 1=사건명 (case name), 2=본문검색 (full text)
sort: Sort order
gana: Dictionary search
cls: 재결례유형 (decision type classification)
date: Reference date (YYYYMMDD)
dpa_yd: Decision date range (YYYYMMDD~YYYYMMDD)
rsl_yd: Resolution date range (YYYYMMDD~YYYYMMDD)
ctx: MCP context (injected automatically)
Returns:
Special appeal decision list or error
Examples:
Search 조세심판원 decisions:
>>> special_decc_search(tribunal="조세심판원", query="부가가치세")
special_decc_service
Retrieve special administrative appeal decision full text (특별행정심판 본문 조회).
Args:
tribunal: Tribunal name (same values as special_decc_search)
id: Decision serial number (재결례일련번호)
oc: Optional OC override
type: Response format - "JSON" (default), "XML", or "HTML"
ctx: MCP context (injected automatically)
Returns:
Full decision text or error
check_precedent_odds
Find precedent statistics and key outcome factors for a legal question (판례 승률 분석).
Searches court precedents, analyzes outcomes (인용/기각/파기), and extracts
key factors that influenced decisions. Useful for assessing legal odds.
Args:
query: Legal question or keywords (e.g., "택배 파손 보상", "임대차 보증금 반환")
display: Number of precedents to search (max 100, default 20)
top_n: Number of top precedents to analyze in detail (default 5)
oc: Optional OC override
type: Response format - "JSON" (default), "XML", or "HTML"
Returns:
Outcome statistics, key factors, and representative case summaries
Examples:
>>> check_precedent_odds(query="택배 파손 보상")
>>> check_precedent_odds(query="부당해고", display=50, top_n=10)
legal_resolver
Find all applicable laws, precedents, and interpretations for a situation (법률 종합 분석).
Given a plain language description of a legal situation, this tool searches across
multiple legal databases in one call: law articles, court precedents, legal
interpretations, and citation networks.
Args:
situation: Plain language description (e.g., "직원이 고객 데이터를 USB에 담아갔다")
display: Results per sub-query (default 5)
oc: Optional OC override
type: Response format - "JSON" (default), "XML", or "HTML"
Returns:
Comprehensive legal analysis with applicable laws, precedents, interpretations, and citations
Examples:
>>> legal_resolver(situation="집주인이 보증금을 안 돌려줘요")
>>> legal_resolver(situation="회사에서 갑자기 해고당했어요", display=3)
simplify_article
Get a law article with legal terms replaced by everyday Korean (쉬운 법률 읽기).
Fetches a law article and annotates legal jargon with plain Korean equivalents
using the official 법제처 legal terminology database.
Args:
law_name: Law name (e.g., "민법", "근로기준법")
article: Article number (e.g., 750 for 제750조)
article_branch: Branch number (e.g., 2 for 제37조의2, default 0)
oc: Optional OC override
type: Response format - "JSON" (default), "XML", or "HTML"
Returns:
Original text, simplified text with inline annotations, and term glossary
Examples:
>>> simplify_article(law_name="민법", article=750)
>>> simplify_article(law_name="건축법", article=37, article_branch=2)
law_amendment_summary
List all revisions of a law within a date range (법령 개정 이력 조회).
Shows when and how a law was amended over time. Use the MST values from
the results with article_amendment_diff to see specific article changes.
Args:
law_name: Law name (e.g., "근로기준법")
date_from: Start date YYYYMMDD (default "20100101")
date_to: End date YYYYMMDD (default "20261231")
oc: Optional OC override
type: Response format - "JSON" (default), "XML", or "HTML"
Returns:
List of revisions with dates, types, and MST identifiers
Examples:
>>> law_amendment_summary(law_name="근로기준법", date_from="20200101")
>>> law_amendment_summary(law_name="민법", date_from="20150101", date_to="20251231")
article_amendment_diff
Compare how a specific article changed between two law versions (조문 신구대조).
Use MST values from law_amendment_summary to compare article text across revisions.
Args:
mst_old: MST of the older version (법령일련번호, from law_amendment_summary)
mst_new: MST of the newer version
article: Article number (e.g., 52 for 제52조)
article_branch: Branch number (e.g., 2 for 제52조의2, default 0)
oc: Optional OC override
type: Response format - "JSON" (default), "XML", or "HTML"
Returns:
Side-by-side comparison with line-level diff
Examples:
>>> article_amendment_diff(mst_old="269000", mst_new="273000", article=52)
chain_full_research
Complete legal research in one call (종합 법률 조사).
Chains: AI search → statutes → precedents with outcome analysis → interpretations → citations.
This is the most comprehensive single-call research tool.
Args:
query: Natural language query (e.g., "음주운전 처벌 기준", "임대차 보증금 반환")
display: Results per sub-query (default 5)
oc: Optional OC override
type: Response format
Returns:
Combined legal analysis with statutes, precedent statistics, interpretations, and citations
Examples:
>>> chain_full_research(query="부당해고 구제")
>>> chain_full_research(query="개인정보 유출 신고 의무")
chain_amendment_track
Track law amendment history with optional article-level diff (법령 개정 추적).
Chains: amendment summary → article diff between latest two versions.
If article=0, returns only the revision list. If article is specified,
also diffs that article between the two most recent revisions.
Args:
law_name: Law name (e.g., "근로기준법")
article: Article number to diff (0 = summary only, e.g., 52 for 제52조)
date_from: Start date YYYYMMDD (default "20200101")
date_to: End date YYYYMMDD (default "20261231")
oc: Optional OC override
type: Response format
Returns:
Revision history and optional article diff
Examples:
>>> chain_amendment_track(law_name="근로기준법")
>>> chain_amendment_track(law_name="근로기준법", article=52, date_from="20180101")
chain_dispute_prep
Prepare for a legal dispute by gathering all case law (분쟁 준비 자료).
Chains: precedent search + admin appeals + constitutional decisions + special tribunal.
Gathers all decision-type legal sources in one call.
Args:
query: Dispute topic (e.g., "부당해고", "개인정보 유출", "조세 부과 취소")
display: Results per category (default 5)
oc: Optional OC override
type: Response format
Returns:
Precedents, admin appeals, constitutional decisions, and special tribunal decisions
Examples:
>>> chain_dispute_prep(query="부당해고")
>>> chain_dispute_prep(query="개인정보 유출 과징금")
chain_law_system
Map the full law system hierarchy (법령 체계 조회).
Chains: law search → delegation tree → related admin rules → linked ordinances.
Shows how a law connects to its subordinate regulations.
Args:
law_name: Law name (e.g., "건축법", "근로기준법")
oc: Optional OC override
type: Response format
Returns:
Law hierarchy: parent law, delegated decrees/rules, linked ordinances
Examples:
>>> chain_law_system(law_name="건축법")
>>> chain_law_system(law_name="개인정보 보호법")
cache_stats
Show cache and resolver statistics (캐시 통계).
Returns current cache hit rate, entry count, and law name resolver stats.
Useful for monitoring server performance.
Returns:
Cache statistics and resolver stats