How do I use LexLink-ko-mcp?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@LexLink-ko-mcp Search for the English version of the Korean Commercial Act" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

LexLink-ko-mcp

by joohyukjung

Overview Schema Source Related Servers Discussions Admin

Python

Hybrid

🌐 Read this in other languages: English | 한국어 (Korean)

LexLink is an MCP (Model Context Protocol) server that exposes the Korean National Law Information API (open.law.go.kr) to AI agents and LLM applications. It enables AI systems to search, retrieve, and analyze Korean legal information through standardized MCP tools.

Features

54 MCP Tools + 2 MCP Resources for comprehensive Korean law information access
- Search and retrieve Korean laws (effective date & announcement date)
- Search and retrieve English-translated laws
- Search and retrieve administrative rules (행정규칙)
- Query specific articles, paragraphs, and sub-items
- Law-ordinance linkage (법령-자치법규 연계)
- Delegated law information (위임법령)
- Phase 3 - Case Law & Legal Research
  - Court precedents (판례)
  - Constitutional Court decisions (헌재결정례)
  - Legal interpretations (법령해석례)
  - Administrative appeal decisions (행정심판례)
- Phase 4 - Article Citation Extraction
  - Extract legal citations from any law article (100% accuracy)
- NEW: Phase 5 - AI-Powered Search
  - Semantic search for natural language queries (aiSearch)
  - Related laws discovery (aiRltLs_search)
- MCP Resources - Law ID Cache
  - Cached mapping of ~20 frequently-used law names to stable 법령ID codes
  - Template lookup by Korean name or abbreviation (lexlink://law/{name})
  - Dynamic caching: search results automatically populate the cache
Smart Features (inspired by korean-law-mcp):
- Intelligent Caching - Per-tool TTL caching (search 1hr, articles 24hr, AI search 30min)
- Law Name Resolution - Auto-resolves Korean abbreviations (자통법→자본시장과 금융투자업에 관한 법률), 52 seed aliases + dynamic learning
- Chain Tools - Multi-step research workflows in one call (Phase 9)
100% Semantic Validation - All Phase 1-5 tools confirmed returning real law data
Error Handling - Actionable error messages with resolution hints
Korean Text Support - Proper UTF-8 encoding for Korean characters
Response Formats - JSON (default), HTML, or XML (multiple formats supported)

Related MCP server: Legal Search MCP

Project Status

🎉 Production Ready - Phase 9 Complete!

Metric	Status
Tools Implemented	54/54 (100%) ✅
Semantic Validation	26/26 (Phase 1-5 tools) ✅
MCP Prompts	9/9 (100%) ✅
MCP Resources	2 (1 static + 1 template) ✅
API Coverage	~28% of 191+ endpoints
LLM Integration	✅ Validated (Gemini)
Code Quality	Clean, documented, tested
Version	v2.1.0

Latest: v2.1.0 — 54 tools (Phase 9 added), intelligent caching (cache.py), law name resolution (resolver.py), chain tools for multi-step research workflows.

Prerequisites

Python 3.10+
law.go.kr OC identifier: Register at open.law.go.kr

Quick Start

1. Install Dependencies

uv sync

2. Configure Your OC Identifier

Option A: Environment Variable (Recommended)

# Set OC in your environment
export OC=your_id_here

Option B: Pass in Tool Arguments

# Override OC in each tool call
eflaw_search(query="법령명", oc="your_id")

3. Run the Server

# Stdio transport (for Claude Code, Cursor, etc.)
OC=your_oc uv run stdio

# HTTP transport (for Kakao PlayMCP)
OC=your_oc TRANSPORT=http uv run serve

Available Tools

Phase 1: Core Law APIs (6 tools)

1. `eflaw_search` - Search Laws by Effective Date

Search for laws organized by effective date (시행일 기준).

eflaw_search(
    query="자동차관리법",      # Search keyword
    display=10,                # Results per page
    type="XML",                # Response format
    ef_yd="20240101~20241231"  # Optional date range
)

2. `law_search` - Search Laws by Announcement Date

Search for laws organized by announcement date (공포일 기준).

law_search(
    query="민법",
    display=10,
    type="XML"
)

3. `eflaw_service` - Retrieve Law Content (Effective Date)

Get full law text and articles by effective date.

IMPORTANT: For specific article queries (e.g., "제174조"), use the jo parameter. Some laws have 400+ articles and responses can exceed 1MB without jo.

# Get specific article (RECOMMENDED)
eflaw_service(
    mst="279823",              # Law MST
    jo="017400",               # Article 174 (제174조)
    type="XML"
)

# Get full law (WARNING: large response)
eflaw_service(
    id="001823",
    type="XML"
)

4. `law_service` - Retrieve Law Content (Announcement Date)

Get full law text and articles by announcement date.

IMPORTANT: For specific article queries (e.g., "제174조"), use the jo parameter. Some laws have 400+ articles and responses can exceed 1MB without jo.

# Get specific article (RECOMMENDED)
law_service(
    mst="279823",              # Law MST
    jo="017400",               # Article 174 (제174조)
    type="XML"
)

5. `eflaw_josub` - Query Article/Paragraph (Effective Date)

Best tool for querying specific articles. Returns only the requested article/paragraph.

eflaw_josub(
    mst="279823",              # Law MST
    jo="017400",               # Article 174 (제174조)
    type="XML"
)
# jo format: "XXXXXX" where first 4 digits = article (zero-padded), last 2 = branch (00=main)
# Examples: "017400" (제174조), "000300" (제3조), "001502" (제15조의2)

6. `law_josub` - Query Article/Paragraph (Announcement Date)

Best tool for querying specific articles. Returns only the requested article/paragraph.

law_josub(
    mst="279823",              # Law MST
    jo="017200",               # Article 172 (제172조)
    type="XML"
)

Phase 2: Extended APIs (9 tools)

7. `elaw_search` - Search English-Translated Laws

Search for Korean laws translated to English.

elaw_search(
    query="employment",
    display=10,
    type="XML"
)

8. `elaw_service` - Retrieve English Law Content

Get full English-translated law text.

elaw_service(
    id="009589",
    type="XML"
)

9. `admrul_search` - Search Administrative Rules

Search administrative rules (훈령, 예규, 고시, 공고, 지침).

admrul_search(
    query="학교",
    display=10,
    type="XML"
)

10. `admrul_service` - Retrieve Administrative Rule Content

Get full administrative rule text with annexes.

admrul_service(
    id="62505",
    type="XML"
)

11. `lnkLs_search` - Search Law-Ordinance Linkage

Find laws linked to local ordinances.

lnkLs_search(
    query="건축",
    display=10,
    type="XML"
)

12. `lnkLsOrdJo_search` - Search Ordinance Articles by Law

Find ordinance articles linked to specific law articles.

lnkLsOrdJo_search(
    knd="002118",              # Law ID
    display=10,
    type="XML"
)

13. `lnkDep_search` - Search Law-Ordinance Links by Ministry

Find laws linked to ordinances by government ministry.

lnkDep_search(
    org="1400000",             # Ministry code
    display=10,
    type="XML"
)

14. `drlaw_search` - Retrieve Law-Ordinance Linkage Statistics

Get linkage statistics table (HTML format).

drlaw_search(
    lid="001823",              # Law ID
    type="HTML"
)

15. `lsDelegated_service` - Retrieve Delegated Law Information

Get information about delegated laws, rules, and ordinances.

lsDelegated_service(
    id="001823",
    type="XML"
)

Phase 3: Case Law & Legal Research (8 tools - NEW!)

Tip: All *_service tools in Phase 3 support a sections="summary" parameter to return only a brief summary instead of the full document text.

16. `prec_search` - Search Court Precedents

Search Korean court precedents from Supreme Court and lower courts.

prec_search(
    query="담보권",
    display=10,
    type="XML",
    curt="대법원"             # Optional: Court name filter
)

17. `prec_service` - Retrieve Court Precedent Full Text

Get complete court precedent text with case details.

prec_service(
    id="228541",
    type="XML"
)

18. `detc_search` - Search Constitutional Court Decisions

Search Korean Constitutional Court decisions.

detc_search(
    query="벌금",
    display=10,
    type="XML"
)

19. `detc_service` - Retrieve Constitutional Court Decision Full Text

Get complete Constitutional Court decision text.

detc_service(
    id="58386",
    type="XML"
)

20. `expc_search` - Search Legal Interpretations

Search legal interpretation precedents issued by government agencies.

expc_search(
    query="임차",
    display=10,
    type="XML"
)

21. `expc_service` - Retrieve Legal Interpretation Full Text

Get complete legal interpretation text.

expc_service(
    id="334617",
    type="XML"
)

22. `decc_search` - Search Administrative Appeal Decisions

Search Korean administrative appeal decisions.

decc_search(
    query="*",                # Search all decisions
    display=10,
    type="XML"
)

23. `decc_service` - Retrieve Administrative Appeal Decision Full Text

Get complete administrative appeal decision text.

decc_service(
    id="243263",
    type="XML"
)

Phase 4: Article Citation Extraction (1 tool - NEW!)

24. `article_citation` - Extract Citations from Law Article

Extract all legal citations referenced by a specific law article.

# First, search for the law to get MST
eflaw_search(query="건축법")  # Returns MST: 268611

# Then extract citations
article_citation(
    mst="268611",              # Law MST from search result
    law_name="건축법",          # Law name
    article=3                  # Article number (제3조)
)

Response:

{
    "success": true,
    "law_name": "건축법",
    "article": "제3조",
    "citation_count": 12,
    "internal_count": 4,
    "external_count": 8,
    "citations": [
        {
            "type": "external",
            "target_law_name": "「국토의 계획 및 이용에 관한 법률」",
            "target_article": 56,
            "target_paragraph": 1
        }
    ]
}

Key Features:

100% accuracy via HTML parsing (not LLM-based)
Zero API cost (no external LLM calls)
~350ms average extraction time
Distinguishes internal vs external citations

Phase 5: AI-Powered Search (2 tools - NEW!)

25. `aiSearch` - AI-Powered Semantic Law Search

⭐ PREFERRED TOOL for vague or natural language queries. Use this FIRST when user's intent is unclear or conversational.

Uses intelligent/semantic search to find relevant law articles with full article text.

aiSearch(
    query="뺑소니 처벌",           # Natural language query
    search=0,                      # 0: law articles, 1: appendix, 2: admin rules, 3: admin appendix
    display=20,                    # Results per page
    page=1,                        # Page number
    type="JSON"                    # Response format (JSON default)
)

Best for: Natural language queries like "음주운전 벌금", "이혼 재산분할", "상속 문제"

26. `aiRltLs_search` - AI-Powered Related Laws Search

⭐ PREFERRED TOOL for discovering related laws from vague topics. Use this when user wants to explore laws around a general subject.

Finds laws semantically related to a given law name or keyword.

aiRltLs_search(
    query="민법",                  # Law name or keyword
    search=0,                      # 0: law articles, 1: admin rule articles
    type="JSON"                    # Response format (JSON default)
)

Best for: Finding related laws like "민법" → 상법, 의료법, 소송촉진법

Phase 7: Extended Legal Information (18 tools)

Category	Tools
자치법규 (Local Ordinances)	`ordin_search`, `ordin_service`, `ordinLsCon_search`
조약 (Treaties)	`trty_search`, `trty_service`
법령정보 지식베이스 (Knowledge Base)	`lstrm_ai_search`, `dlytrm_search`, `lstrm_rlt_search`, `dlytrm_rlt_search`, `lstrm_rlt_jo_search`, `jo_rlt_lstrm_search`, `ls_rlt_search`
위원회 결정문 (Committee Decisions)	`committee_search`, `committee_service`
중앙부처 1차 해석 (Ministry Interpretations)	`cgm_expc_search`, `cgm_expc_service`
특별행정심판 (Special Appeals)	`special_decc_search`, `special_decc_service`

Phase 9: Chain Tools (5 tools)

Inspired by korean-law-mcp, these tools run multi-step research workflows in a single call — eliminating the need for an LLM to orchestrate sequential tool calls manually.

Tool	Description
`chain_full_research`	Complete legal research: statutes + precedent analysis + interpretations
`chain_amendment_track`	Revision history + article-level diff across amendments
`chain_dispute_prep`	All case law sources across 4 databases (판례, 헌재결정례, 법령해석례, 행정심판례)
`chain_law_system`	Full law hierarchy: delegation tree + admin rules + ordinances
`cache_stats`	Cache and resolver performance monitoring

Tool Selection Guide

When searching Korean law, select tools based on query clarity:

Query Type	Recommended Tools	Examples
🔍 Vague/Natural language	`aiSearch`, `aiRltLs_search`	"음주운전 처벌", "이혼 재산분할"
📋 Specific law/article	`eflaw_search`, `law_search`	"형법 제148조의2", "민법 상속편"
⚖️ Case law	`prec_search`, `detc_search`	"대법원 2023다12345"
🔗 Related laws	`aiRltLs_search`	"민법과 관련된 법률"

Configuration

Environment Variables

Variable	Default	Description
`OC`	(required)	law.go.kr API identifier (email local part)
`LEXLINK_BASE_URL`	`http://www.law.go.kr`	API base URL
`LEXLINK_TIMEOUT`	`60`	HTTP request timeout in seconds
`SLIM_RESPONSE`	(unset)	Set `true` to remove redundant raw XML when parsed data exists (for PlayMCP)
`TRANSPORT`	`sse`	Transport type: `sse` or `http`

OC Priority

When resolving the OC identifier:

Tool argument (highest priority) - oc parameter in tool call
Environment variable - OC env var (set via .env or HTTP header middleware)

Usage Examples

Example 1: Basic Search

# Search for automobile management law
result = eflaw_search(
    query="자동차관리법",
    display=5,
    type="XML"
)

# Returns:
{
    "status": "ok",
    "request_id": "uuid",
    "upstream_type": "XML",
    "data": {
        # Law search results...
    }
}

Example 2: Search with Date Range

# Find laws effective in 2024
result = eflaw_search(
    query="교통",
    ef_yd="20240101~20241231",
    type="XML"
)

Example 3: Error Handling

# Missing OC parameter
result = eflaw_search(query="test")

# Returns helpful error:
{
    "status": "error",
    "error_code": "MISSING_OC",
    "message": "OC parameter is required but not provided.",
    "hints": [
        "1. Tool argument: oc='your_value'",
        "2. Environment variable: OC=your_value"
    ]
}

Golden MCP Tool Trajectories

These examples demonstrate real-world conversation flows showing how LLMs interact with LexLink tools to answer legal research questions.

Trajectory 1: Basic Law Research

User Query: "What is Article 20 of the Civil Code?"

Tool Calls:

law_search(query="민법", display=50, type="XML") → Find Civil Code ID
law_service(id="000021", jo="002000", type="XML") → Retrieve Article 20 text

Result: LLM provides formatted explanation of Civil Code Article 20 with full legal text and context.

Trajectory 2: Court Precedent Analysis

User Query: "Find recent Supreme Court precedents about security interests"

Tool Calls:

prec_search(query="담보권", curt="대법원", display=50, type="XML") → Search Supreme Court precedents
prec_service(id="228541", type="XML") → Retrieve top precedent details

Result: LLM summarizes key precedents with case numbers, dates, and holdings related to security interests.

Trajectory 3: Cross-Phase Legal Research

User Query: "How does the Labor Standards Act handle overtime, and are there relevant court precedents?"

Tool Calls:

eflaw_search(query="근로기준법", display=50, type="XML") → Find Labor Standards Act
eflaw_service(id="001234", jo="005000", type="XML") → Retrieve Article 50 (overtime provisions)
prec_search(query="근로기준법 연장근로", display=30, type="XML") → Search overtime precedents
prec_service(id="234567", type="XML") → Retrieve leading precedent

Result: LLM provides comprehensive analysis combining statutory text with judicial interpretation, showing how courts apply the overtime provisions.

Trajectory 4: Constitutional Review

User Query: "Has the Constitutional Court reviewed laws about fines?"

Tool Calls:

detc_search(query="벌금", display=50, type="XML") → Search Constitutional Court decisions
detc_service(id="58386", type="XML") → Retrieve decision full text
law_search(query=<law_name_from_decision>, type="XML") → Find related law for context

Result: LLM explains Constitutional Court holdings on fine-related provisions and their impact on specific laws.

Trajectory 5: Administrative Law Research

User Query: "What administrative rules exist for schools, and are there related legal interpretations?"

Tool Calls:

admrul_search(query="학교", display=50, type="XML") → Search school-related administrative rules
admrul_service(id="62505", type="XML") → Retrieve rule content
expc_search(query="학교", display=30, type="XML") → Search legal interpretations
expc_service(id="334617", type="XML") → Retrieve interpretation details

Result: LLM provides overview of administrative framework for schools with official agency interpretations.

Trajectory 6: Comprehensive Legal Analysis

User Query: "I'm researching rental housing disputes. Show me the relevant law, court precedents, and administrative appeal decisions."

Tool Calls:

eflaw_search(query="주택임대차보호법", display=50, type="XML") → Find Housing Lease Protection Act
eflaw_service(id="002876", type="XML") → Retrieve full law text
prec_search(query="주택임대차", display=50, type="XML") → Search housing lease precedents
prec_service(id="156789", type="XML") → Retrieve key precedent
decc_search(query="주택임대차", display=30, type="XML") → Search administrative appeal decisions
decc_service(id="243263", type="XML") → Retrieve appeal decision

Result: LLM provides comprehensive legal research report covering statutory framework, judicial interpretation, and administrative precedents for rental housing disputes.

Trajectory 7: Citation Network Analysis (Phase 4)

User Query: "What laws does Article 3 of the Building Act cite?"

Tool Calls:

eflaw_search(query="건축법", display=50, type="XML") → Find Building Act, get MST
article_citation(mst="268611", law_name="건축법", article=3) → Extract all citations

Result: LLM provides complete citation analysis showing 12 citations (8 external laws, 4 internal references) including specific article and paragraph references.

Trajectory 8: AI-Powered Natural Language Search (Phase 5)

User Query: "What's the penalty for hit-and-run accidents?"

Tool Calls:

aiSearch(query="뺑소니 처벌", search=0, display=20, type="XML") → Semantic search for hit-and-run penalties

Result: LLM receives full article text from relevant laws (특정범죄 가중처벌 등에 관한 법률 제5조의3) with complete provisions about hit-and-run penalties, enabling comprehensive answer without needing to know specific law names.

User Query: "What laws are related to the Civil Code?"

Tool Calls:

aiRltLs_search(query="민법", search=0, type="XML") → Find semantically related laws

Result: LLM discovers related laws like 상법 (Commercial Act), 의료법 (Medical Service Act), 소송촉진법 (Act on Special Cases Concerning Expedition of Litigation), showing connections across legal domains.

Key Patterns

AI Tools for Vague Queries: Use aiSearch or aiRltLs_search FIRST when user intent is unclear or conversational
Search First, Then Retrieve: Always search to find IDs before calling service tools
Use display=50-100 for Law Searches: Ensures exact matches are found due to relevance ranking
Combine Phases: Mix Phase 1 (laws), Phase 2 (administrative rules), Phase 3 (precedents), and Phase 5 (AI search) for complete research
Type Parameter: Default is type="JSON"; specify type="XML" if your pipeline requires XML
Article Numbers: Use 6-digit format (e.g., "002000" for Article 20) when querying specific articles

Development

Project Structure

lexlink-ko-mcp/
├── src/lexlink/
│   ├── server.py        # Main MCP server with 54 tools
│   ├── _helpers.py      # Shared helpers: run_search, run_service, TOOL_ANNOTATIONS
│   ├── cache.py         # Intelligent per-tool TTL caching (~183 lines)
│   ├── resolver.py      # Korean law name/abbreviation resolution (~225 lines)
│   ├── http_server.py   # HTTP/SSE server for Kakao PlayMCP
│   ├── stdio_server.py  # Stdio transport entry point
│   ├── params.py        # Parameter resolution & mapping
│   ├── validation.py    # Input validation
│   ├── parser.py        # XML parsing utilities
│   ├── ranking.py       # Relevance ranking
│   ├── citation.py      # Article citation extraction (Phase 4)
│   ├── client.py        # HTTP client for law.go.kr API
│   ├── errors.py        # Error codes & responses
│   ├── raw_logger.py    # PlayMCP traffic logging
│   └── log_processor.py # Log format converter
├── logs/playmcp/         # PlayMCP traffic logs (daily JSONL)
├── pyproject.toml        # Project configuration
└── README.md             # This file

Running Tests

# Install test dependencies
uv sync

# Run all tests
uv run pytest

# Run with coverage
uv run pytest --cov=src/lexlink --cov-report=html

# Run specific test category
uv run pytest -m unit
uv run pytest -m integration
uv run pytest -m e2e

Adding New Tools

Current Status: 54/54 tools implemented (Phase 1-9 complete). Phase 1-5 tools validated.

For implementing additional tools from the 124+ remaining APIs:

Follow the pattern established in src/lexlink/server.py
Use ctx: Context = None parameter for MCP logging/progress
Use generic parser functions (extract_items_list, update_items_list)
Add semantic validation tests

Tool Implementation Pattern:

Each tool is a decorated function with MCP schema
Uses ctx: Context = None parameter for MCP context
2-tier OC resolution: tool arg > env var
Generic parser functions work with any XML tag
Comprehensive error handling with actionable hints

Deployment

Deploy to Kakao PlayMCP (HTTP Server)

LexLink can also be deployed as an HTTP server for platforms like Kakao PlayMCP.

Important: Kakao PlayMCP does not accept port numbers in URLs. You must use Nginx as a reverse proxy to serve on port 80.

Quick Start (Local Testing):

# Run the HTTP server
OC=your_oc uv run serve

# Server starts at: http://localhost:8000/sse

Production Setup:

Internet → Nginx (port 80) → LexLink (port 8000)

PlayMCP Registration:

Field	Value
MCP Endpoint	`http://YOUR_SERVER_IP/sse` (no port!)
Authentication	Key/Token (Header: `OC`)

For detailed deployment instructions (AWS EC2, Nginx, systemd, HTTPS), see docs/DEPLOYMENT_GUIDE.md.

PlayMCP Traffic Logging

LexLink includes built-in logging for PlayMCP traffic analysis. Logs are saved in dashboard-compatible JSONL format.

Log Location: logs/playmcp/YYYY-MM-DD.jsonl

Log Schema:

{
  "rpc_id": "3",
  "request_id": "d8ee45eb",
  "session_id": "9ff9dc23431848a4901b4cb6326ba5bd",
  "timestamp": "2025-12-25T05:40:23.957987",
  "duration_ms": 1.52,
  "method": "tools/call",
  "tool_name": "aiSearch",
  "params": { "arguments": {"query": "뺑소니 처벌"} },
  "client": "PlayMCP",
  "client_version": "2025.0.0",
  "protocol_version": "2025-06-18",
  "client_ip": "220.64.111.219",
  "oc": "user_id",
  "status": "success",
  "status_code": 200,
  "result": { ... }
}

Features:

Daily log rotation (one file per day)
Dashboard-compatible format for filtering and analysis
Captures request/response pairs with timing
SSE streaming response parsing

Converting Old Raw Logs:

uv run python -m lexlink.log_processor input.jsonl output.jsonl

Troubleshooting

"OC parameter is required" error

Solution: Set your OC identifier using one of the three methods above.

Korean characters not displaying correctly

Solution: Ensure your terminal supports UTF-8:

export PYTHONIOENCODING=utf-8

"Timeout" errors

Solution: Increase timeout via environment variable:

export LEXLINK_TIMEOUT=90  # Increase from default 60s

Server won't start after updating dependencies

Solution: Re-sync dependencies:

uv sync --reinstall

Contributing

Contributions are welcome! Please:

Fork the repository
Create a feature branch (git checkout -b feature/amazing-feature)
Write tests for new functionality
Ensure all tests pass (uv run pytest)
Commit changes (git commit -m 'Add amazing feature')
Push to branch (git push origin feature/amazing-feature)
Open a Pull Request

License

This project is open source. See LICENSE file for details.

Acknowledgments

law.go.kr - Korean National Law Information API
MCP - Model Context Protocol by Anthropic
korean-law-mcp - Inspiration for caching, law name resolution, and chain tools (Phase 9)

Support

Issues: GitHub Issues
law.go.kr API: Official Documentation

Changelog

v2.1.0 - 2026-03-30

New: Caching, Law Name Resolution, Chain Tools (Phase 9)

Added intelligent per-tool TTL caching (cache.py): search 1hr, articles 24hr, AI search 30min
Added law name/abbreviation resolution (resolver.py): 52 seed aliases + dynamic learning
Added 5 Phase 9 chain tools: chain_full_research, chain_amendment_track, chain_dispute_prep, chain_law_system, cache_stats
Inspired by korean-law-mcp
See CHANGELOG.md for full details

v2.0.0 - 2026-03-30

Major Release: Phase 7 Tools, JSON Default, sections Parameter

Added 18 new Phase 7 tools (자치법규, 조약, 법령정보 지식베이스, 위원회 결정문, 중앙부처 해석, 특별행정심판)
JSON is now the default response format (was XML)
Added sections="summary" parameter for case law service tools
Refactored shared logic into _helpers.py
See CHANGELOG.md for full details

v1.5.0 - 2026-02-28

Refactor: Remove Smithery Dependency

Removed smithery package and 8 transitive dependencies
Simplified OC resolution to 2-tier (tool arg > env var)
Added stdio_server.py entry point for stdio transport
See CHANGELOG.md for full details

For the full changelog (v1.0.0 – v2.1.0), see CHANGELOG.md.

Powered by MCP

Available Tools

54 tools

admrul_searchA

Read-onlyIdempotent

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")

Inputs: nw, oc, knd, org, +9 more.

admrul_serviceA

Read-onlyIdempotent

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")

Inputs: id, lm, oc, lid, +1 more.

aiRltLs_searchA

Read-onlyIdempotent

⭐ 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.

Inputs: query (required), oc, type, search.

aiSearchA

Read-onlyIdempotent

⭐ 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 (도주차량 운전자의 가중처벌)

Inputs: query (required), oc, page, type, +2 more.

article_amendment_diffA

Read-onlyIdempotent

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)

Inputs: article (required), mst_new (required), mst_old (required), oc, +2 more.

article_citationA

Read-onlyIdempotent

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

Inputs: mst (required), article (required), law_name (required), oc, +1 more.

cache_statsA

Read-onlyIdempotent

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

Inputs: no named parameters.

cgm_expc_searchA

Read-onlyIdempotent

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="퇴직금")

Inputs: ministry (required), oc, gana, page, +5 more.

cgm_expc_serviceA

Read-onlyIdempotent

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

Inputs: id (required), ministry (required), oc, type.

chain_amendment_trackA

Read-onlyIdempotent

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")

Inputs: law_name (required), oc, type, article, +2 more.

chain_dispute_prepA

Read-onlyIdempotent

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="개인정보 유출 과징금")

Inputs: query (required), oc, type, display.

chain_full_researchA

Read-onlyIdempotent

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="개인정보 유출 신고 의무")

Inputs: query (required), oc, type, display.

chain_law_systemA

Read-onlyIdempotent

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="개인정보 보호법")

Inputs: law_name (required), oc, type.

check_precedent_oddsA

Read-onlyIdempotent

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)

Inputs: query (required), oc, type, top_n, +1 more.

committee_searchA

Read-onlyIdempotent

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="담합")

Inputs: committee (required), oc, gana, page, +5 more.

committee_serviceA

Read-onlyIdempotent

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

Inputs: id (required), committee (required), oc, type.

decc_searchA

Read-onlyIdempotent

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")

Inputs: oc, cls, date, gana, +9 more.

decc_serviceA

Read-onlyIdempotent

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")

Inputs: id (required), lm, oc, type, +1 more.

detc_searchA

Read-onlyIdempotent

Search Constitutional Court decisions (헌재결정례 목록 조회).

Search Korean Constitutional Court decisions.

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)

Inputs: nb, oc, date, gana, +8 more.

detc_serviceA

Read-onlyIdempotent

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")

Inputs: id (required), lm, oc, type, +1 more.

dlytrm_rlt_searchA

Read-onlyIdempotent

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.

Returns: Search results or error

Inputs: oc, page, type, query, +1 more.

dlytrm_searchA

Read-onlyIdempotent

Search everyday terms (일상용어 조회).

This tool searches plain-language (everyday) terms and their legal equivalents, helping bridge common language with formal legal terminology.

Returns: Search results or error

Inputs: oc, page, type, query, +1 more.

drlaw_searchA

Read-onlyIdempotent

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()

Inputs: oc.

eflaw_josubA

Read-onlyIdempotent

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")

Inputs: ho, id, jo, oc, +5 more.

eflaw_searchA

Read-onlyIdempotent

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"
... )

Inputs: query (required), oc, knd, org, +5 more.

eflaw_serviceA

Read-onlyIdempotent

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")

Inputs: id, jo, oc, mst, +3 more.

elaw_searchA

Read-onlyIdempotent

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")

Inputs: oc, knd, org, page, +5 more.

elaw_serviceA

Read-onlyIdempotent

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")

Inputs: id, ld, lm, ln, +3 more.

expc_searchA

Read-onlyIdempotent

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")

Inputs: oc, inq, rpl, gana, +10 more.

expc_serviceA

Read-onlyIdempotent

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")

Inputs: id (required), lm, oc, type, +1 more.

jo_rlt_lstrm_searchA

Read-onlyIdempotent

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.

Returns: Search results or error

Inputs: oc, page, type, query, +1 more.

law_amendment_summaryA

Read-onlyIdempotent

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")

Inputs: law_name (required), oc, type, date_to, +1 more.

law_josubA

Read-onlyIdempotent

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")

Inputs: ho, id, jo, oc, +4 more.

law_searchA

Read-onlyIdempotent

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

Inputs: query (required), oc, knd, org, +5 more.

law_serviceA

Read-onlyIdempotent

Retrieve full law content by announcement date (공포일 기준 법령 본문 조회).

Retrieves the complete text of a law organized by announcement (publication) date.

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")

Inputs: id, jo, ld, lm, +5 more.

legal_resolverA

Read-onlyIdempotent

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)

Inputs: situation (required), oc, type, display.

lnkDep_searchA

Read-onlyIdempotent

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")

Inputs: org (required), oc, page, sort, +2 more.

lnkLsOrdJo_searchA

Read-onlyIdempotent

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")

Inputs: jo, oc, knd, jobr, +5 more.

lnkLs_searchA

Read-onlyIdempotent

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.

Returns: Search results with linked laws list or error

Examples: Search for "자동차관리법": >>> lnkLs_search(query="자동차관리법", type="XML")

Inputs: oc, page, sort, type, +2 more.

lsDelegated_serviceA

Read-onlyIdempotent

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")

Inputs: id, oc, mst, type.

ls_rlt_searchA

Read-onlyIdempotent

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.

Returns: Search results or error

Inputs: oc, page, type, query, +1 more.

lstrm_ai_searchA

Read-onlyIdempotent

Search legal terms using AI (법령용어 AI 조회).

This tool searches Korean legal terminology using AI-powered semantic matching. Returns definitions and explanations of legal terms.

Returns: Search results or error

Inputs: oc, page, type, query, +1 more.

lstrm_rlt_jo_searchA

Read-onlyIdempotent

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.

Returns: Search results or error

Inputs: oc, page, type, query, +1 more.

lstrm_rlt_searchA

Read-onlyIdempotent

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.

Returns: Search results or error

Inputs: oc, page, type, query, +1 more.

ordinLsCon_searchA

Read-onlyIdempotent

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.

Returns: Search results with ordinance-law linkage list or error

Examples: Search for linked laws: >>> ordinLsCon_search(query="건축", type="XML")

Inputs: oc, page, type, query, +1 more.

ordin_searchA

Read-onlyIdempotent

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")

Inputs: nw, oc, knd, org, +14 more.

ordin_serviceA

Read-onlyIdempotent

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")

Inputs: id, oc, mst, type.

prec_searchA

Read-onlyIdempotent

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="대법원")

Inputs: jo, nb, oc, org, +12 more.

prec_serviceA

Read-onlyIdempotent

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

Inputs: id (required), lm, oc, type, +1 more.

simplify_articleA

Read-onlyIdempotent

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)

Inputs: article (required), law_name (required), oc, type, +1 more.

special_decc_searchA

Read-onlyIdempotent

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="부가가치세")

Inputs: tribunal (required), oc, cls, date, +9 more.

special_decc_serviceA

Read-onlyIdempotent

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

Inputs: id (required), tribunal (required), oc, type.

trty_searchA

Read-onlyIdempotent

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)

Inputs: oc, cls, gana, page, +8 more.

trty_serviceA

Read-onlyIdempotent

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")

Inputs: id (required), oc, type.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

Deploy Server

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

A3.6/5.0

Scored 2026-08-11 11:20 across 54 tools

Disambiguation2/5

Multiple tools have overlapping purposes, such as eflaw_search/law_search (differing only by effective vs announcement date), and numerous linkage/term tools (lstrm_rlt_search, lstrm_rlt_jo_search, dlytrm_rlt_search, jo_rlt_lstrm_search, ls_rlt_search) that are easily confused. The composite tools (chain_full_research, legal_resolver, check_precedent_odds) also overlap significantly in aggregating legal sources.

Naming Consistency2/5

Naming conventions are mixed: snake_case (eflaw_search, law_service), camelCase (aiSearch, aiRltLs_search), and bare noun phrases (article_citation, legal_resolver). The suffix pattern is inconsistent—some use _search, some _service, and some use neither (check_precedent_odds, simplify_article).

Tool Count2/5

At 53 tools (per the list, though the server claims 54), this is far above the typical well-scoped range. The large number reflects the broad legal domain, but it makes the server unwieldy and increases the risk of misselection.

Completeness4/5

The tool set covers an extensive range of Korean legal resources: statutes, administrative rules, ordinances, treaties, precedents, constitutional decisions, interpretations, administrative appeals, committee decisions, and legal terminology, plus composite research workflows. There are minor gaps (e.g., no update/create operations, but these are read-only by design) and some redundant coverage, but overall the domain is well covered.

Maintenance

ActivityInactive

ResponsivenessNo recent community issues

Resources

Related MCP Connectors

airealty 한국 법령 (법제처 OPEN API)
kr.co.airealty
대한민국 법령·조문·별표·연혁·판례·해석례를 법제처 국가법령정보 OPEN API 로 찾아보는 읽기 전용 MCP 서버. 코어 12 + 보조 12 도구.
Legal & Compliance Government Data Search
1
https://law.airealty.co.kr/mcp
Kr LawA
io.github.pipeworx-io
Korea Law MCP — South Korean national statutes via the Ministry of Government Legislation's (법제처)…
Legal & Compliance Government Data
471
https://gateway.pipeworx.io/kr-law/mcp
Korean Law MCPB
io.github.chrisryugj
Korean law: statutes, precedents, ordinances, treaties and citation verification (법제처 API).
Legal & Compliance Government Data
1012,855
https://mcp.gomdori.app/law
legal-mcpA
cn.pianam
MCP server for Chinese law lookup: statutes, regulations and articles by keyword or law name.
Legal & Compliance Government Data
31
https://pianam.cn/legal-mcp/mcp

Related MCP Servers

korean-law-alio-mcp
Legal & Compliance Government Data Search
scvcoder
A
license
C
quality
B
maintenance
Enables searching, comparing, and analyzing Korean laws and public institution regulations through natural language, integrating 110 MCP tools covering statutes, precedents, and internal rules.
Updated 2 months ago (2026-09-13 04:35 UTC)
100
56 npm
24
MIT
Legal Search MCP
Legal & Compliance Government Data
woongaro
A
license
A
quality
D
maintenance
MCP server that enables AI agents to search Korean laws and retrieve article contents using the Korean Ministry of Legislation's law information API.
Updated 10 months ago (2026-01-10 11:10 UTC)
2
MIT
Korea Housing MCP
Government Data Open Data Research & Data
doorijaehyuk
F
license
Not graded
quality
D
maintenance
This MCP server integrates South Korea's national law information, building registers from MOLIT, and KOSIS statistics for housing development research. It enables searching laws, retrieving building details, and accessing statistical data through natural language.
Updated 4 months ago (2026-07-12 04:46 UTC)
-
Korean Law MCP Server
woongaro
A
license
Not graded
quality
D
maintenance
Enables searching and retrieving Korean statutes, precedents, and constitutional court decisions via MCP, using the National Law Information Center API.
Updated 8 months ago (2026-03-12 07:18 UTC)
4,629 npm
1
MIT

Features

Project Status

Prerequisites

Quick Start

1. Install Dependencies

2. Configure Your OC Identifier

3. Run the Server

Available Tools

Phase 1: Core Law APIs (6 tools)

1. eflaw_search - Search Laws by Effective Date

2. law_search - Search Laws by Announcement Date

3. eflaw_service - Retrieve Law Content (Effective Date)

4. law_service - Retrieve Law Content (Announcement Date)

5. eflaw_josub - Query Article/Paragraph (Effective Date)

6. law_josub - Query Article/Paragraph (Announcement Date)

Phase 2: Extended APIs (9 tools)

7. elaw_search - Search English-Translated Laws

8. elaw_service - Retrieve English Law Content

9. admrul_search - Search Administrative Rules

10. admrul_service - Retrieve Administrative Rule Content

11. lnkLs_search - Search Law-Ordinance Linkage

12. lnkLsOrdJo_search - Search Ordinance Articles by Law

13. lnkDep_search - Search Law-Ordinance Links by Ministry

14. drlaw_search - Retrieve Law-Ordinance Linkage Statistics

15. lsDelegated_service - Retrieve Delegated Law Information

Phase 3: Case Law & Legal Research (8 tools - NEW!)

16. prec_search - Search Court Precedents

17. prec_service - Retrieve Court Precedent Full Text

18. detc_search - Search Constitutional Court Decisions

19. detc_service - Retrieve Constitutional Court Decision Full Text

20. expc_search - Search Legal Interpretations

21. expc_service - Retrieve Legal Interpretation Full Text

22. decc_search - Search Administrative Appeal Decisions

23. decc_service - Retrieve Administrative Appeal Decision Full Text

Phase 4: Article Citation Extraction (1 tool - NEW!)

24. article_citation - Extract Citations from Law Article

Phase 5: AI-Powered Search (2 tools - NEW!)

25. aiSearch - AI-Powered Semantic Law Search

26. aiRltLs_search - AI-Powered Related Laws Search

Phase 7: Extended Legal Information (18 tools)

Phase 9: Chain Tools (5 tools)

Tool Selection Guide

Configuration

Environment Variables

OC Priority

Usage Examples

Example 1: Basic Search

Example 2: Search with Date Range

Example 3: Error Handling

Golden MCP Tool Trajectories

Trajectory 1: Basic Law Research

Trajectory 2: Court Precedent Analysis

Trajectory 3: Cross-Phase Legal Research

Trajectory 4: Constitutional Review

Trajectory 5: Administrative Law Research

Trajectory 6: Comprehensive Legal Analysis

Trajectory 7: Citation Network Analysis (Phase 4)

Trajectory 8: AI-Powered Natural Language Search (Phase 5)

Trajectory 9: Discovering Related Laws (Phase 5)

Key Patterns

Development

Project Structure

Running Tests

Adding New Tools

Deployment

Deploy to Kakao PlayMCP (HTTP Server)

PlayMCP Traffic Logging

Troubleshooting

"OC parameter is required" error

Korean characters not displaying correctly

"Timeout" errors

Server won't start after updating dependencies

Contributing

License

Acknowledgments

Support

Changelog

v2.1.0 - 2026-03-30

v2.0.0 - 2026-03-30

v1.5.0 - 2026-02-28

1. `eflaw_search` - Search Laws by Effective Date

2. `law_search` - Search Laws by Announcement Date

3. `eflaw_service` - Retrieve Law Content (Effective Date)

4. `law_service` - Retrieve Law Content (Announcement Date)

5. `eflaw_josub` - Query Article/Paragraph (Effective Date)

6. `law_josub` - Query Article/Paragraph (Announcement Date)

7. `elaw_search` - Search English-Translated Laws

8. `elaw_service` - Retrieve English Law Content

9. `admrul_search` - Search Administrative Rules

10. `admrul_service` - Retrieve Administrative Rule Content

11. `lnkLs_search` - Search Law-Ordinance Linkage

12. `lnkLsOrdJo_search` - Search Ordinance Articles by Law

13. `lnkDep_search` - Search Law-Ordinance Links by Ministry

14. `drlaw_search` - Retrieve Law-Ordinance Linkage Statistics

15. `lsDelegated_service` - Retrieve Delegated Law Information

16. `prec_search` - Search Court Precedents

17. `prec_service` - Retrieve Court Precedent Full Text

18. `detc_search` - Search Constitutional Court Decisions

19. `detc_service` - Retrieve Constitutional Court Decision Full Text

20. `expc_search` - Search Legal Interpretations

21. `expc_service` - Retrieve Legal Interpretation Full Text

22. `decc_search` - Search Administrative Appeal Decisions

23. `decc_service` - Retrieve Administrative Appeal Decision Full Text

24. `article_citation` - Extract Citations from Law Article

25. `aiSearch` - AI-Powered Semantic Law Search

26. `aiRltLs_search` - AI-Powered Related Laws Search