Connect J-SHIS Seismic Hazard to Codex
Query J-SHIS Seismic Hazard directly from Codex. Arlet links the two through one MCP connection and takes care of API keys.
This server connects your AI client to the J-SHIS (Japan Seismic Hazard Information Station) Web API, the official seismic hazard database operated by NIED, Japan's national disaster-resilience research institute. J-SHIS publishes the probabilistic seismic hazard maps produced by the government's Headquarters for Earthquake Research Promotion.
Key features:
- Seismic hazard by location: pass latitude/longitude anywhere in Japan and get the 250m-mesh probability of experiencing JMA seismic intensity 5-lower, 5-upper, 6-lower, or 6-upper (or stronger) shaking within the next 30 years, plus the expected shaking at standard exceedance probabilities - reported as JMA intensity classes and peak ground velocities, not as raw codes.
- Dominant earthquakes and faults: for a municipality (5-digit code), a prefecture (name or code) or a single point, get the ranked list of earthquakes and active faults that matter most there, with occurrence probability, magnitude and the population exposed to strong shaking. This works without any coordinates, so a place name is enough to get started.
- Surface soil conditions: microtopography classification (reclaimed land, natural levee, volcanic ash upland, ...), AVS30 (average shear-wave velocity in the top 30m) with a plain-language ground-hardness class, and the ground-motion amplification factor.
- Landslide topography: whether a point's 250m mesh intersects NIED's mapped landslide landforms, with a J-SHIS Map link.
- Hazard curves: the full relationship between peak bedrock velocity and its 30/50-year exceedance probability, for quantitative risk analysis.
Typical uses: assessing earthquake risk of a home, office, or facility location; comparing candidate sites; disaster-preparedness reports. The API is public and free, so no API key or registration is required.
These values are probabilities from a long-term model, not predictions of when an earthquake will occur, and they are 250m-mesh averages that say nothing about a specific building. When you use the results, cite the source (J-SHIS, NIED). Bulk redistribution of the raw data as-is is not permitted by the terms of use.
How to connect J-SHIS Seismic Hazard to Codex
- 1
In the Arlet dashboard, open Data tools, find J-SHIS Seismic Hazard and switch it on. No API key setup is needed.
- 2
In your terminal, run codex mcp add arlet --url https://mcp.arlet.dev/mcp/ to add Arlet as an MCP server.
- 3
Codex detects OAuth support and opens your browser. Sign in with Google and click Allow on the consent screen.
- 4
Once connected, both the CLI and the IDE extension can call Arlet tools (the configuration is shared).
If the browser does not open, run codex mcp login arlet to redo the authentication.
