Back to Directory/Developer Tools

io.github.localgov-jp/mcp-server

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

Developer ToolsJavaScriptv0.2.3

@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

#ToolCostPurpose
1search_subsidiesfreeSearch by keyword / prefecture / municipality / category / amount
2get_subsidy_detailfreeSingle record with citation anchor
3get_municipality_grantsfreeAll subsidies for one JIS code (1,627 municipalities covered)
4find_supplementary_grantsfreeFind municipal "上乗せ" grants stacking on a national subsidy
5compare_municipal_subsidiesfreeCompare same-category grants across nearby municipalities (siting / relocation)
6subscribe_changes$0.20Push webhook on grant changes (paid via x402; agent runtime handles payment)
7verify_receiptfreeOffline Ed25519 signature verification of citation receipts
8find_practitionerfree (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

VariableDefaultPurpose
LOCALGOV_API_BASEhttps://localgov.jpOverride 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)
Coveragecentral + prefectural1,627 municipalities (target 1,718) + central
Municipal subsidies020,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

Installation

Source-derived launch command. Check the maintainer’s required arguments and credentials before running:

bash
npx -y @localgov-jp/mcp-server

Set up in your AI client

Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.

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

Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.

Claude Desktop setup reference

Package

@localgov-jp/mcp-servernpm

Compatible MCP Clients

io.github.localgov-jp/mcp-server works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

  • Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.
  • Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.
  • VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.
  • Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.
  • Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

Learn More