# localgov-jp/localgov-mcp-server [Health: Active]

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/localgov-jp/localgov-mcp-server  
**GitHub Stars:** 0  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/mcp-server-136

## Description
Japan central + municipal subsidies (20,810 grants, 1,627 munis). 8 tools beyond Jグランツ MCP.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "localgov-mcp-server": {
    "command": "npx",
    "args": ["-y","@localgov-jp/mcp-server"]
  }
}
```

## Documentation & 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](https://github.com/localgov-jp/localgov-mcp-server/blob/HEAD/LICENSE).

Operator: hello@localgov.jp