@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: [email protected]