Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| LAW_OC | No | Your law.go.kr OC identifier (user ID) required for API access. Get your key from open.law.go.kr | test |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| 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 - "HTML" or "XML" (default "XML", JSON not supported by API) 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") |
| 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 - "HTML" or "XML" (default "XML", JSON not supported by API) 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 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 - "HTML" or "XML" (default "XML", JSON not supported by API) Returns: Full law content or specific article content Examples: Retrieve specific article (RECOMMENDED): >>> eflaw_service(mst="279823", jo="017400", type="XML") # 자본시장법 제174조 |
| 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 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 - "HTML" or "XML" (default "XML", JSON not supported by API) Returns: Full law content or specific article content Examples: Retrieve specific article (RECOMMENDED): >>> law_service(mst="279823", jo="017400", type="XML") # 자본시장법 제174조 |
| 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 - "HTML" or "XML" (default "XML", JSON not supported by API) Returns: Specific law section content Examples: Query 자본시장법 제174조: >>> eflaw_josub(mst="279823", jo="017400", 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 - "HTML" or "XML" (default "XML", JSON not supported by API) Returns: Specific law section content Examples: Query 자본시장법 제174조: >>> law_josub(mst="279823", jo="017400", 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 - "HTML" or "XML" (default "XML", JSON not supported by API) 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") |
| 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 - "HTML" or "XML" (default "XML", JSON not supported by API) ctx: MCP context (injected automatically) Returns: Full English law text with articles or error Examples: Retrieve by ID: >>> elaw_service(id="000744", 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 - "HTML" or "XML" (default "XML", JSON not supported by API) 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") |
| 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 - "HTML" or "XML" (default "XML", JSON not supported by API) 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") |
| 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 - "HTML" or "XML" (default "XML", JSON not supported by API) 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 - "HTML" or "XML" (default "XML", JSON not supported by API) 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") |
| 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 - "HTML" or "XML" (default "XML", JSON not supported by API) 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 - "XML" only (JSON not supported by API, HTML not available) 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 - "HTML" or "XML" (default "XML") 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) |
| prec_service | Retrieve court precedent full text (판례 본문 조회). Args: id: Precedent sequence number (판례일련번호) lm: Precedent name (optional) oc: Optional OC override type: Response format - "HTML" or "XML" (default "XML") Returns: Full precedent text with details or error Examples: >>> prec_service(id="228541") |
| 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 - "HTML" or "XML" (default "XML") 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) |
| detc_service | Retrieve Constitutional Court decision full text (헌재결정례 본문 조회). Args: id: Constitutional Court decision sequence number (헌재결정례일련번호) lm: Decision name (optional) oc: Optional OC override type: Response format - "HTML" or "XML" (default "XML") Returns: Full Constitutional Court decision text or error Examples: >>> detc_service(id="58386") |
| 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 - "HTML" or "XML" (default "XML", JSON not supported by API) 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") |
| 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) oc: Optional OC override (defaults to env var) type: Response format - "HTML" or "XML" (default "XML", JSON not supported by API) 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") |
| 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 - "HTML" or "XML" (default "XML", JSON not supported by API) 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") |
| 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) oc: Optional OC override (defaults to env var) type: Response format - "HTML" or "XML" (default "XML", JSON not supported by API) 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") |
| 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:
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 ... ) 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 - XML only (JSON not supported) 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 - XML only (JSON not supported) Returns: List of semantically related law articles (법령조문 items) Example: >>> aiRltLs_search(query="민법") # Returns: 상법 제54조 (상사법정이율), 의료법 제50조 (「민법」의 준용), etc. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| search-korean-law | Search for a Korean law by name or keyword and provide a summary |
| get-law-article | Retrieve and explain a specific article from a Korean law |
| get-article-with-citations | Retrieve a law article AND all its citations (referenced laws) |
| analyze-law-citations | Search a law and automatically analyze citations for specified articles |
| search-admin-rules | Search Korean administrative rules (행정규칙) by keyword |
| tool-selection-guide | Guidance on which search tool to use based on query clarity |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| frequently-used-laws | Cached mapping of frequently-used Korean law names to their stable 법령ID codes. Use these IDs directly with eflaw_service, law_service, etc. to skip the search step. |