npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

mcp-japan-places

v2.1.0

Published

MCP server for the Japan Places API: the same 16 tools as the hosted MCP - municipality census, POI category counts for all 47 prefectures, station catchments, and 14 paid signals incl. grant deadlines and gBizINFO search.

Readme

Japan Places MCP Server

MCP server for the Japan Places API — municipality census for 1,917 municipalities (2020 census), POI category counts for all 47 prefectures, station catchments, and 13 derived live signals for Japan.

M8ven Verified

Install

npm install mcp-japan-places
npx mcp-japan-places

Or with a custom endpoint:

JAPAN_PLACES_BASE=https://japan-places.local-connect-design.trade npx mcp-japan-places

The server is zero-dependency (Node >= 18, stdio JSON-RPC) and holds no API keys and no payment credentials.

Tools

16 tools: the same set as the hosted MCP (the canon in functions/mcp-tools.json) — one per dataset. Free tools return data directly. Paid tools are gated by the API with HTTP 402 (x402 micropayments in USDC on Base, or a RapidAPI Premium Datasets plan on PRO/ULTRA/MEGA); without payment a paid tool returns a clean, labelled PAID_DATASET error explaining the price and the payment routes — this server cannot pay on your behalf.

| Tool | Endpoint | Access | |---|---|---| | jp_municipality | GET /api/v1/poi/municipality | Free | | jp_quality | GET /api/v1/poi/quality | Free | | jp_catchment | GET /api/v1/poi/catchment | Paid, US$0.05/call | | jp_chains | GET /api/v1/poi/chains | Paid, US$0.03/call | | jp_aliveness | GET /api/v1/poi/aliveness | Paid, US$0.02/call | | jp_density | GET /api/v1/poi/density | Paid, US$0.05/call | | jp_energy_price | GET /api/v1/signals/energy/price | Paid, US$0.05/call | | jp_land_price | GET /api/v1/poi/land/price | Paid, US$0.05/call | | jp_subsidy_award_rate | GET /api/v1/signals/subsidy/award-rate | Paid, US$0.05/call | | jp_grant_deadline_alert | GET /api/v1/signals/grant/deadline | Paid, US$0.04/call | | jp_gbizinfo_search | GET /api/v1/signals/gbizinfo | Paid, US$0.03/call | | jp_jma_weather | GET /api/v1/signals/jma/weather | Paid, US$0.02/call | | jp_boj_statistics | GET /api/v1/signals/boj/statistics | Paid, US$0.03/call | | jp_tourism_signal | GET /api/v1/signals/tourism | Paid, US$0.02/call | | jp_crime_statistics | GET /api/v1/signals/crime | Paid, US$0.02/call | | jp_facility_signal | GET /api/v1/signals/facility | Paid, US$0.03/call |

Notes:

  • jp_municipality requires prefecture (name such as 東京都 or the 2-digit JIS X 0401 code such as 13); the API answers 400 without it.
  • jp_catchment currently covers a sample of 60 major stations (a full-station rollout is planned), per the API's own disclosure.
  • Changed in 2.1.0 (JP-16 canon resync): jp_health, jp_catalog and jp_history_diff were removed so this package carries exactly the hosted MCP's 16-tool set. /health, /poi and /diff/{dataset} remain available over REST.

Generated code — do not edit by hand

src/index.js is generated by tools/generate_mcp.py from the vendored inputs in tools/inputs/:

  • openapi.json — a snapshot of the live OpenAPI spec (https://japan-places.local-connect-design.trade/api/v1/openapi),
  • mcp-tools.json — the tool canon of the site's own hosted MCP,
  • SPEC_SOURCE.json — provenance of the snapshot (source, capture date, catalog hash).
npm run generate        # regenerate src/index.js + SYNC.json
npm test                # live smoke test against the real API
npm run check-drift     # compare the live spec against SYNC.json

SYNC.json records the spec source, the catalog hash this build was generated from, and the tool/path coverage. Re-running the generator on an unchanged spec produces a byte-identical tree.

Drift watch (permanent sync loop)

tools/check_drift.py fetches the live /api/v1/openapi, and compares its catalog hash and path set against SYNC.json (exit 0 = in sync, exit 2 = drift, with a diff summary). A capture-fleet stream named mcp_drift runs this checker daily on the sora fleet; a divergence lands in the fleet status as a failure, which queues the follow-up work item: refresh tools/inputs/openapi.json from the live spec, re-run the generator, run the smoke test, and republish. That loop is what keeps this package matched to the live API.

要約(日本語): 本パッケージの src/index.js は生成物です。ライブAPIの OpenAPI 仕様とサイト内蔵MCPのツール定義から tools/generate_mcp.py が 生成します。ライブ仕様とのずれは tools/check_drift.py が検出し、soraの 取得フリート(ストリーム mcp_drift、日次)が監視します。ずれたら 「仕様を取り直して再生成、スモークテスト、再公開」が作業項目になります。

License

CDLA-Permissive-2.0 AND Apache-2.0

Data licenses: CDLA-Permissive-2.0, Apache-2.0, CC0-1.0, CC BY 2.0/4.0, PDL-1.0 Attribution: https://japan-places.local-connect-design.trade/jp-places/attribution.html

Publisher

Lexus — https://github.com/lexusdev7