egov-law-mcp
A local stdio MCP server that lets an agent search Japanese laws and pull article text and metadata from e-Gov Law Search via Law API v2, with source attribution on every result.
Search laws (
search_laws) by keyword covering law title/abbreviation, law number, or law ID, optionally filtered toacts,orders,rules, orall, with a result limit (default 10).Retrieve a specific article (
get_article) bylawIdorlawNum, including an optional paragraph number.Get law metadata and a plain-text preview of a law (
get_law) bylawIdorlawNum, with a configurable preview length.Find related laws (
find_related_laws) for a base law name, including enforcement orders (施行令) and regulations (施行規則).Citable output — results carry the law name, law ID, article, law revision ID, retrieval time, and canonical e-Gov URL so the calling LLM cannot drop the citation.
No LLM, no shell, no legal advice — it only returns source-backed law data plus e-Gov URLs; it is a reference tool, not legal advice.
Note: the README advertises point-in-time retrieval via an
asofparameter on all tools, but the server schema exposes noasofinput.
@codeagentjp/egov-law-mcp
Local stdio MCP server for searching Japanese laws and retrieving article text from e-Gov Law Search through the e-Gov Law API Version 2.
This server does not call an LLM. It only returns source-backed law data and e-Gov URLs so your MCP client (Claude Desktop, Claude Code, Cursor, or any other agent) can cite the original source.
Design choices were informed by reading Digital Agency's open-sourced Lawsy-Custom-BQ (released 2026-04-24 as part of the Gennai government AI OSS release). See the design notes at codeagent.jp.
Why another e-Gov MCP
There is an existing egov-law-mcp on npm by another author. This package differs in four ways:
find_related_laws— looks up enforcement orders (施行令) and regulations (施行規則) for a given base law name or abbreviation. Lawsy-Custom-BQ has the same step server-side; useful because definitions and delegated rules often live outside the parent act.Source attribution baked into every tool result — every response includes the law name, law ID, article number, the law revision ID (版), the retrieval time, and the canonical e-Gov URL, so the calling LLM cannot drop the citation.
Point-in-time retrieval — every tool accepts
asof(YYYY-MM-DD), so you can pin the same version of a law that a benchmark or an earlier answer used.Single-file
.mjs, no build step —bin/egov-law-mcp.mjsruns directly under Node 20+. Easier to audit, smaller install.
Related MCP server: e-Gov Law MCP Server
Status
MVP. The API surface is intentionally small:
search_laws— search current Japanese laws by title, abbreviation, law number, or law ID.get_article— retrieve a specific article (or paragraph) from a law by law ID, law number, or law revision ID.get_law— retrieve basic metadata and a text preview for a law.find_related_laws— find likely related enforcement orders and regulations.
All four accept an optional asof. Since v0.2.0 every request goes to Law API v2 (/api/2/laws and /api/2/law_data/{id}); nothing calls the v1 endpoints any more. See Compatibility with v0.1.x.
Requirements
Node.js 20 or later
Network access to
https://laws.e-gov.go.jp
Install
From npm:
{
"mcpServers": {
"egov-law": {
"command": "npx",
"args": ["-y", "@codeagentjp/egov-law-mcp"]
}
}
}From source for development:
git clone https://github.com/SHAYOUWORLD/egov-law-mcp.git
cd egov-law-mcp
node bin/egov-law-mcp.mjs{
"mcpServers": {
"egov-law": {
"command": "node",
"args": ["/absolute/path/to/egov-law-mcp/bin/egov-law-mcp.mjs"]
}
}
}Tools
search_laws
Searches laws that are not repealed (repeal_status=None) with one laws request. Keywords that look like a law ID (322AC0000000049) go to law_id, keywords that look like a law number (平成十五年法律第五十七号, …第五十七号) go to law_num, and everything else goes to law_title, which e-Gov matches against both the title and its abbreviations (個人情報保護法 finds 個人情報の保護に関する法律). With several space-separated words, the longest goes to e-Gov and the rest are checked locally. Up to 500 matches are ranked locally; truncated: true means e-Gov had more and the keyword should be narrowed.
{
"keyword": "個人情報保護法",
"category": "all",
"limit": 10,
"asof": "2026-10-29"
}category maps to law_type: acts = Constitution, Act; orders = CabinetOrder, ImperialOrder; rules = MinisterialOrdinance, Rule; all = no filter.
get_article
Retrieves an article from the main provision (本則) with law_data?elm=MainProvision-Article_N[-Paragraph_M]. Provide either lawId or lawNum. article accepts 32, 32_2, 32の2, 第32条の2, or 第三十二条の二; paragraph accepts 2 or 第二項.
{
"lawId": "322AC0000000049",
"article": "32",
"paragraph": "2",
"asof": "2026-10-29"
}To pin an exact version, pass a law revision ID as lawId (for example 322AC0000000049_20260717_508AC0000000060); e-Gov then ignores asof. e-Gov accepts asof from 2017-04-01 onward.
get_law
Retrieves basic metadata and a plain text preview of a law.
{
"lawId": "503AC0000000035",
"previewChars": 3000
}find_related_laws
Searches for laws whose names or abbreviations look related to a base law name, including enforcement orders and regulations. It sends one laws?law_title= request with the name minus a trailing 法律 / 法 (and minus 施行令 / 施行規則, so a regulation also finds its parent act).
{
"lawName": "個人情報の保護に関する法律",
"limit": 10
}What the results contain
get_article and get_law return lawId, lawNum, lawTitle, lawRevisionId, and asof, plus a source object:
{
"name": "e-Gov法令検索",
"api": "法令API Version 2",
"url": "https://laws.e-gov.go.jp/law/322AC0000000049",
"apiUrl": "https://laws.e-gov.go.jp/api/2/law_data/322AC0000000049?elm=MainProvision-Article_32-Paragraph_2&asof=2026-10-29&response_format=json&law_full_text_format=xml",
"lawId": "322AC0000000049",
"lawRevisionId": "322AC0000000049_20260717_508AC0000000060",
"amendmentEnforcementDate": "2026-07-17",
"asof": "2026-10-29",
"attribution": "出典: e-Gov法令検索(https://laws.e-gov.go.jp/)",
"processing": "法令API Version 2 の law_data で取得した法令XMLからタグを除き、平文にした。",
"retrievedAt": "2026-10-29T05:57:09.260Z"
}url opens the current version on e-Gov Law Search. apiUrl reproduces the exact request, and lawRevisionId identifies the version that was returned. search_laws and find_related_laws return source with apiUrl, asof, and retrievedAt at the top level, and each result carries lawRevisionId, abbreviations, and the e-Gov URL.
Compatibility with v0.1.x
v0.1.x called Law API v1 (/api/1/lawlists, /api/1/lawdata, /api/1/articles), which has no point-in-time parameter. v0.2.0 moves every tool to v2. The decision record is docs/adr/0001-law-api-v2-migration.md.
Unchanged:
Tool names, required inputs (
keyword,article,lawName, andlawIdorlawNum), and every existing input name.Every existing output field name (
lawId,lawName,lawNo,promulgationDate,score,relationScore,url,text,preview,truncated,source.url,source.apiUrl,source.attribution,source.retrievedAt, …).
Added:
asofinput on all four tools.Output fields such as
lawTitle,lawRevisionId,abbreviations,lawType,articleTitle,articleCaption,elm,matchedCount, andsource.lawRevisionId/source.asof/source.processing.
Changed:
promulgationDateis nowYYYY-MM-DD(v2 format) instead ofyyyyMMdd.search_lawsno longer downloads the whole law list once per process. Each search is onelawsrequest filtered by e-Gov, so abbreviations now match and results can differ from v0.1.x.cacheFetchedAtis kept and now holds the time that request's data was retrieved.find_related_lawsonly finds laws that share the base name's stem; v0.1.x could also list unrelated laws whose short names happened to appear inside the base name.get_articlecalled withlawNumnow also returnslawId(v1 left it empty).paragraphis checked as a number, and article numbers are converted forelm.Errors from e-Gov include its code, for example
e-Gov API returned HTTP 400 (400021: 要素(elm)に合致する要素が法令本文に存在しません。).Requests to e-Gov are paced (see below).
Request pacing and cache
At most one request goes to
laws.e-gov.go.jpat a time, even when a client calls several tools at once or sends a JSON-RPC batch.Each request starts at least 1 second after the previous one finished. Set
EGOV_LAW_MCP_INTERVAL_MSto wait longer; values below1000are ignored.Identical requests within 5 minutes are answered from an in-process cache (or share the request already in flight) and do not reach e-Gov. Cached answers keep their original
retrievedAt.EGOV_LAW_MCP_TIMEOUT_MS(default15000) sets the per-request timeout. It starts when the request is sent, not while it waits for its turn.
The pacing applies within one server process; if you run several copies, keep their combined traffic modest.
Data Source and Attribution
This package uses the e-Gov Law API Version 2:
e-Gov Law Search: https://laws.e-gov.go.jp/
Law API Version 2 (Swagger UI): https://laws.e-gov.go.jp/api/2/swagger-ui
Law API Version 2 OpenAPI definition (version 2.1.139 when checked on 2026-10-29): https://laws.e-gov.go.jp/api/2/swagger-ui/lawapi-v2.yaml
e-Gov terms: https://laws.e-gov.go.jp/terms/
MCP stdio transport: https://modelcontextprotocol.io/specification/2025-06-18/basic/transports
The law body is requested as law XML (law_full_text_format=xml, Base64 inside the JSON response) because the OpenAPI definition marks the JSON form of the body as a trial format that may change.
Tool results include source attribution. When you publish or redistribute output based on this package, include an appropriate e-Gov source attribution, and say that the text was converted from law XML to plain text (source.processing).
Suggested attribution:
出典: e-Gov法令検索(https://laws.e-gov.go.jp/)
Safety Notes
This package is a law reference tool, not legal advice. Verify important legal conclusions against the official e-Gov page and, where necessary, consult a qualified professional.
It does not execute shell commands.
It writes JSON-RPC messages only to stdout and logs only to stderr.
It fetches only
https://laws.e-gov.go.jp/api/2/lawsandhttps://laws.e-gov.go.jp/api/2/law_data/{id}, and refuses redirects.
Development checks
npm testTests launch the stdio server with fetch replaced by local Law API v2 fixtures. They cover each tool's request parameters and output fields, asof and law revision IDs, input validation, e-Gov error codes, request pacing, and the cache. Fixture sources are in test/fixtures/README.md.
Related
Design notes: 源内OSSのLawsy実装をMCP化するなら、どこを残してどこを捨てるか (codeagent.jp)
Background on Gennai OSS release: 源内OSS公開の背景 (codeagent.jp)
Setup guides (Japanese): Claude Code / Codex CLI / Troubleshooting
e-Gov Law API v2 guide (Japanese): codeagent.jp/guides/egov-law-api/
Law API v1 → v2 migration guide (Japanese): codeagent.jp/posts/egov-law-api-v1-to-v2-migration/
Other Japanese public-data APIs and MCP servers: codeagent.jp/guides/public-data-api/
Reference implementation we learned from: digital-go-jp/genai-ai-api/google-cloud/lawsy-custom-bq
License
MIT © codeagent.jp
Available Tools
4 toolsget_articleB
Retrieve a specific article from e-Gov Law Search by law ID or law number.
Inputs: article (required), lawId, lawNum, paragraph.
get_lawA
Retrieve law metadata and a plain text preview from e-Gov Law Search.
Inputs: lawId, lawNum, previewChars.
search_lawsB
Search current Japanese laws from e-Gov Law Search by keyword.
Inputs: keyword (required), category, limit.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool has a distinct purpose: searching laws, retrieving law metadata, retrieving specific articles, and finding related laws. No overlap in functionality.
All tool names follow a consistent verb_noun pattern in snake_case, e.g., search_laws, get_law, get_article, find_related_laws.
With 4 tools, the server is well-scoped for a focused legal search assistant. The count is neither excessive nor insufficient.
The tool set covers the core operations for searching and retrieving Japanese laws and articles. A minor gap is the lack of a tool to list all laws, but for search purposes this is acceptable.
Maintenance
Related MCP Connectors
Japan Law MCP — Japanese national laws & ordinances via the e-Gov Law API.
Search Japanese statutes via the e-Gov Law API. Free law_search tool.
대한민국 법령·조문·별표·연혁·판례·해석례를 법제처 국가법령정보 OPEN API 로 찾아보는 읽기 전용 MCP 서버. 코어 12 + 보조 12 도구.
Japanese law, corporation & statistics data as MCP, normalized to English with source attribution.
Related MCP Servers
- AlicenseAqualityBmaintenanceEnables LLMs to search and retrieve Japanese laws from the e-Gov API v2, including keyword search, article fetching, table of contents, and revision history.7142 npm2MIT
- AlicenseAqualityDmaintenanceMCP server for searching and retrieving Japanese laws from the e-Gov API, enabling natural language queries for legal information.314 npmMIT
- AlicenseAqualityDmaintenanceMCP server to fetch Japanese financial laws and regulations from the e-Gov API, preventing hallucinations in Claude's responses. Supports 9 domains including Financial Instruments and Exchange Act, Banking Act, etc.5MIT
- AlicenseAqualityCmaintenanceMCP server wrapping the e-Gov law API v2 to search and retrieve Japanese law data, including law lists, revision histories, full text, attachments, and keyword search.64MIT