Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@RedAlert MCP Server Show me active alerts right now"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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.
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
Related MCP server: Miklat MCP
Tool | Description |
| Real-time snapshot of cities currently under alert |
| Alert totals, top cities/zones/origins, timeline, peak hour |
| Per-city alert statistics with pagination and search |
| Historical alert records with city filtering |
| Alert distribution by category or origin |
| Find nearby shelters by coordinates or city name |
| City catalog with translations, coordinates, countdown |
| API health check |
Tool | Description |
| Connect to Socket.IO and start receiving alerts |
| Retrieve buffered alerts (peek or acknowledge) |
| Disconnect and clear buffer |
| Check connection state and buffer size |
Node.js 18+
A RedAlert API key (get one at redalert.orielhaim.com)
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"
}
}
}Add to claude_desktop_config.json:
{
"mcpServers": {
"redalert": {
"command": "npx",
"args": ["-y", "redalert-mcp-server"],
"env": {
"REDALERT_API_KEY": "your-api-key-here"
}
}
}
}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"
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.
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.
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.
# Unit tests (91 tests)
npm test
# E2E tests against live API (56 tests)
REDALERT_API_KEY=your-key node e2e/run-e2e.mjssrc/
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 plansBased on RedAlert API by Oriel Haim.
MIT
Get real-time snapshot of cities currently under alert, grouped by alert type (missiles, earthquakes, etc.)
Inputs: no named parameters.
Check the current real-time alert subscription status including connection state, subscribed types, and buffer size.
Inputs: no named parameters.
Get city catalog for lookups - raw location records with optional translations, coordinates, and countdown times
Inputs: search, zone, limit, offset, +1 more.
Get city-level alert statistics with pagination, search, and optional translations/coordinates
Inputs: startDate, endDate, limit, offset, +3 more.
Get alert distribution grouped by category or origin, with filtering, sorting, and pagination
Inputs: startDate, endDate, origin, groupBy, +5 more.
Get detailed historical alert records with full city data, filtering, sorting, and pagination
Inputs: startDate, endDate, limit, offset, +8 more.
Get high-level overview of the alert system: totals, unique cities/zones, and optional top cities/zones/origins/timeline/peak data
Inputs: startDate, endDate, origin, include, +2 more.
Check the health status of the RedAlert API
Inputs: no named parameters.
Retrieve buffered real-time alerts that arrived since the last poll. Must call subscribe_alerts first.
Inputs: limit, acknowledge.
Find nearby shelters. Provide lat/lon directly, or just a city name to auto-resolve coordinates.
Inputs: lat, lon, city, limit, +3 more.
Connect to RedAlert Socket.IO server and start receiving real-time emergency alerts. Optionally filter by alert types and enable test mode for simulated alerts.
Inputs: alertTypes, testMode, timing.
Disconnect from RedAlert Socket.IO server and stop receiving real-time alerts. Clears the alert buffer.
Inputs: no named parameters.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 12 tools
Each tool has a clearly distinct purpose: current alerts, historical stats, real-time subscription, shelters, health check. No two tools overlap in functionality.
Tools mostly follow a verb_noun snake_case pattern (e.g., get_active_alerts, subscribe_alerts). 'health_check' deviates slightly, but overall consistent.
12 tools cover the domain well—real-time alerts, stats, shelters, health—without being excessive or sparse.
The toolset covers all essential operations: viewing active alerts, subscribing/polling real-time data, accessing historical statistics, and finding shelters. No obvious gaps.
data.gov.il MCP — Israel national open-data portal (CKAN API).
Public Data Ukraine Mcp connects AI agents to real public APIs via MCP. Tools include
Enrich, search, assess, and manage threat intelligence through 80+ typed MCP tools.
135 MCP tools: geo, email, phone, company, DNS, FX, equities, weather, tax, econ, intel — one key.
