Japan Places MCP Server
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
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.
Install
npm install mcp-japan-places
npx mcp-japan-placesOr with a custom endpoint:
JAPAN_PLACES_BASE=https://japan-places.local-connect-design.trade npx mcp-japan-placesThe server is zero-dependency (Node >= 18, stdio JSON-RPC) and holds no API keys and no payment credentials.
Related MCP server: japan-intelligence-api
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 |
|
| Free |
|
| Free |
|
| Paid, US$0.05/call |
|
| Paid, US$0.03/call |
|
| Paid, US$0.02/call |
|
| Paid, US$0.05/call |
|
| Paid, US$0.05/call |
|
| Paid, US$0.05/call |
|
| Paid, US$0.05/call |
|
| Paid, US$0.04/call |
|
| Paid, US$0.03/call |
|
| Paid, US$0.02/call |
|
| Paid, US$0.03/call |
|
| Paid, US$0.02/call |
|
| Paid, US$0.02/call |
|
| Paid, US$0.03/call |
Notes:
jp_municipalityrequiresprefecture(name such as東京都or the 2-digit JIS X 0401 code such as13); the API answers 400 without it.jp_catchmentcurrently 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_catalogandjp_history_diffwere removed so this package carries exactly the hosted MCP's 16-tool set./health,/poiand/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.jsonSYNC.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
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Official SupplyGraph.AI data MCP: POIs, parks, regions, industry chains, and companies.
17+ Japan MCP tools (weather/calendar v2/local-pack/enrich). x402 on Base, wallet-free trial.
The world's public data, one API. License-cleared public data sources for agents, via MCP and REST.
Japan POI tools for AI agents: 2.94M facilities, station catchments, chains, grants and signals
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceEnables MCP clients to query Japanese open data (e-Stat, 国土数値情報, EDINET, 気象庁 etc.) from Queria using SQL.1MIT
- FlicenseNot gradedqualityDmaintenanceProvides AI agents with comprehensive Japanese market intelligence through 27 MCP tools, covering corporate data, macroeconomics, financials, and environmental data from 14 integrated sources.-
- AlicenseAqualityAmaintenanceModel Context Protocol (MCP) server providing access to 155 normalized Japanese public open datasets (10.16M+ records) including GEPS procurement, healthcare, land prices, and DuckDB SQL.5MIT
- AlicenseBqualityBmaintenanceEnables MCP clients to query 16 institutional data and security endpoints spanning SEC EDGAR, certificate transparency, vulnerability scoring, KYB, regulatory complaints, federal spending, banking, cloud catalogs, DeFi, healthcare, academic citations, and seismic data. Access is monetized through x402 V2 micropayments or Stripe session passes.21MIT