hazardwatch-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| PORT | No | HTTP listen port when using HTTP transport. | 3000 |
| FIRMS_MAP_KEY | No | Optional NASA FIRMS MAP_KEY. 32 letters or digits. Without it, FIRMS fire tools return a [config] error, while EONET tools still work. | |
| MCP_TRANSPORT | No | Transport mode: stdio or http. The --http CLI flag forces HTTP. | stdio |
| EONET_BASE_URL | No | EONET v3 origin. | https://eonet.gsfc.nasa.gov/api/v3 |
| FIRMS_BASE_URL | No | Origin only for the FIRMS API. No userinfo, query, or hash. | https://firms.modaps.eosdis.nasa.gov |
| EONET_PER_MINUTE | No | Local EONET sliding-window rate limit per minute. | 30 |
| HAZARDWATCH_CONTACT | No | Contact included in the User-Agent. Must not contain the MAP_KEY. | contact@example.com |
| HAZARDWATCH_TIMEOUT_MS | No | Upstream request timeout in milliseconds. | 20000 |
| HAZARDWATCH_CACHE_TTL_SEC | No | TTL for successful responses in seconds. Set to 0 to disable the cache. | 60 |
| FIRMS_TRANSACTIONS_PER_10_MIN | No | Local cap for FIRMS transactions per 10 minutes. Cannot be set above 5000. | 5000 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| fires_nearA | Active fire hotspots from NASA FIRMS. Pass latitude, longitude, and radius_km (kilometers, greater than 0 and at most 2500), or west, south, east, and north in degrees. A point query keeps hotspots within radius_km, nearest first. day_range is an integer from 1 to 5. source defaults to VIIRS_NOAA21_NRT. Suomi-NPP deliveries are scheduled to stop on 2026-11-02. Requires FIRMS_MAP_KEY. Not for safety-of-life decisions. |
| fires_by_countryB | Active fire hotspots from NASA FIRMS for one ISO 3166-1 alpha-3 country code. day_range is 1 to 5. The FIRMS country endpoint is marked unavailable on the API index and this tool reports that upstream failure until NASA restores it. Requires FIRMS_MAP_KEY. Not for safety-of-life decisions. |
| eonet_eventsA | Natural-event metadata from NASA EONET v3. Filter with category id, status open, closed, or all, start and end as YYYY-MM-DD, limit, and an optional west, south, east, north bbox. No API key. Events link to third-party sources with their own licenses. Not for safety-of-life decisions. |
| eonet_eventA | One NASA EONET v3 event by id, including categories, sources, and geometries. No API key. Not for safety-of-life decisions. |
| nearby_hazardsA | Open EONET events and FIRMS hotspots within radius_km of a latitude and longitude. limit is an integer from 1 to 50 and caps both the events and the hotspots. Hotspots are the nearest ones. If FIRMS_MAP_KEY is unset or FIRMS fails, events are still returned and firms_note explains why. day_range is 1 to 5. Not for safety-of-life decisions. |
| eonet_categoriesA | List NASA EONET v3 category ids and titles. Pass a category id to eonet_events. No API key. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 6 tools
Each tool targets a distinct resource or filter: point/bbox fires, country fires, EONET list, EONET by id, categories, and the composite proximity view. The main soft spot is nearby_hazards, which overlaps conceptually with fires_near plus eonet_events, though its documented combined/limited semantics make it distinguishable.
All snake_case with a domain-prefix convention (fires_*, eonet_*) plus a domain-less composite nearby_hazards. The pattern is readable and predictable, with the singular/plural eonet_event vs eonet_events pair being the only slight wrinkle.
Six tools is well-scoped for a hazard-watch server, and each earns its place by covering a distinct query shape (point, bbox, country, event list, event detail, categories, combined proximity).
Covers the core lifecycle of both upstream sources plus a convenience composite, with sensible FIRMS-key fallback behavior. The notable gap is fires_by_country, which is documented as broken upstream (a dead end) and there is no alternate country-level path or source-selection tool.