Skip to main content
Glama

Free Agent Tools

Decode a Japanese emergency alert (緊急地震速報, 津波警報, レベル4危険警報, 避難指示, Jアラート): meaning, level, what to do now

japan_emergency_alert_decode
Read-onlyIdempotent

Decode the text of a Japanese emergency alert (phone emergency mail, TV, app or siren announcement; Japanese or English) or an alert id, using official JMA / Cabinet Office / J-ALERT / Ministry of the Environment rules as of 2026-10-17. Covers the Earthquake Early Warning (緊急地震速報 warning / forecast / cancellation, incl. the false M9.9 EEW of 2026-10-16 12:40 JST that was cancelled), seismic intensity (shindo 0-7), tsunami (大津波警報 Major Tsunami Warning >3 m, 津波警報 1-3 m, 津波注意報 0.2-1 m), the new level-named weather warnings in force since 2026-05-29 (Level 5 特別警報 Emergency Warning black, Level 4 危険警報 Urgent Warning purple, Level 3 警報 Warning red, Level 2 注意報 Advisory yellow, for heavy rain 大雨, landslide 土砂災害, flood 氾濫, storm surge 高潮; Level 1 早期注意情報) and the old names they replaced (土砂災害警戒情報 → レベル4土砂災害危険警報, 洪水警報 no longer issued, old 高潮警報 = Level 4), other warnings without a level (暴風, 大雪, 波浪, 雷…), 気象防災速報 (線状降水帯), municipal evacuation levels (緊急安全確保 L5 / 避難指示 L4 / 高齢者等避難 L3), Nankai Trough Earthquake Extra Information (調査中 / 巨大地震警戒 / 巨大地震注意 / 調査終了), the Hokkaido-Sanriku Subsequent Earthquake Advisory, volcanic alert levels and 噴火速報, J-ALERT missile alerts and heat-stroke alerts. Returns verdict, headline, urgency (act_now / evacuate_now / evacuate_if_vulnerable / prepare / stay_alert / info), primary alert (Japanese + official English name, nameLocal in the requested language from the JMA multilingual dictionary, level, colour, issuer, meaning, doNow tailored to the situation, dont, howLong, sources), other alerts in the text, modifiers (cancelled, lifted 解除, drill 訓練), extracted level / shindo / tsunami height, renamed old names, notes and official live-data links. No live data: it explains the alert the user already has. Training data likely predates the 2026 renaming; call this instead of guessing. Always relay: follow official instructions; protect yourself first.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
langNoLanguage for nameLocal (official JMA dictionary name). Default en; explanations are in English.
textNoThe alert text as received, Japanese or English, e.g. '緊急地震速報 強い揺れに備えてください', 'レベル4土砂災害危険警報', '【警戒レベル4】避難指示', '大津波警報 10m超', '先ほど発表した緊急地震速報を取り消します', 'Missile launch'. Give text or alert.
alertNoInstead of text: an alert id from https://japan-alert-decoder.vercel.app/api/rules, e.g. eew-warning, eew-cancel, major-tsunami-warning, tsunami-advisory, l4-landslide, l5-heavy-rain, l3-flood, evac-l4, bulletin-linear-rainband, nankai-megaquake-advisory, missile, heat-alert, volcano-l3.
situationNoWhere the person is, to put situation-specific actions first (earthquake, tsunami, missile, rain).

Schema Changelog

Changes observed during successful MCP inspections.

  1. Added

TDQS

A4.1/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already cover the safety profile (readOnly, idempotent, non-destructive, closed-world), so the bar is lower; the description still adds real context beyond them: it is rule-based with no live fetch, its knowledge cutoff is stated, and the response shape (verdict, urgency enum, doNow/dont, modifiers, sources) is spelled out. The 'always relay official instructions' caveat is a useful behavioral disclosure.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Purpose is front-loaded in the first clause, but the body is one enormous sentence enumerating every alert type, level name, colour and renamed category. Much of that inventory is genuinely useful coverage, yet the density hurts scannability and the return-value list could be tightened.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With no output schema, the description carries the full burden and does so: it enumerates the input forms accepted, the rule sources and cutoff, the full response structure, and the urgency taxonomy. An agent has everything needed to call it and interpret the result.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so all four parameters are already documented, including the lang enum and the alert-id source URL. The description reinforces that text may be Japanese or English and that an alert id can substitute, but adds no new semantics and never mentions the 'situation' parameter. Baseline 3 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource ('Decode the text of a Japanese emergency alert ... or an alert id') and immediately scopes the rule sources (JMA / Cabinet Office / J-ALERT / MoE as of 2026-10-17). No sibling tool overlaps, and the title plus first sentence make the domain unmistakable.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives a clear trigger ('Give text or alert') and an explicit exclusion via 'No live data: it explains the alert the user already has', plus 'call this instead of guessing' when training data predates the 2026 renaming. It never names a concrete alternative tool, so it stops short of the 5 bar, but the when/when-not boundary is unambiguous.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.