Japan Agent API
Server Details
Japan JMA warnings, typhoons, volcano levels and municipality code history in English; x402 checks
- Status
- Healthy
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
TDQS
Score is being calculated.
Available Tools
8 toolscatalogRead-onlyInspect
List the tools of this server with prices, data sources, licensing, daily limits and data freshness.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
get_receiptRead-onlyInspect
Re-fetch the stored result of a settled paid call (e.g. jp_trip_impact_check) by its receipt_id, for when the response was lost after payment. Free. Unknown or unsettled receipt ids return RECEIPT_NOT_FOUND. Results are kept for 90 days after settlement.
| Name | Required | Description | Default |
|---|---|---|---|
| receipt_id | Yes | The receipt_id returned with a paid result ("rcpt_" + 64 hex characters). |
jp_municipalityRead-onlyInspect
Look up one Japanese municipality code as of a date (default today): give a 5/6-digit code, or prefecture and name (old names OK). Returns status mapped / split_candidates / unknown / invalid, the valid code with English and Japanese names, change type and date (merger, incorporation, division, designated city, name change), confirmed JMA warning areas only, and J-LIS convenience-store certificate availability for 8 certificate types. Facts only, from e-Stat LOD (CC BY 4.0) and J-LIS.
| Name | Required | Description | Default |
|---|---|---|---|
| code | No | Municipality code: 5 digits, or 6 digits including the check digit (e.g. 22131 or 221317). | |
| name | No | Municipality or ward name in Japanese (old names accepted; a ward may be prefixed with its city) or its e-Stat English name (e.g. "Naka-ku", "Hamamatsu-shi"). Use with prefecture. | |
| as_of | No | YYYY-MM-DD. The date the answer is for (default: today in Japan time). | |
| prefecture | No | Japanese prefecture: English name (e.g. "Tokyo", "Osaka", "Hokkaido"; "Tokyo-to" and "Osaka Prefecture" also work), Japanese name in kanji, or JIS code "01".."47". Use with name. |
jp_municipality_batchRead-onlyInspect
Batch (up to 50) Japanese municipality code lookups as of a date, from e-Stat LOD change history (CC BY 4.0): status mapped / split_candidates (all successors, not apportioned) / unknown / invalid, the code valid on as_of with English and Japanese names, change type and date, confirmed JMA warning areas only, and J-LIS convenience-store certificate availability (available / not_listed / unknown). Facts only; no document preparation or legal advice. Retrying with the same payment is not charged.
| Name | Required | Description | Default |
|---|---|---|---|
| as_of | No | Default as_of for items that do not set their own. | |
| items | Yes | 1 to 50 lookups; each gives code, or prefecture and name. |
jp_trip_impact_checkRead-onlyInspect
Check a Japan itinerary [{date, prefecture}] against JMA warnings/advisories in effect now. Per stop: matched_advisory (with severity), no_match_in_checked_sources (NOT a statement of no impact) or unknown (data missing, or date not today/tomorrow JST). Returns checked sources and areas, unchecked areas, issued_at, retrieved_at, and current JMA typhoon bulletins (listed, not matched). No forecast. Retrying with the same payment is not charged; use receipt_id with get_receipt.
| Name | Required | Description | Default |
|---|---|---|---|
| itinerary | Yes |
jp_typhoonsRead-onlyInspect
Typhoons JMA is currently issuing bulletins for: number, name, center position, central pressure, maximum wind, issue time, and forecast-circle centers, radii and times, relayed as structured JSON from JMA bulletins (VPTW60-65). No independent forecast, interpolation or track extension.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
jp_volcanoesRead-onlyInspect
Current JMA Volcanic Alert Levels (1-5) or warning kinds for volcanoes without levels, for all JMA-monitored volcanoes or one (name in English or Japanese, or 3-digit JMA code): JMA English and Japanese names, level, previous level and change, issue time, prefectures named in JMA bulletins, source URL and freshness receipt. Relay only; no forecast or interpretation. Volcanoes with no bulletin seen yet are not_seen_in_checked_feeds, never assumed level 1.
| Name | Required | Description | Default |
|---|---|---|---|
| volcano | No | Optional. JMA volcano name in English (e.g. "Sakurajima", "Asamayama") or Japanese (e.g. "桜島"), or the 3-digit JMA volcano code (e.g. "506"). Omit to list all volcanoes. |
jp_warningsRead-onlyInspect
Current Japan Meteorological Agency (JMA) weather emergency warnings, warnings and advisories for one prefecture, as structured JSON in English and Japanese (type, level, status, areas with JMA's English names, issued_at, source URL). Relay only; no independent forecast.
| Name | Required | Description | Default |
|---|---|---|---|
| prefecture | Yes | Japanese prefecture: English name (e.g. "Tokyo", "Osaka", "Hokkaido"; "Tokyo-to" and "Osaka Prefecture" also work), Japanese name in kanji, or JIS code "01".."47". | |
| include_municipalities | No | Also list every municipality (Japanese and English names) per warning. Default false. |
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
8 tool updates
- First observed
catalog - First observed
get_receipt - First observed
jp_municipality - First observed
jp_municipality_batch - First observed
jp_trip_impact_check - First observed
jp_typhoons - First observed
jp_volcanoes - First observed
jp_warnings
Related MCP Connectors
Japan: next bus/tram/boat from 26 places, RTK bases, JMA warnings, municipality facts. No key.
JMA (Japan Meteorological Agency) MCP — keyless weather forecasts, warnings,
Disaster risk for any Japanese address from official government data. 6 hazards, sources cited.
Japan business days & holidays (official Cabinet Office data). Free tool + x402 USDC paid tools.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceEnables you to retrieve JMA weather forecasts, warnings/advisories, and earthquake reports by place name, with no API key required.26 npmMIT
- AlicenseAqualityAmaintenanceProvides access to Japan Meteorological Agency (JMA) weather data including real-time observations, historical weather data, and forecasts from 1286 AMeDAS stations across Japan.111MIT
- MIT
- AlicenseAqualityBmaintenanceJapan Operations OS for AI agents — 14 knowledge domains covering regulations, protocols, calendar, travel, food culture, language, disaster safety, daily life, and persistent memory. 31 MCP tools via REST + Streamable HTTP.31MIT
Glama MCP Gateway
Add one secure layer between your agents and this server.