{
  "markdown": "# jp-eli-mcp\n\n<!-- mcp-name: io.github.matematicsolutions/jp-eli-mcp -->\n\nAn MCP server for Japan's official **e-Gov** law search API (`laws.e-gov.go.jp`), run by the\nDigital Agency. It searches, fetches, and cites national legislation - acts, cabinet orders,\nministerial ordinances - with a verifiable citation on every response.\n\nPart of the MateMatic `eu-legal-mcp` production line, extended into Asia. Same citation contract\n(a stable identifier + a human-readable citation + a source URL) as the 18 EU/EEA connectors,\nadapted for a jurisdiction with no ELI scheme.\n\n> **Scope.** Discovery is by law title (`jp_search_laws`) or full-text keyword\n> (`jp_search_by_keyword`); fetch a specific article (`jp_get_article`) or the full text\n> (`jp_get_full_text`, truncated for very large laws such as the Civil Code). Every response\n> carries a `dataset_note`.\n>\n> **Licence.** e-Gov law data is official public information published by the Japanese\n> government as open data (keyless, REST/JSON). This connector relays it with attribution and a\n> `source_url`.\n\n## The tools\n\n| Tool | What it does |\n|---|---|\n| `jp_search_laws` | Search laws by (partial) title. |\n| `jp_search_by_keyword` | Full-text search across all laws, with highlighted snippets. |\n| `jp_get_law` | Metadata for a law by `law_id`: title, law number, promulgation date. |\n| `jp_get_article` | The text of one article of a law, by `law_id` and `article_num`. |\n| `jp_get_full_text` | The full text of a law (truncated at ~300,000 characters). |\n| `jp_coverage` | Declare what this connector covers, when each family was captured, and - explicitly - what it does NOT cover. Every gap carries a fallback. |\n\nEvery response carries the contract: `eli_uri` (Japan has no ELI - this is the durable e-Gov\nviewer URL, e.g. `https://laws.e-gov.go.jp/law/129AC0000000089`, see `eli_note`),\n`human_readable_citation` (e.g. `民法（明治二十九年法律第八十九号）`), and `source_url` (the\nmachine-readable API URL).\n\n## Install\n\nNot yet on PyPI - install from source until the first release ships:\n\n```bash\ngit clone https://github.com/matematicsolutions/jp-eli-mcp\ncd jp-eli-mcp\npip install -e .\n```\n\nOnce released, this will be `uvx jp-eli-mcp`.\n\nConfiguration via env:\n\n- `JP_ELI_BASE_URL` - default `https://laws.e-gov.go.jp/api/2`\n- `JP_ELI_CACHE_DIR` - default `~/.matematic/cache/jp-eli`\n- `JP_ELI_AUDIT_DIR` - default `~/.matematic/audit`\n\nNo API key. e-Gov's law search API is keyless.\n\n### Configure (Claude Code / any MCP client)\n\n```json\n{\n  \"mcpServers\": {\n    \"jp-eli-mcp\": { \"command\": \"jp-eli-mcp\" }\n  }\n}\n```\n\n### Windows 11 with Smart App Control\n\nSmart App Control blocks unsigned executables, which covers `uvx.exe`, `pip.exe`\nand the `jp-eli-mcp.exe` launcher that pip writes at install time. The `python.exe` and\n`py.exe` from the python.org installer are signed by the Python Software\nFoundation, so running the module through the interpreter works:\n\n```bash\npython -m pip install jp-eli-mcp\npython -m jp_eli_mcp\n```\n\n`pip.exe` is blocked for the same reason, so install with `python -m pip`, not\n`pip install`. If `python` is not on PATH, use the Windows launcher: `py -3 -m jp_eli_mcp`.\n\n```json\n{ \"mcpServers\": { \"jp-eli-mcp\": { \"command\": \"python\", \"args\": [\"-m\", \"jp_eli_mcp\"] } } }\n```\n\nDo not turn Smart App Control off to work around this - it cannot be re-enabled\nwithout reinstalling Windows.\n\n## Governance\n\n- **Public data only** - read-only against e-Gov; no client data leaves the machine.\n- **Audit log** - every tool call appends one JSON line to `~/.matematic/audit/jp-eli-mcp.jsonl`.\n- **Vendor-neutral** - talks only to `laws.e-gov.go.jp`; no LLM provider, no telemetry.\n- **Verifiable citations** - every response is independently checkable via `source_url`.\n\nSee `CONSTITUTION.md` and `DISCOVERY.md`.\n\n## Tests\n\n```bash\npip install -e \".[dev]\"\npytest tests/test_instructions_drift.py -v   # offline\npytest tests/test_smoke.py -v                # hits live e-Gov\n```\n\n## Licence\n\nApache-2.0. © Matematic Solutions / Wieslaw Mazur.\n",
  "bytes": 4013,
  "sha": "ec2eb866df75c6cad78d7b7639fa9ee808670934b12daa560df461b4fb259bc3",
  "repo_slug": "matematicsolutions/jp-eli-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_matematicsolutions_jp_eli_mcp_07d3bd58/readme"
}