Japan Agent API
Server Details
Japan JMA warnings, typhoons, volcano levels and municipality code history in English; x402 checks
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 8 tools
Each tool targets a distinct data product: municipality lookup (single vs. batch is explicitly signalled by the name and 50-item limit), warnings, typhoons, volcanoes, itinerary matching, plus two clearly separate utilities (catalog, get_receipt). jp_trip_impact_check could superficially overlap with jp_warnings, but its description makes clear it matches advisories against itinerary stops rather than relaying alerts. No two tools appear to do the same thing.
Six of eight tools share a clean jp_<domain-noun> snake_case convention (jp_municipality, jp_municipality_batch, jp_warnings, jp_typhoons, jp_volcanoes, jp_trip_impact_check). The meta tools catalog and get_receipt drop the prefix and use a different style (bare noun / verb_noun), which is a minor but visible deviation.
Eight tools is well within the ideal range and each earns its place: five data tools covering distinct hazard/administrative domains, one batch variant, one payment-recovery tool, and one discovery tool. Nothing looks padded or redundant.
The surface covers municipal codes, weather warnings, typhoons, and volcanoes with receipt recovery for lost results, but for a Japan hazard API the absence of earthquake/tsunami tools is a notable gap, as is the lack of any historical or forecast lookups (the latter explicitly out of scope). Agents needing seismic information have no path within this server.
Available Tools
8 toolscatalogCatalog: tools, prices and limitsARead-onlyInspect
List the tools of this server with prices, data sources, licensing, daily limits and data freshness.
Inputs: no named parameters. Returns: legal, terms, tools, paused, +5 more
get_receiptGet receipt of a paid callARead-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 30 days after settlement.
Inputs: receipt_id (required). Returns: tool, terms, result, payment, +3 more
jp_municipalityJapan municipality code lookupARead-onlyInspect
Which code does this Japanese municipality have on 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.
Inputs: code, name, as_of, prefecture. Returns: as_of, input, terms, source, +12 more
jp_municipality_batchJapan municipality batch lookup (paid)ARead-onlyInspect
Which codes are valid on a date for up to 50 Japanese municipalities? 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.
Inputs: items (required), as_of. Returns: Either the paid result (with receipt_id) or, with isError true, the x402 Paymen…
jp_trip_impact_checkJapan trip impact check (paid)ARead-onlyInspect
Does a JMA warning or advisory in effect now match a stop on this Japan itinerary [{date, prefecture}]? Per stop: matched_advisory (with severity), no_match_in_checked_sources (NOT a statement of no impact) or unknown (no data, or date not today/tomorrow JST). Returns checked/unchecked areas and sources, issued_at, retrieved_at, and current JMA typhoon/volcano bulletins (listed, not matched). No forecast. No charge if all stops are unknown. Retries with the same payment are free (get_receipt).
Inputs: itinerary (required). Returns: Either the paid result (with receipt_id) or, with isError true, the x402 Paymen…
jp_typhoonsJapan typhoon bulletins (JMA)ARead-onlyInspect
Which typhoons is JMA issuing bulletins for right now, and what do the bulletins forecast? 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.
Inputs: no named parameters. Returns: note, count, ended, terms, +9 more
jp_volcanoesJapan volcanic alert levels (JMA)ARead-onlyInspect
What is the current JMA Volcanic Alert Level (1-5, or warning kind) of this volcano or of every JMA-monitored volcano? Name in English or Japanese, or 3-digit JMA code. Returns 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. Gaps filled from JMA website lists (newer wins). No JMA source seen = not_seen_in_checked_feeds, never assumed level 1.
Inputs: volcano. Returns: note, count, terms, source, +6 more
jp_warningsJapan weather warnings by prefecture (JMA)ARead-onlyInspect
Which JMA weather emergency warnings, warnings and advisories are in effect in this Japanese prefecture now? Structured JSON in English and Japanese (type, level, status, areas with JMA's English names, issued_at, source URL). Relay only; no independent forecast.
Inputs: prefecture (required), include_municipalities. Returns: terms, counts, region, source, +12 more
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
JMA weather warnings by prefecture.
JMA volcano warnings and eruption forecasts.
Japan: next bus/tram/boat from 26 places, RTK bases, JMA warnings, municipality facts. No key.
Live JMA earthquake bulletins and intensity reports for Japan.
Related MCP Servers
- AlicenseAqualityBmaintenanceEnables access to Japan Meteorological Agency data through MCP, covering weather forecasts, warnings, earthquakes with seismic intensity, tsunami bulletins, and volcano alerts, with place-name lookup in kanji, kana, or romaji and no API key.7MIT
- AlicenseNot gradedqualityBmaintenanceEnables you to retrieve JMA weather forecasts, warnings/advisories, and earthquake reports by place name, with no API key required.88 npmMIT
- AlicenseAqualityBmaintenanceProvides access to Japan Meteorological Agency (JMA) weather data including real-time observations, historical weather data, and forecasts from 1286 AMeDAS stations across Japan.111MIT
- FlicenseNot gradedqualityCmaintenanceHuman-verified Easy Japanese (yasashii nihongo) versions of Japanese administrative procedures and disaster-preparedness information, written from primary government sources. Not a government site. CC BY 4.0.-
Glama MCP Gateway
Add one secure layer between your agents and this server.