{"_id":"@bunsato/localgov-mcp-server","_rev":"2-1ad2d3c81143a5225ee863583ef62c79","name":"@bunsato/localgov-mcp-server","dist-tags":{"latest":"0.2.0"},"versions":{"0.2.0":{"name":"@bunsato/localgov-mcp-server","version":"0.2.0","keywords":["mcp","model-context-protocol","claude","japan","subsidies","grants","jgrants","localgov"],"author":{"name":"LocalGov.jp","email":"hello@localgov.jp"},"license":"MIT","_id":"@bunsato/localgov-mcp-server@0.2.0","maintainers":[{"name":"bunsato","email":"hello@localgov.jp"}],"homepage":"https://localgov.jp/","bugs":{"url":"https://github.com/bunsato/localgov-mcp-server/issues"},"bin":{"localgov-mcp":"dist/index.js"},"dist":{"shasum":"425fd66ecf0ec554fad347b6d61ce0dfa83423ad","tarball":"https://registry.npmjs.org/@bunsato/localgov-mcp-server/-/localgov-mcp-server-0.2.0.tgz","fileCount":8,"integrity":"sha512-s80CcS75lJd0iQ59bh0z/B54jBBVA4HxDNOHHB7lwVgD23CJShu8GiaVJmS4OVdWKQukzlveD8gag+X8LngcqQ==","signatures":[{"sig":"MEQCID0fdWzSWGyoOlD41Y+avrUDRPIDQJ9EdiiOFk7KKkuCAiBOG7zcQKze51EtQTFxhBDr2IrBHpWcirLnhjbolUBLeg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":44668},"main":"./dist/index.js","type":"module","engines":{"node":">=18"},"gitHead":"53a3ebbb99a007006f4c7f9bd71763ccd5398fce","scripts":{"dev":"tsx src/index.ts","test":"vitest run","build":"tsc -p tsconfig.json","start":"node dist/index.mjs"},"_npmUser":{"name":"bunsato","email":"hello@localgov.jp"},"repository":{"url":"git+https://github.com/bunsato/localgov-mcp-server.git","type":"git"},"_npmVersion":"11.4.2","description":"MCP server for LocalGov.jp — Japanese local government subsidy data for AI agents (8 tools incl. find_practitioner).","directories":{},"_nodeVersion":"22.17.0","dependencies":{"zod":"^4.4.3","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.0","vitest":"^2.1.0","typescript":"^5.6.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/localgov-mcp-server_0.2.0_1778473551443_0.07690305727386093","host":"s3://npm-registry-packages-npm-production"},"deprecated":"Moved to @localgov-jp/mcp-server"}},"time":{"created":"2026-05-11T04:25:51.305Z","modified":"2026-05-11T04:53:57.827Z","0.2.0":"2026-05-11T04:25:51.576Z"},"bugs":{"url":"https://github.com/bunsato/localgov-mcp-server/issues"},"author":{"name":"LocalGov.jp","email":"hello@localgov.jp"},"license":"MIT","homepage":"https://localgov.jp/","keywords":["mcp","model-context-protocol","claude","japan","subsidies","grants","jgrants","localgov"],"repository":{"url":"git+https://github.com/bunsato/localgov-mcp-server.git","type":"git"},"description":"MCP server for LocalGov.jp — Japanese local government subsidy data for AI agents (8 tools incl. find_practitioner).","maintainers":[{"name":"bunsato","email":"hello@localgov.jp"}],"readme":"# @localgov-jp/mcp-server\n\nModel Context Protocol (MCP) server for [**LocalGov.jp**](https://localgov.jp/) — Japan's central + municipal subsidies, structured for AI agents.\n\nLocalGov.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.\n\nThis server exposes 8 tools to MCP clients (Claude Desktop, Cursor, Cline, Windsurf, etc.).\n\n## Tools\n\n| # | Tool | Cost | Purpose |\n|---|---|---|---|\n| 1 | `search_subsidies` | free | Search by keyword / prefecture / municipality / category / amount |\n| 2 | `get_subsidy_detail` | free | Single record with citation anchor |\n| 3 | `get_municipality_grants` | free | All subsidies for one JIS code (1,627 municipalities covered) |\n| 4 | `find_supplementary_grants` | free | Find municipal \"上乗せ\" grants stacking on a national subsidy |\n| 5 | `compare_municipal_subsidies` | free | Compare same-category grants across nearby municipalities (siting / relocation) |\n| 6 | `subscribe_changes` | $0.20 | Push webhook on grant changes (paid via x402; agent runtime handles payment) |\n| 7 | `verify_receipt` | free | Offline Ed25519 signature verification of citation receipts |\n| 8 | `find_practitioner` | free (referral) | Recommend 行政書士 / 税理士 / 中小企業診断士 / 社労士 for the grant |\n\n## Install\n\n```bash\nnpm install -g @localgov-jp/mcp-server\n```\n\nOr add directly to your MCP client config (no global install required).\n\n## Configure — Claude Desktop\n\nAdd to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\\Claude\\claude_desktop_config.json` (Windows):\n\n```json\n{\n  \"mcpServers\": {\n    \"localgov-jp\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@localgov-jp/mcp-server\"]\n    }\n  }\n}\n```\n\nRestart Claude Desktop. The 8 tools appear in the tool inspector.\n\n## Configure — Cursor / Cline / Windsurf\n\nSame pattern: add an entry to your client's MCP config that runs `npx -y @localgov-jp/mcp-server` over stdio.\n\n## Configure — env\n\n| Variable | Default | Purpose |\n|---|---|---|\n| `LOCALGOV_API_BASE` | `https://localgov.jp` | Override the REST API base (e.g. `http://127.0.0.1:8787` for local wrangler dev) |\n\n## Citation\n\nEvery record returned includes:\n- `_source` — LocalGov.jp canonical URL (cite this).\n- `source_url` — original government page (cite this too).\n\nAttribution 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.\n\n## Verifying citation receipts\n\nThe 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:\n\n```text\n> verify_receipt(receipt: <the JSON envelope>)\n{ \"valid\": true, \"expired\": false, \"pubkey_match\": true }\n```\n\nThe trust anchor is published at `https://localgov.jp/.well-known/citation-pubkey`.\n\n## Differentiation vs Jグランツ MCP\n\n| | Jグランツ MCP (デジタル庁公式) | LocalGov.jp MCP (this) |\n|---|---|---|\n| Coverage | central + prefectural | 1,627 municipalities (target 1,718) + central |\n| Municipal subsidies | 0 | **20,810** unique to us |\n| `find_supplementary_grants` | ✗ | ✓ |\n| `compare_municipal_subsidies` | ✗ | ✓ |\n| `find_practitioner` | ✗ | ✓ (referral funnel) |\n| Citation receipts (Ed25519) | ✗ | ✓ |\n| Change webhook | ✗ | ✓ (x402 paid) |\n\nBoth are complementary. We recommend connecting both servers so an agent can answer \"国 vs 自治体\" exhaustively.\n\n## License\n\nMIT. See [LICENSE](./LICENSE).\n\nOperator: hello@localgov.jp\n","readmeFilename":"README.md"}