Gachi Data API — Japan Station & Accessibility Data

com.gachi-tokusuruPublished by gachi-tokusuru.comOfficial publisherv1.0.1Updated Oct 24, 2026

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

Overview

AI-generated overview

A hosted MCP endpoint giving assistants official Japanese station, accessibility, hazard and live alert data, queried in English or Japanese.

What you can do
Check server health, version, station coverage and freshness of live data layers with ping and connection tests. Retrieve official municipality context: housing vacancy, ridership trends, hazard categories, land prices and livability counts, by municipality code or name, or resolved from a station. Look up accessible and public toilets: multipurpose toilets inside Tokyo stations with floor, equipment and nearest exit, and public toilets nationwide by city. Search stations semantically by what you want around them, such as late-night ramen or wheelchair toilets. Fetch official hazard categories at a station and live JMA river flood and landslide alerts, plus Tokyo-area train service status.
When to use it
Useful when answering questions about Japanese train stations, accessibility facilities, municipal statistics, disaster risk or live train and flood conditions, especially where English-first, source-attributed data is wanted.
Requirements
Remote Streamable HTTP endpoint; no local install. Requires a bearer API key in the Authorization header, obtained free from the provider's site. One key and one monthly quota are shared across the MCP and REST endpoints.
Before you install
The API key is a secret sent in the Authorization header. Usage is metered: a free tier of 1k requests, then paid plans billed through Stripe checkout. Returned data is not MIT-licensed; each value carries source attribution and must be credited. Hazard and alert data are relays of official sources, not a substitute for official hazard maps, and accuracy is not guaranteed.

Installation

In SourceWeft

  1. Open Gachi Data API — Japan Station & Accessibility Data in the dashboard and add it to a workspace.
  2. Connect Authorization token credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/com.gachi-tokusuru%2Fjapan-data-api/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "gachi-data-api-japan-station-accessibili": {
      "type": "http",
      "url": "https://api.gachi-tokusuru.com/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

README

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": {    "gachi-data": {      "url": "https://api.gachi-tokusuru.com/mcp",      "headers": { "Authorization": "Bearer YOUR_API_KEY" }    }  }}

Tools

ToolArgumentReturns
get_toilet_by_stationstation (Japanese or romaji)Accessible toilets in a Tokyo station, with nearest_exit
get_public_toilet_by_citycity (Japanese)Public toilets in a municipality (top 50 for large cities)
get_station_hazardstation_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. Each value carries its source in the response attribution. It is derived from:
  • Derived by gachi-tokusuru.com (distinct from the official values above): nearest_exit, nearest_station_km, and bus-stop counts are computed via spatial join.
  • Attribution is returned in every API response. Timeliness, accuracy and completeness are not guaranteed.

Source: README.md at commit 8857b5c

Tools

10

ping

Connection test / health check

Connection test / health check — call this first to confirm the server is reachable. Returns server identity, deploy version, tool count, station coverage, and the update times of the realtime layers (JMA alerts, train status) so you can confirm freshness, not just liveness. No auth, no arguments, lightweight.

Takes no parameters.

get_municipality_context

Municipality context (official data)

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 / 新宿区).

Parametersfieldsname_or_coderequired

get_station_context

Station-area context (official data)

Same official municipality data as get_municipality_context, resolved from a station: pass a station name (Shinjuku / 新宿 / Musashi-Kosugi) or 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.

Parametersfieldsstation_idstation_name

get_toilet_by_station

Accessible toilets in a station

Look up wheelchair-accessible / multipurpose toilets inside a train station, including floor, gender, equipment (wheelchair, ostomate, diaper table) and the nearest exit. Covers 526 Tokyo stations (Tokyo Bureau of Social Welfare data). Major stations outside Tokyo (Yokohama, Kawasaki, Omiya, Chiba, Fujisawa, Shin-Yokohama…) return an in-station layer that groups accessible toilets by ticket gate — inside vs outside — per railway operator. Accepts Japanese (新宿, 横浜) or romaji (Shinjuku, Yokohama) for major stations.

Parametersstationrequired

get_public_toilet_by_city

Public toilets in a 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.

Parameterscityrequired

get_station_hazard

Station disaster-risk (official)

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.

Parametersstation_namerequired

get_active_alerts

Live JMA flood/landslide 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.

Parametersarea

get_station_alerts

Live JMA alerts near a station

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.

Parametersstation_namerequired

get_train_status

Live Tokyo-area 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).

Parametersqueryrequired

Version history

1
  1. v1.0.1LatestSep 16, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.