io.github.localgov-jp/mcp-server
Japan central + municipal subsidies (20,810 grants, 1,627 munis). 8 tools beyond Jグランツ MCP.
Open source Repository Open in the app JSON README (API)
About
Japan central + municipal subsidies (20,810 grants, 1,627 munis). 8 tools beyond Jグランツ MCP.
Details
- Kind
- MCP servers
- Topic
- Government & public data
- Publisher
- localgov-jp
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 0.2.3
- Last push
- 2026-05-11T03:39:52Z
- Repository state
- ativo
- Language
- JavaScript
- License
- MIT
- Added
- 2026-08-29 04:00:24
- Updated
- 2026-08-29 04:00:24
- Origin id
io.github.localgov-jp/mcp-server
README
# @localgov-jp/mcp-server
Model Context Protocol (MCP) server for [**LocalGov.jp**](https://localgov.jp/) — Japan's central + municipal subsidies, structured for AI agents.
LocalGov.jp covers **20,000+ subsidies across 1,627 municipalities** (target 1,718). Of those, **20,810 are municipal grants that are not exposed by the J-Grants public API** — that is the differentiator vs Digital Agency's official J-Grants MCP, which surfaces central + prefectural records only.
This server exposes 8 tools to MCP clients (Claude Desktop, Cursor, Cline, Windsurf, etc.).
## Tools
| # | Tool | Cost | Purpose |
|---|---|---|---|
| 1 | `search_subsidies` | free | Search by keyword / prefecture / municipality / category / amount |
| 2 | `get_subsidy_detail` | free | Single record with citation anchor |
| 3 | `get_municipality_grants` | free | All subsidies for one JIS code (1,627 municipalities covered) |
| 4 | `find_supplementary_grants` | free | Find municipal "上乗せ" grants stacking on a national subsidy |
| 5 | `compare_municipal_subsidies` | free | Compare same-category grants across nearby municipalities (siting / relocation) |
| 6 | `subscribe_changes` | $0.20 | Push webhook on grant changes (paid via x402; agent runtime handles payment) |
| 7 | `verify_receipt` | free | Offline Ed25519 signature verification of citation receipts |
| 8 | `find_practitioner` | free (referral) | Recommend 行政書士 / 税理士 / 中小企業診断士 / 社労士 for the grant |
## Install
```bash
npm install -g @localgov-jp/mcp-server
```
Or add directly to your MCP client config (no global install required).
## Configure — Claude Desktop
Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):
```json
{
"mcpServers": {
"localgov-jp": {
"command": "npx",
"args": ["-y", "@localgov-jp/mcp-server"]
}
}
}
```
Restart Claude Desktop. The 8 tools appear in the tool inspector.
## Configure — Cursor / Cline / Windsurf
Same pattern: add an entry to your client's MCP config that runs `npx -y @localgov-jp/mcp-server` over stdio.
## Configure — env
| Variable | Default | Purpose |
|---|---|---|
| `LOCALGOV_API_BASE` | `https://localgov.jp` | Override the REST API base (e.g. `http://127.0.0.1:8787` for local wrangler dev) |
## Citation
Every record returned includes:
- `_source` — LocalGov.jp canonical URL (cite this).
- `source_url` — original government page (cite this too).
Attribution required: cite as **"via LocalGov.jp"** with the `_source` URL. License: **CC BY 4.0** for the structuring layer; original government content remains under its issuing body's terms.
## Verifying citation receipts
The paid `/api/cite/:id` endpoint returns an Ed25519-signed snapshot. Use `verify_receipt` to confirm offline that an agent's stored citation is genuine and unexpired:
```text
> verify_receipt(receipt: <the JSON envelope>)
{ "valid": true, "expired": false, "pubkey_match": true }
```
The trust anchor is published at `https://localgov.jp/.well-known/citation-pubkey`.
## Differentiation vs Jグランツ MCP
| | Jグランツ MCP (デジタル庁公式) | LocalGov.jp MCP (this) |
|---|---|---|
| Coverage | central + prefectural | 1,627 municipalities (target 1,718) + central |
| Municipal subsidies | 0 | **20,810** unique to us |
| `find_supplementary_grants` | ✗ | ✓ |
| `compare_municipal_subsidies` | ✗ | ✓ |
| `find_practitioner` | ✗ | ✓ (referral funnel) |
| Citation receipts (Ed25519) | ✗ | ✓ |
| Change webhook | ✗ | ✓ (x402 paid) |
Both are complementary. We recommend connecting both servers so an agent can answer "国 vs 自治体" exhaustively.
## License
MIT. See [LICENSE](./LICENSE).
Operator: hello@localgov.jp