com.gachi-tokusuru/japan-data-api

Official8 tools

by eng213035 · JavaScript

Gachi Data API — Japan Station & Accessibility Data

Deep, obscure Japanese station, accessibility & hazard data for AI agents. English-first.

Provides detailed Japanese station, accessibility, and hazard data for AI agents.

japanstationsaccessibilitytransithazard data

Topics

accessibilitycloudflare-workersjapanmcpmodel-context-protocolopen-datatoiletstravel

Captured live from the server via tools/list.

get_municipality_context

Official Japanese government data for any municipality, one call — housing vacancy (2003–2023), nearest-station ridership trend, hazard categories, land prices, livability counts. No scores, no judgment — official values only. Accepts a 5-digit municipality code (13104) or an exact name (Shinjuku-ku / 新宿区).

Parameters (2)

name_or_codestringrequired
5-digit 全国地方公共団体コード (e.g. 13104) or exact municipality name (Shinjuku-ku / 新宿区).
fieldsstring
Optional comma-separated subset: vacancy,ridership,population,hazard,land_price,livability.

get_station_context

Same official municipality data as get_municipality_context, resolved from a station: pass a Japan Station Master station_id (e.g. st_00001) and it returns the context for that station's municipality. Official values only — no scores.

Parameters (2)

station_idstringrequired
Japan Station Master station_id (e.g. st_00001).
fieldsstring
Optional comma-separated subset: vacancy,ridership,population,hazard,land_price,livability.

get_toilet_by_station

Look up wheelchair-accessible / multipurpose toilets inside a Tokyo train station, including floor, gender, equipment (wheelchair, ostomate, diaper table) and the nearest exit. Covers 526 Tokyo stations. Accepts Japanese (新宿) or romaji (Shinjuku, Kita-Senju) for major stations.

Parameters (1)

stationstringrequired
Station name in Japanese (新宿, 渋谷) or romaji for major stations (Shinjuku, Shibuya, Kita-Senju).

get_public_toilet_by_city

List public toilets in a Japanese municipality, with wheelchair / baby-seat / ostomate flags, address and coordinates. Covers 612 municipalities nationwide (large cities capped at the top 50 results). Municipality names accept Japanese (e.g. 那覇市, 渋谷区); prefixing the prefecture improves accuracy.

Parameters (1)

citystringrequired
Municipality name in Japanese (e.g. 那覇市, 渋谷区, 上天草市). Prefix the prefecture for accuracy.

get_station_hazard

Official disaster-risk categories at a Japanese train station, relayed live from the MLIT 不動産情報ライブラリ (Real Estate Information Library): flood inundation-depth rank, landform / liquefaction classification, and storm-surge inundation-area presence (landslide & tsunami are license-restricted and return available:false with a link to the official maps). Returns the official values/categories as-is — no composite score, no judgment. Accepts a station name in Japanese (新宿, 武蔵小杉) or romaji (Shinjuku, Musashi-Kosugi). For research/analytics; NOT a substitute for official government hazard maps or evacuation decisions.

Parameters (1)

station_namestringrequired
Station name in Japanese (新宿, 武蔵小杉) or romaji (Shinjuku, Musashi-Kosugi).

get_active_alerts

Live river flood forecasts and landslide alerts for Japan (JMA official). NOT general weather warnings (storm/heavy rain/snow) and NOT earthquakes. Covers JMA 指定河川洪水予報 (river flood forecast, levels 2–5) and 土砂災害警戒情報 (landslide warning), each with level, affected area, official summary and issue time. Optional `area` filters by 2-digit prefecture code (e.g. 13 = Tokyo) or a JMA forecast-area code. Relay of official facts — not a warning issued by this service, not a life-safety system.

Parameters (1)

areastring
Optional prefecture code (01–47, e.g. 13 = Tokyo) or JMA forecast-area code.

get_station_alerts

Live JMA river flood forecasts and landslide alerts affecting a station's prefecture — NOT general weather warnings. Ask by station name in Japanese (新宿) or romaji (Shinjuku). Prefecture-level match (station master is Greater Tokyo). Relay of official JMA facts.

Parameters (1)

station_namestringrequired
Station name in Japanese (新宿) or romaji (Shinjuku).

get_train_status

Live train service status for Tokyo-area lines — delays, suspensions, resumptions. Ask 'is the Yamanote Line running?' by line or station name, English or Japanese. Status enum: normal / delayed / suspended / resumed. Cause text relayed from ODPT (English summary for known patterns, else original text + null). Data via ODPT (CC BY 4.0).

Parameters (1)

querystringrequired
Line or station name (English or Japanese), e.g. "Yamanote" or "新宿".

README.md5 KBView on GitHub

Gachi Data API — Japan Station & Accessibility Data (API · MCP · Open Datasets)

This is a hosted service. You do NOT self-host it. Get a free API key at https://api.gachi-tokusuru.com and connect to the remote endpoint below. The source in this repo is published for transparency; the data lives in the hosted backend, so a local clone will not return data.

Deep, obscure Japanese data you won't find anywhere else — stations, accessibility, vacancy, hazards. Hand-verified, English-first, built for AI agents. Available as an MCP server, a REST API, and free open datasets. One key works for both the API and MCP.

526 Tokyo stations — accessible / multipurpose toilets with floor, gender, equipment flags (wheelchair, ostomate, diaper table) and the nearest station exit (an original first-party value computed by spatial join — not in any raw dataset).
612 municipalities nationwide — public toilets with wheelchair / baby-seat / ostomate flags, address and coordinates.
Free open datasets — Japan Station Master (entity-resolved, 9,145 stations nationwide) & Ridership 2000–2025, sharing one station_id: https://github.com/eng213035/gachi-open-datasets (Zenodo DOI 10.5281/zenodo.21199500).

Station names accept Japanese (新宿) or romaji (Shinjuku, Kita-Senju) for major stations.

Connect

Endpoint: https://api.gachi-tokusuru.com/mcp
Transport: Streamable HTTP (remote)
Auth: Authorization: Bearer <API_KEY> — free key at https://api.gachi-tokusuru.com

json

{
  "mcpServers": {
    "japan-toilet": {
      "url": "https://api.gachi-tokusuru.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Tools

Tool	Argument	Returns
`get_toilet_by_station`	`station` (Japanese or romaji)	Accessible toilets in a Tokyo station, with `nearest_exit`
`get_public_toilet_by_city`	`city` (Japanese)	Public toilets in a municipality (top 50 for large cities)
`get_station_hazard`	`station_name` (Japanese or romaji)	Official MLIT hazard categories at a station (flood / liquefaction / storm-surge), relayed live, cached 14 days — no derived score. Landslide & tsunami are license-restricted (`available:false` + link to official maps). Not a substitute for official hazard maps.

REST endpoints

GET /v1/station-toilets/search?station=Shinjuku — accessible toilets in a Tokyo station
GET /v1/toilets/nearby?lat=&lng=&radius=&wheelchair=&ostomate=&diaper= — public toilets near a point
GET /v1/stations/{station_id}/hazard — official MLIT hazard categories at a station, relayed live (flood inundation-depth rank, liquefaction/landform, storm-surge presence). Values are returned verbatim from 国土交通省不動産情報ライブラリ with attribution, cached 14 days — no derived score, and not a substitute for official hazard maps. Landslide & tsunami source layers are 一部非商用 (license-restricted), so they return available:false with a link to the official hazard maps. Also available as the MCP tool get_station_hazard(station_name). station_id comes from the Japan Station Master (e.g. st_00001); 423 of 425 stations have coordinates (2 remain unlocated → hazard: null).

All endpoints use the same Authorization: Bearer <key> and share one monthly quota. Full spec: /openapi.yaml, docs: /docs.

Example

bash

curl -X POST https://api.gachi-tokusuru.com/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"get_toilet_by_station","arguments":{"station":"Shinjuku"}}}'

Pricing

Free 1k · Pro $19/100k · All Access $49/200k · Business $149/500k. Full details: https://api.gachi-tokusuru.com

Paid plans are self-serve: after Stripe checkout the customer is redirected to /activate?session_id=…, which verifies payment, resolves the plan from the paid amount, and issues the API key on the page (idempotent per session — reload shows the same key). No manual key handling.

Operational notes (internal)

Subscription cancellation is not yet wired to key revocation (no Stripe webhook in this build). A cancelled subscriber's key keeps working until manually disabled. Reconcile monthly: compare Stripe's active subscriptions against issued key:* records and disable keys for lapsed subscribers. A customer.subscription.deleted webhook → auto-revoke is the next phase.
Plan detection in /activate is by paid amount (AMOUNT_TO_PLAN: $19/$49/$149). If a new plan reuses an existing amount, add an explicit mapping.

Licensing (two layers — read carefully)

Code in this repository: MIT (see LICENSE). Applies to the server code only.
Data returned by the API is NOT MIT. It is derived from:
- Tokyo Metropolitan Government, Bureau of Social Welfare — accessible toilet dataset (CC BY 4.0)
- BODIK nationwide public-toilet open data (CC BY 4.0 or equivalent municipal terms)
- English station names via ODPT (Public Transportation Open Data Center)
nearest_exit is an original derived value by gachi-tokusuru.com.
Attribution is returned in every API response. Timeliness, accuracy and completeness are not guaranteed.

Install

claude_desktop_config.json

{
  "mcpServers": {
    "japan-data-api": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.gachi-tokusuru.com/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.