Miklat MCP

@danielrosehill

20 hours ago

About MCP to enable AI agents to guide users towards miklatim tziburim (public shelters) in Israel

Overview

An MCP (Model Context Protocol) server that helps AI agents find public shelters (miklatim tziburim) in Israel. Currently supports Jerusalem with 198 shelters.

MCP Endpoint

https://mcp.jlmshelters.com/mcp

Connect to this URL using any MCP-compatible client with streamable HTTP transport.

Client Configuration

Add this to your MCP client config (e.g. Claude Desktop, Claude Code, Cursor, etc.):

{
  "mcpServers": {
    "miklat": {
      "type": "streamableHttp",
      "url": "https://mcp.jlmshelters.com/mcp"
    }
  }
}

For ChatGPT and other platform-specific setup, see the Integration Guide.

Available Tools

Tool	Parameters	Description
`search_shelters`	`city`, `query`, `limit?`	Free-text search across name, address, neighborhood
`find_nearest_shelters`	`city`, `latitude`, `longitude`, `limit?`	Find nearest shelters by distance
`list_neighborhoods`	`city`	List all neighborhoods with shelter counts
`get_shelter_by_id`	`city`, `id`	Get a single shelter by its feature ID
`get_stats`	`city`	Summary stats: total count, breakdown by type, capacity totals
`list_cities`	(none)	List all supported cities
`get_directions_link`	`city`, `shelter_id`, `origin_latitude`, `origin_longitude`, `app?`	Google Maps / Waze navigation links to a shelter
`filter_shelters`	`city`, `shelter_type?`, `min_capacity?`, `accessible?`, `limit?`	Filter shelters by type, capacity, accessibility
`list_shelters_in_neighborhood`	`city`, `neighborhood`, `limit?`	List all shelters in a specific neighborhood

Supported Cities

jerusalem — 198 public shelters

Adding New Cities

Place a GeoJSON file at src/data/<city>/shelters.json following the same schema as the Jerusalem data, then register it in the cityData map in src/index.ts.

Development

npm install
npm run dev          # Start local dev server at http://localhost:8787
npm run deploy       # Deploy to Cloudflare Workers

Testing

npx @anthropic-ai/mcp-inspector
# Point it at http://localhost:8787/mcp

Cloudflare Configuration

The parent domain jlmshelters.com has a WAF custom rule ("Israel Only") that blocks non-Israeli traffic. The MCP subdomain is excluded so it can be accessed globally:

(ip.src.country ne "IL" and http.host ne "mcp.jlmshelters.com")

Data Source

Shelter data is sourced from the JLM-Shelters-Dot-Com project. Licensed under ODbL (Open Database License).

Disclaimer

This tool is provided for informational purposes only. Shelter data is gathered periodically from official sources and no guarantee is offered as to its accuracy or completeness. Shelters may be added, removed, or changed between updates. Do not rely solely on this data for personal safety or emergency preparedness. Always verify shelter locations with official municipal sources and follow instructions from local authorities during emergencies.

All MCP tool responses include a short disclaimer reminding users of these limitations.

Try in Playground

Server Config

{
  "mcpServers": {
    "miklat": {
      "type": "streamableHttp",
      "url": "https://mcp.jlmshelters.com/mcp"
    }
  }
}

Build with ShipAny.