Skip to main content
Glama
ozba

RedAlert MCP Server

by ozba
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

RedAlert MCP Server

An MCP (Model Context Protocol) server for Israel's RedAlert emergency alert system. Provides real-time rocket alerts, historical statistics, shelter search, and city data through 12 MCP tools.

Features

  • Real-time alerts via Socket.IO with buffered polling model

  • Historical statistics - summaries, per-city stats, alert history, distribution

  • Shelter search - find nearby shelters by coordinates or city name

  • City catalog - lookup cities with translations, coordinates, and countdown times

  • Test mode - connect to the test server for simulated alerts

Tools

REST API Tools (8)

Tool

Description

get_active_alerts

Real-time snapshot of cities currently under alert

get_stats_summary

Alert totals, top cities/zones/origins, timeline, peak hour

get_stats_cities

Per-city alert statistics with pagination and search

get_stats_history

Historical alert records with city filtering

get_stats_distribution

Alert distribution by category or origin

search_shelters

Find nearby shelters by coordinates or city name

get_cities

City catalog with translations, coordinates, countdown

health_check

API health check

Real-time Tools (4)

Tool

Description

subscribe_alerts

Connect to Socket.IO and start receiving alerts

poll_alerts

Retrieve buffered alerts (peek or acknowledge)

unsubscribe_alerts

Disconnect and clear buffer

get_alert_subscription_status

Check connection state and buffer size

Setup

Prerequisites

Configure in Claude Code

Add to ~/.claude.json under your project's mcpServers:

{
  "redalert": {
    "type": "stdio",
    "command": "npx",
    "args": ["-y", "redalert-mcp-server"],
    "env": {
      "REDALERT_API_KEY": "your-api-key-here"
    }
  }
}

Configure in Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "redalert": {
      "command": "npx",
      "args": ["-y", "redalert-mcp-server"],
      "env": {
        "REDALERT_API_KEY": "your-api-key-here"
      }
    }
  }
}

Usage Examples

Once configured, you can ask Claude:

  • "Show me active alerts right now"

  • "Find all missile alerts in Kfar Saba in the last 24 hours"

  • "Search for shelters near Tel Aviv"

  • "Get alert statistics summary with top cities"

  • "Subscribe to test alerts and poll for updates"

  • "Compare missile alerts between Kfar Saba and Shoham in the last 2 months"

Example: City Comparison

Prompt: "Compare the missile alerts in the last 2 months between Kfar Saba and Shoham"

┌──────────────────────────┬───────────────┬───────────────┐
│                          │   Kfar Saba   │    Shoham     │
├──────────────────────────┼───────────────┼───────────────┤
│ Zone                     │ Sharon        │ Yarkon        │
├──────────────────────────┼───────────────┼───────────────┤
│ Missile alerts           │ 64            │ 77            │
├──────────────────────────┼───────────────┼───────────────┤
│ Total alerts (all types) │ 205           │ 217           │
├──────────────────────────┼───────────────┼───────────────┤
│ Last missile alert       │ Mar 14, 12:43 │ Mar 13, 21:22 │
└──────────────────────────┴───────────────┴───────────────┘

Shoham had ~20% more missile alerts than Kfar Saba over this period (77 vs 64).
Both cities had a similar ratio of missile alerts to total alerts (~31-35%).

Claude automatically uses get_stats_cities and get_stats_history to gather and compare data across cities.

Example: Weekly Alert Summary (Hebrew)

Prompt: "תראה לי את כל ההתראות שהיו לכפר סבא בשבוע האחרון"

הנה כל ההתראות בכפר סבא בשבוע האחרון (7-14 במרץ):

| תאריך ושעה (UTC) | סוג התראה            |
|-------------------|----------------------|
| 14/3, 13:04       | טילים               |
| 14/3, 12:43       | טילים               |
| 14/3, 12:39       | ידיעה מקדימה         |
| 14/3, 00:30       | ידיעה מקדימה         |
| 13/3, 21:22       | טילים               |
| 13/3, 17:31       | טילים               |
| 13/3, 17:26       | ידיעה מקדימה         |
| 13/3, 14:58       | ידיעה מקדימה         |
| 13/3, 11:26       | ידיעה מקדימה         |
| 13/3, 08:49       | חדירת כלי טיס עוין   |
| 12/3, 19:42       | טילים               |
| 12/3, 19:38       | ידיעה מקדימה         |
| 12/3, 15:19       | חדירת כלי טיס עוין   |
| 12/3, 13:03       | טילים               |
| 12/3, 12:57       | ידיעה מקדימה         |
| 12/3, 07:22       | ידיעה מקדימה         |
| 12/3, 02:13       | טילים               |
| 12/3, 02:07       | ידיעה מקדימה         |

סיכום השבוע בכפר סבא:
- 8 התראות טילים
- 8 ידיעות מקדימות
- 2 חדירות כלי טיס עוין

Claude uses get_stats_history with Hebrew city search, automatically filtering results to show only Kfar Saba. Works in any language.

Example: Nearest Shelters

Prompt: "תראה לי את שלושת המקלטים הכי קרובים לתיאטרון הבימה בתל אביב"

שלושת המקלטים הקרובים ביותר לתיאטרון הבימה:

| # | מרחק   | כתובת                     | שם                   | סוג                  | שטח       |
|---|--------|---------------------------|----------------------|----------------------|-----------|
| 1 | 143 מ' | הוברמן 4 (כיכר הבימה)      | הבימה/שד' בן ציון     | מקלט בשטח חניון       | 2,000 מ"ר |
| 2 | 154 מ' | הוברמן 1                  | היכל התרבות           | חניון מחסה לציבור     | 37,200 מ"ר|
| 3 | 260 מ' | ביל"ו 54                  | -                    | מקלט ציבורי          | 92 מ"ר    |

- מקלט 1 - ממש בכיכר הבימה, גישה ציבורית
- מקלט 2 - היכל התרבות, החניון הגדול משמש כמחסה לציבור
- מקלט 3 - ביל"ו 54 פינת מרמורק 20, מתחת לבית כנסת

Claude resolves the landmark to coordinates and uses search_shelters to find the nearest shelters with full details.

Testing

# Unit tests (91 tests)
npm test

# E2E tests against live API (56 tests)
REDALERT_API_KEY=your-key node e2e/run-e2e.mjs

Architecture

src/
  api/          # HTTP client and API endpoint wrappers
  tools/        # MCP tool handlers (one per endpoint)
  realtime/     # Socket.IO connection manager and alert buffer
  __tests__/    # Unit tests (vitest)
  config.ts     # Configuration and API key
  errors.ts     # Error handling and MCP error mapping
  server.ts     # MCP server setup
  index.ts      # Entry point with stdio transport
e2e/            # End-to-end test runner and test plans

API Reference

Based on RedAlert API by Oriel Haim.

License

MIT

Install Server
A
license - permissive license
A
quality
C
maintenance

How are these scores calculated?

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/ozba/redalert-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server