# alerts.live MCP

A public, read-only [Model Context Protocol](https://modelcontextprotocol.io) server for [alerts.live](https://alerts.live): live protests, strikes, road closures, gatherings, shootings, assaults and other street incidents detected in public news and official open-data sources.

- **Endpoint (Streamable HTTP):** `https://alerts.live/mcp`
- **Auth:** none (public). No account data is exposed.
- **Cap:** same as the anonymous map (`/api/events`): at most 500 events per search, newest first. Default window 12 hours; `since` may reach back 7 days, still capped at 500.
- **Rate limit:** 60 requests/minute per IP.
- **Licence:** do **not** treat this as CC BY or any other Creative Commons grant. Each item includes the original source link; **that source keeps its own terms**. A licence decision for the aggregated feed is pending. Cite “Data: alerts.live” and the source URL. Informational only — not an official source; never rely on it for safety-critical decisions. No police-position data.

## Tools

- `search_alerts` — find public alerts near a lat/lon or a place name. Arguments: `lat`, `lon` **or** `place`; `radius_km` (default 25, max 200); `categories` (see `list_categories`); `since` (ISO-8601 or `3h`/`12h`/`7d`, default 12h, max 7d); `limit` (default 50, max 500).
- `get_alert` — one public alert by numeric `id`, including source links.
- `list_categories` — category names you can pass to `search_alerts` / `area_summary`.
- `area_summary` — counts by category (and a few sample alerts) for the same `near`/`place`/`radius_km`/`since` window.

Every alert includes `sources[].url` and a per-source terms notice.

## Connect

**Claude** (Claude.ai or Claude Desktop, custom connector / remote MCP): add a connector with URL `https://alerts.live/mcp` (Streamable HTTP). No API key.

**ChatGPT** (ChatGPT with remote MCP / custom connectors, or a Custom GPT action pointing at this endpoint): add an MCP server with URL `https://alerts.live/mcp`. No API key.

**Cursor:** in `.cursor/mcp.json` (project) or `~/.cursor/mcp.json` (user):

```json
{
  "mcpServers": {
    "alerts-live": {
      "url": "https://alerts.live/mcp"
    }
  }
}
```

Docs: [https://alerts.live/en/developers#mcp](https://alerts.live/en/developers#mcp). Terms: [https://alerts.live/en/developers#terms](https://alerts.live/en/developers#terms). This file: [https://alerts.live/skill.md](https://alerts.live/skill.md).
