CityAlert

Get live incidents

get_incidents

Read-onlyIdempotent

Merged live incidents from all feeds plus manual reports. Filter by region key, category, group, severity, source, or bbox. Results come from a shared ~15-minute snapshot; real-time refresh requires an API key with that entitlement (details: cityalert.live/developers).

Input Schema

TableJSON Schema

Name	Required	Description
`q`	No	Case-insensitive substring match on type/title/neighbourhood
`bbox`	No	[minLon, minLat, maxLon, maxLat]
`limit`	No	Max incidents to return (default 50)
`detail`	No	Response detail. 'full' (default): every field incl. description, neighbourhood and reporter/vote metadata. 'compact': id/type/title/coords/time/severity/url only — about half the tokens, for list-style answers.
`groups`	No	Normalized subtypes to include, e.g. ['violent','property','collision','wildfire']. See group keys in the /api/incidents OpenAPI doc.
`region`	No	Focus-region key, e.g. 'vancouver' (see list_regions)
`source`	No	Feed source, e.g. 'usgs', 'gdacs', 'eccc', 'vpd', 'bcws', 'vernon-media', 'manual'
`refresh`	No	Re-fetch upstream feeds instead of returning the shared ~15-minute snapshot. Only honored for API keys with real-time entitlement; ignored otherwise.
`category`	No	Incident category
`minSeverity`	No	Minimum severity (low < medium < high < critical)

Output Schema

TableJSON Schema

Name	Required	Description	Default
`feeds`	Yes
`total`	Yes
`region`	No
`delayed`	No
`returned`	Yes
`incidents`	Yes
`delayMinutes`	No
`textTruncated`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed6 schema fields changedOct 10, 2026

changedInput schema / properties / bbox / items

Previous value: -falseNew value: +{
+  "type": "number"
+}

removedInput schema / properties / bbox / prefixItems

Removed value: -[
-  {
-    "type": "number"
-  },
-  {
-    "type": "number"
-  },
-  {
-    "type": "number"
-  },
-  {
-    "type": "number"
-  }
-]

addedInput schema / properties / detail

Added value: +{
+  "description": "Response detail. 'full' (default): every field incl. description, neighbourhood and reporter/vote metadata. 'compact': id/type/title/coords/time/severity/url only — about half the tokens, for list-style answers.",
+  "enum": [
+    "compact",
+    "full"
+  ],
+  "type": "string"
+}

changedInput schema / properties / limit / description

Previous value: -"Max incidents to return (default 250)"New value: +"Max incidents to return (default 50)"

changedInput schema / properties / refresh / description

Previous value: -"Bypass the feed cache and re-fetch sources"New value: +"Re-fetch upstream feeds instead of returning the shared ~15-minute snapshot. Only honored for API keys with real-time entitlement; ignored otherwise."

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "additionalProperties": false,
+  "properties": {
+    "delayMinutes": {
+      "type": "number"
+    },
+    "delayed": {
+      "type": "boolean"
+    },
+    "feeds": {
+      "additionalProperties": false,
+      "properties": {
+        "count": {
+          "type": "number"
+        },
+        "failed": {
+          "items": {
+            "additionalProperties": false,
+            "properties": {
+              "error": {
+                "type": "string"
+              },
+              "source": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "source"
+            ],
+            "type": "object"
+          },
+          "type": "array"
+        }
+      },
+      "required": [
+        "count",
+        "failed"
+      ],
+      "type": "object"
+    },
+    "incidents": {
+      "items": {
+        "additionalProperties": false,
+        "properties": {
+          "approximate": {
+            "type": "boolean"
+          },
+          "category": {
+            "type": "string"
+          },
+          "confirms": {
+            "type": "number"
+          },
+          "count": {
+            "type": "number"
+          },
+          "description": {
+            "type": "string"
+          },
+          "flags": {
+            "type": "number"
+          },
+          "group": {
+            "type": "string"
+          },
+          "id": {
+            "type": "string"
+          },
+          "lat": {
+            "type": "number"
+          },
+          "lon": {
+            "type": "number"
+          },
+          "nhood": {
+            "type": "string"
+          },
+          "region": {
+            "type": "string"
+          },
+          "reporter": {
+            "additionalProperties": false,
+            "properties": {
+              "confirmed": {
+                "type": "number"
+              },
+              "handle": {
+                "type": "string"
+              },
+              "reports": {
+                "type": "number"
+              },
+              "role": {
+                "anyOf": [
+                  {
+                    "enum": [
+                      "curator",
+                      "moderator"
+                    ],
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              }
+            },
+            "required": [
+              "handle",
+              "role",
+              "reports",
+              "confirmed"
+            ],
+            "type": "object"
+          },
+          "resolves": {
+            "type": "number"
+          },
+          "severity": {
+            "type": "string"
+          },
+          "source": {
+            "type": "string"
+          },
+          "sources": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "status": {
+            "enum": [
+              "pending",
+              "active",
+              "resolved",
+              "hidden"
+            ],
+            "type": "string"
+          },
+          "time": {
+            "type": "string"
+          },
+          "title": {
+            "type": "string"
+          },
+          "type": {
+            "type": "string"
+          },
+          "url": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "id",
+          "source",
+          "category",
+          "type",
+          "title",
+          "lat",
+          "lon",
+          "time",
+          "severity"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "region": {
+      "type": "string"
+    },
+    "returned": {
+      "type": "number"
+    },
+    "textTruncated": {
+      "type": "string"
+    },
+    "total": {
+      "type": "number"
+    }
+  },
+  "required": [
+    "total",
+    "returned",
+    "incidents",
+    "feeds"
+  ],
+  "type": "object"
+}

Changed1 schema field changedSep 23, 2026

changedInput schema / properties / category / enum

Previous value: -[
-  "crime",
-  "fire",
-  "disaster",
-  "weather",
-  "unrest",
-  "health",
-  "infra",
-  "report"
-]New value: +[
+  "crime",
+  "fire",
+  "disaster",
+  "weather",
+  "unrest",
+  "health",
+  "infra",
+  "alert",
+  "report"
+]

First observedSep 19, 2026

TDQS

Score is being calculated.

All CityAlert tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?