How do I use @localgov-jp/mcp-server?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@@localgov-jp/mcp-server find supplementary grants for child care in Tokyo" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

@localgov-jp/mcp-server

Official

by localgov-jp

Overview Schema Source Related Servers Discussions Admin

JavaScript

Remote

@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

Related MCP server: jpcite

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

Available Tools

13 tools

compare_municipal_subsidiesAInspect

Compare same-category subsidies across nearby municipalities — useful for relocation / siting decisions. Pass an anchor municipality_code; returns the same category subsidies in 5-10 nearby municipalities (currently same-prefecture). Free.

Inputs: anchor_municipality_code (required), category, max_municipalities.

find_practitionerAInspect

Recommend 3 Japanese licensed practitioners (行政書士 / 税理士 / 中小企業診断士 / 社会保険労務士) matched to the grant's category and amount tier. Returns association registry URLs and a LocalGov.jp referral landing URL. BETA — vetted individual profiles ship with the LocalGov.jp practitioner directory.

Inputs: grant_id (required), industry_hint.

find_practitioner_for_auctionAInspect

落札・入札に関連する士業を返す (司法書士・弁護士・不動産鑑定士・土地家屋調査士). Returns 2-3 practitioner federation directories suitable for the given auction stage. Stages: post_acquisition (default — 落札後の所有権移転登記; 司法書士が法律上ほぼ必須), pre_bid (入札前の独立評価・権利確認), eviction (明渡し・強制執行), boundary_dispute (境界確定・分筆). Information-only — not a paid intermediary. Do not combine the result of this tool with output from 'find_practitioner' (grants module) in a single answer.

Inputs: case_id (required), stage, prefecture.

find_supplementary_grantsAInspect

Given a central J-Grants subsidy id, search for municipal grants that supplement it (e.g. national "事業再構築" + city-level "事業再構築追加上乗せ"). Heuristic: matches base title tokens across municipal records of the same/similar category. Returns up to 30. Free.

Inputs: central_grant_id (required), limit, prefecture.

get_auction_detailAInspect

一件の競売物件の構造化データを取得. Fetch one auction by case_id (e.g. "bit_00000078922"). Returns case_number, court, property_type, sale_base_price_jpy, bid_floor_jpy (= base × 80%), deposit_jpy, bid_period, opening_date, address, photos, source_url (BIT), and _canonical (cite this). Free. Brand-isolated from the subsidies module.

Inputs: case_id (required).

get_court_directoryAInspect

裁判所の連絡先・管轄情報を取得. Look up a Japanese district court (本庁 or 支部) by code. Returns name, prefecture, parent court (for branches), inquiry phone, and BIT search URL. Brand-isolated; do not mix with the subsidies module.

Inputs: court_code (required).

get_municipality_grantsBInspect

List all subsidies for a specific municipality by JIS X 0402 6-digit code (e.g. 131105 = 杉並区). Differentiator vs J-Grants: J-Grants public API has zero municipal-level entries; LocalGov.jp covers 1,627 municipalities (target 1,718). Free.

Inputs: municipality_code (required), limit.

get_subsidy_detailAInspect

Fetch the full record for a single subsidy by id. Returns title, summary, eligibility, amount cap, deadline, source_url (original government page), and _source (LocalGov.jp canonical URL — cite this). Free.

Inputs: id (required).

list_upcoming_salesAInspect

近日開札予定の競売物件を一覧取得. List auctions whose opening_date falls within the next N days (default 14, max 90). Sorted ascending. Useful for investment screening / calendar exports.

Inputs: limit, days_ahead.

search_auctionsBInspect

日本の不動産競売物件を検索 (BIT, bit.courts.go.jp 由来の構造化データ). Search Japanese court real-estate auctions (BIT). Distinct from the subsidies module above. Filters: prefecture (東京都 etc.), court_code, property_type (land / detached_house / apartment / other), price range, bid_period_only (active bid window now). Returns case_id, court, address, sale_base_price_jpy, bid_period, opening_date, photos. Free.

Inputs: sort, limit, offset, status, +7 more.

search_subsidiesAInspect

Search Japanese central + municipal subsidies. Combine keyword (Japanese), prefecture, category, or minimum amount. Returns up to limit results (default 20). Free tool — no payment required.

Inputs: sort, limit, offset, keyword, +5 more.

subscribe_changesAInspect

Create a webhook subscription that pushes grant-change events matching a filter. Cost: $0.20 USDC via x402 (paid by the agent runtime, not the MCP server). On payment failure or missing capability, returns a structured 402 with the payment requirements so the caller agent can satisfy and retry.

Inputs: filter (required), hmac_secret (required), callback_url (required), ttl_days.

verify_receiptAInspect

Verify an Ed25519-signed citation receipt previously issued by /api/cite/:grant_id. Confirms (a) signature matches LocalGov.jp pubkey, (b) receipt has not expired. Local crypto, no network. If pubkey is omitted, the live pubkey is fetched from /.well-known/citation-pubkey for trust anchoring.

Inputs: receipt (required), expected_pubkey.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

Deploy Server

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

A4.2/5.0

Scored 2026-08-04 19:45 across 13 tools

Disambiguation5/5

Each tool has a clearly distinct purpose, separated by domain (subsidies vs. auctions) and action (search, get, compare, subscribe, verify). Even the two practitioner finders are explicitly named by domain and described as non-interchangeable.

Naming Consistency5/5

All tool names follow a consistent verb_noun snake_case pattern (get_, search_, find_, compare_, subscribe_, verify_, list_). Nouns are appropriately singular/plural and there is no mixing of stylistic conventions.

Tool Count5/5

With 13 tools covering two related domains (subsidies and court auctions) plus supporting utilities (subscription, verification), the count is well-scoped and each tool earns its place without feeling excessive or sparse.

Completeness5/5

The tool surface provides comprehensive coverage: search, detail, municipality-specific lists, supplementary matching, cross-municipality comparison, and change subscriptions for subsidies; search, detail, upcoming sales, court directory, and practitioner referral for auctions. No obvious dead ends or missing lifecycle operations for an information retrieval service.

Resources

Related MCP Connectors

HORIZON SHIELDADeprecated
dev.workers.oga-surf-project.hs-mcp
An MCP server that audits the fairness of construction and renovation estimates in Japan. Provides fair-price ranges, overcharge detection, and verifiable unit-cost data based on JCCDB (65,520 items across 402 categories, CC BY 4.0, DOI-backed).
Finance Open Data Research & Data
152
https://hs-mcp.oga-surf-project.workers.dev/mcp
補助・助成.jpA
jp.hojo-josei
Find Japanese subsidies, check eligibility with guideline citations, and fill official forms.
Government Data Search Documentation Access
301
https://mcp.hojo-josei.jp/mcp
geojp
io.github.55tarkun
MCP server for Japan geodata: cadastral lot numbers (chiban) and reverse geocoding, for AI agents.
Location Services Open Data Government Data
1
https://mcp.reversegeojp.com
補助金AIA
io.github.mkisama94
Search Japanese subsidies and public company data using J-Grants, gBizINFO, and EDINET.
Government Data Open Data Finance
151
https://subsidy.ai-orchestration.jp/mcp

Related MCP Servers

jgrants-mcp-serverofficial
Government Data Search
digital-go-jp
A
license
Not graded
quality
D
maintenance
MCP server for Japan's Jグランツ grant application system, enabling LLMs to search and retrieve subsidy information via natural language.
Updated 7 months ago (2026-04-06 07:42 UTC)
51
MIT
jpcite
Government Data Legal & Compliance RAG Systems
shigetosidumeda-cyber
A
license
Not graded
quality
C
maintenance
日本の公的制度(補助金/法令/税務/法人/判例)を提供する MCP サーバー。261 ツール、¥3/billable unit、匿名 3/日 free。Evidence Packets with source_url + source_fetched_at + known_gaps. PyPI: autonomath-mcp.
Updated 5 months ago (2026-06-04 09:48 UTC)
1
MIT
japan-corporate-mcp
Government Data Open Data
yamariki-hub
A
license
Not graded
quality
D
maintenance
MCP server for searching Japanese corporate data including companies, financials, patents, subsidies, and government statistics via official government APIs.
Updated 9 months ago (2026-02-22 14:22 UTC)
1
MIT
jgrants-mcp
Government Data Search Open Data
42tahara
A
license
Not graded
quality
D
maintenance
MCP server that enables LLMs to search and retrieve Japanese government subsidy and grant information via natural language, wrapping the Jグランツ public API.
Updated 3 months ago (2026-08-01 15:48 UTC)
MIT

@localgov-jp/mcp-server

Tools

Install

Configure — Claude Desktop

Configure — Cursor / Cline / Windsurf

Configure — env

Citation

Verifying citation receipts

Differentiation vs Jグランツ MCP

License

Available Tools

Tool Schema Changelog

TDQS

Resources

Related MCP Connectors

Related MCP Servers

jgrants-mcp-serverofficial

jpcite

japan-corporate-mcp

jgrants-mcp