@localgov-jp/mcp-server
Model Context Protocol (MCP) server for 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
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):
{
"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:
> 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.
Operator: hello@localgov.jp