Skip to content
Eden Engine

England Flood Warnings and Alerts (Environment Agency, Currently in Force)

eafloods/flood-warnings

The flood alerts and warnings the Environment Agency currently has in force across England, from its real-time flood-monitoring API (Beta), refreshed every 15 minutes. Each item gives the affected area's name, county, river or sea, the severity (1 Severe Flood Warning, 2 Flood Warning, 3 Flood Alert, 4 Warning no longer in force), the situation message, and when it was raised and last changed. Filter by county name or by a minimum severity. The list is empty when nothing is in force. A Beta service with no service-level guarantee: not for safety-critical decisions, and no replacement for the Environment Agency's own flood warnings. Attribution: this uses Environment Agency flood and river level data from the real-time data API (Beta). Contains public sector information licensed under the Open Government Licence v3.0.

activeper callv1

Price

$0.00273 per call

You pay the price shown. If a call turns out to cost more than its quote, you pay the actual price, capped at twice the quote. No monthly minimum. Top-ups start at $5.

Data source

Environment Agency

this uses Environment Agency flood and river level data from the real-time data API (Beta). Contains public sector information licensed under the Open Government Licence v3.0. Served by Omnial; not an official Environment Agency product and not endorsed by the Agency.

Use it

Five steps: search, inspect, learn, run, settle. No per-tool setup; your agent reaches this tool through the meta-tools it already has.

Connect once and your AI can find and run this tool, and any other it needs.

agent
// 1. search: find the tool
omnial_search({ query: "what you need" })

// 2. inspect: price and input schema
omnial_inspect({ tool: "eafloods/flood-warnings" })

// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "eafloods/flood-warnings" })

// 4. run: price the exact call first, then run it
omnial_execute({ tool: "eafloods/flood-warnings", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "eafloods/flood-warnings", input: { /* ... */ } })

// 5. settle: the call is charged when it finishes, nothing to do

Not connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.

Pricing

Every charge this tool can incur.

ChargePrice
Per call
$0.00273
Updated
Oct 18, 2026

Input and output schemas

Input schema
input_schema.json
{
  "type": "object",
  "required": [
    "limit"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 500,
      "minimum": 1,
      "description": "How many items to return, 1 to 500. meta.limit in the response confirms the limit applied."
    },
    "county": {
      "type": "string",
      "maxLength": 100,
      "minLength": 2,
      "description": "Only warnings for flood areas whose county name contains this text, for example Somerset. Several counties may be given separated by commas. Omit for all of England."
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "maximum": 100000,
      "minimum": 0,
      "description": "How many items to skip, for paging through a long list. 0 starts at the first."
    },
    "min_severity": {
      "type": "integer",
      "maximum": 4,
      "minimum": 1,
      "description": "Only warnings at least this severe, where 1 is the most severe: 1 Severe Flood Warning, 2 Flood Warning, 3 Flood Alert, 4 Warning no longer in force. Use 3 for everything currently in effect. Omit to include level 4 records, which linger for about a day after a warning lapses."
    }
  },
  "additionalProperties": false
}
Output schema
output_schema.json
{
  "type": "object",
  "required": [
    "meta",
    "items"
  ],
  "properties": {
    "meta": {
      "type": "object",
      "description": "Publisher (Environment Agency), the Open Government Licence URL in licence, the API version, a status comment that reads Beta, and the limit and offset applied.",
      "additionalProperties": true
    },
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "@id": {
            "type": "string",
            "description": "URL of this warning on the Agency's API."
          },
          "isTidal": {
            "type": "boolean",
            "description": "True for a tidal (coastal) flood, false otherwise."
          },
          "message": {
            "type": "string",
            "description": "The current situation message."
          },
          "severity": {
            "type": "string",
            "description": "The severity as the Agency's text label."
          },
          "floodArea": {
            "type": "object",
            "description": "The flood area: county, notation, river or sea, and a link to its polygon.",
            "additionalProperties": true
          },
          "eaAreaName": {
            "type": "string",
            "description": "Environment Agency area responsible."
          },
          "timeRaised": {
            "type": "string",
            "description": "When the warning was last reviewed, local time without an offset."
          },
          "description": {
            "type": "string",
            "description": "Name of the flood area affected."
          },
          "floodAreaID": {
            "type": "string",
            "description": "The Agency's code for the flood area."
          },
          "severityLevel": {
            "type": "integer",
            "description": "1 Severe Flood Warning, 2 Flood Warning, 3 Flood Alert, 4 Warning no longer in force."
          },
          "timeMessageChanged": {
            "type": "string",
            "description": "When the message last changed, local time without an offset."
          },
          "timeSeverityChanged": {
            "type": "string",
            "description": "When the severity level last changed, local time without an offset."
          }
        },
        "additionalProperties": true
      },
      "description": "The warnings and alerts in force, in the Agency's order. Empty when none are in force or none match the filters."
    }
  },
  "description": "The Environment Agency's response: a meta block (publisher, licence, version, comment, limit, offset) and the warnings in items.",
  "additionalProperties": true
}