MCP Server

Official8 tools

by localgov-jp · JavaScript

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

Access Japan's central and municipal government subsidies database with 20,810 grants across 1,627 municipalities.

Captured live from the server via tools/list.

search_subsidies

Search Japanese central + municipal subsidies. Combine keyword (Japanese), prefecture, municipality_code, category, or minimum amount. Returns up to `limit` records. Free.

Parameters (9)

keywordstring
Free-text Japanese keyword (FTS), e.g. "IT導入", "創業", "省エネ"
prefecturestring
Prefecture name in kanji, e.g. "東京都", "北海道"
municipality_codestring
JIS X 0402 6-digit municipality code (e.g. 131105 = 杉並区)
categorystring
Category label (e.g. "子育て", "住宅", "事業者支援") — usually omit and rely on keyword
min_amount_jpyinteger
Minimum subsidy amount in JPY; only records with amount_max_jpy >= this
open_onlyboolean
When true, exclude records whose deadline has passed (default: false = include all)
sortstring
Sort order; default "relevance" when keyword set, otherwise "newest"
limitinteger
Max records to return (1-100, default 20)
offsetinteger
Pagination offset (default 0)

get_subsidy_detail

Fetch the full record for a single subsidy by id. Returns `_source` (LocalGov.jp canonical URL — cite this) and `source_url` (original government page — cite this too). Free.

Parameters (1)

idstringrequired
Subsidy id, e.g. "jg_a0W2x000003QX8oEAG" (J-Grants central) or "131105_<slug>" (municipal)

get_municipality_grants

List all subsidies for a single municipality by JIS X 0402 6-digit code. **Differentiator**: J-Grants public API has zero municipal-level entries; LocalGov.jp covers 1,627 municipalities (target 1,718). Free.

Parameters (2)

municipality_codestringrequired
JIS X 0402 6-digit municipality code
limitinteger
Max records (1-200, default 50)

find_supplementary_grants

Given a central J-Grants subsidy id, search for municipal grants that supplement it (e.g. national "事業再構築" + city-level "事業再構築追加上乗せ"). Heuristic title-token match. Free.

Parameters (3)

central_grant_idstringrequired
Central J-Grants id, e.g. "jg_a0W..."
prefecturestring
Restrict supplementaries to municipalities of a single prefecture
limitinteger
Max records (1-50, default 30)

compare_municipal_subsidies

Compare same-category subsidies across nearby municipalities (same prefecture by default). Useful for relocation / siting decisions. Free.

Parameters (3)

anchor_municipality_codestringrequired
JIS code of the anchor municipality to compare around
categorystring
Category to compare; if omitted, the most-frequent category at the anchor is auto-picked
max_municipalitiesinteger
Max number of municipalities in the comparison (2-20, default 10)

subscribe_changes

Create a webhook subscription that pushes grant-change events matching a filter. Cost: $0.20 USDC via x402 (paid by the agent runtime). On 402 response, agent must satisfy payment and retry.

Parameters (4)

callback_urlstringrequired
HTTPS URL that will receive POSTed event payloads
hmac_secretstringrequired
Shared secret used to HMAC-SHA256 sign delivery payloads (16-256 chars)
filterobjectrequired
At least one filter dimension required
ttl_daysinteger
Subscription lifetime in days (1-90, default 30)

verify_receipt

Return LocalGov.jp's Ed25519 public key (for offline citation-receipt verification). Callers verify receipt signatures using WebCrypto with this key.

No parameters.

find_practitioner

Recommend 3 Japanese licensed practitioner types (行政書士 / 税理士 / 中小企業診断士 / 社労士) for the grant's category. Returns role explanations and official-association registry links. **Informational only** — LocalGov.jp does NOT broker, refer, or accept commission for these recommendations.

Parameters (2)

grant_idstringrequired
Subsidy id (the recommendation is shaped by the grant's category and amount tier)
industry_hintstring
Free-text industry context, e.g. "飲食業", "製造業"

README.md4 KBView on GitHub

@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

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.

Operator: hello@localgov.jp

Install

Tools (8)

search_subsidiesget_subsidy_detailget_municipality_grantsfind_supplementary_grantscompare_municipal_subsidiessubscribe_changesverify_receiptfind_practitioner

Add to VS Code Add to Cursor

claude_desktop_config.json

json

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