pegel

Wasserstandsvorhersage

get_forecast

Read-onlyIdempotent

Newest published water-level forecast for a station: the median of the state agency model run, future points within the horizon. Only gauges whose state publishes numeric forecasts have one, so an empty result is normal. Indicative, not an official warning. Every result names the data provider in sourceNotice (search and flood situation: sourceNotices, keyed by sourceNoticeId); show that notice with any value, class or forecast you pass on, and the licence terms of the API require it.

Input Schema

Name	Required	Description	Default
`stationId`	Yes	Namespaced station id, e.g. "lhp:RP_2640010"
`horizonHours`	No	Hours ahead, default 72, capped at 240

Output Schema

Name	Required	Description
`note`	Yes
`unit`	Yes
`count`	Yes
`points`	Yes
`source`	Yes
`stationId`	Yes
`generatedAt`	Yes	Model run time; null when none was published
`horizonHours`	Yes
`sourceNotice`	Yes	Notice of the gauge as shown; show it with any value taken from this gauge. Null where none can be built, then no value is delivered
`valueDivisor`	Yes	Divide valueCentimeters by this to read it in `unit`

Schema Changelog

Changes observed during successful MCP inspections.

Changed2 schema fields changedOct 12, 2026

addedOutput schema / properties / sourceNotice

Added value: +{
+  "anyOf": [
+    {
+      "additionalProperties": {},
+      "properties": {
+        "disclaimer": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Liability disclaimer"
+        },
+        "fetchedAt": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "When the values were fetched, UTC"
+        },
+        "form": {
+          "description": "full-only: show the full text, never shorten; short-allowed",
+          "type": "string"
+        },
+        "id": {
+          "description": "Key of the source record",
+          "type": "string"
+        },
+        "licence": {
+          "anyOf": [
+            {
+              "additionalProperties": {},
+              "properties": {},
+              "type": "object"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "noOfficialWarning": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Statement that the values are no official warning"
+        },
+        "parts": {
+          "items": {
+            "additionalProperties": {},
+            "properties": {
+              "fetchedAt": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "When the values were fetched, UTC"
+              },
+              "form": {
+                "description": "full-only: show the full text, never shorten; short-allowed",
+                "type": "string"
+              },
+              "id": {
+                "description": "Key of the source record",
+                "type": "string"
+              },
+              "licence": {
+                "anyOf": [
+                  {
+                    "additionalProperties": {},
+                    "properties": {},
+                    "type": "object"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              },
+              "permissionBasis": {
+                "type": "string"
+              },
+              "rightsHolder": {
+                "type": "string"
+              },
+              "sourceName": {
+                "type": "string"
+              },
+              "sourceUrl": {
+                "type": "string"
+              },
+              "stampedAt": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "The provider's own time stamp, UTC"
+              },
+              "stationLink": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "Origin page of this gauge where one is required"
+              },
+              "text": {
+                "description": "The full notice as plain text",
+                "type": "string"
+              },
+              "textShort": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "Shortened notice; null where it must never be shortened"
+              }
+            },
+            "required": [
+              "id",
+              "form",
+              "permissionBasis",
+              "licence",
+              "sourceName",
+              "sourceUrl",
+              "rightsHolder",
+              "fetchedAt",
+              "stampedAt",
+              "stationLink",
+              "text",
+              "textShort"
+            ],
+            "type": "object"
+          },
+          "type": "array"
+        },
+        "permissionBasis": {
+          "type": "string"
+        },
+        "rawData": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Notice that the values are preliminary, unchecked raw data"
+        },
+        "rightsHolder": {
+          "type": "string"
+        },
+        "sourceLine": {
+          "description": "Credit line of the provider",
+          "type": "string"
+        },
+        "sourceName": {
+          "type": "string"
+        },
+        "sourceUrl": {
+          "type": "string"
+        },
+        "stampedAt": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "The provider's own time stamp, UTC"
+        },
+        "stationLink": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Origin page of this gauge where one is required"
+        },
+        "termsPath": {
+          "type": "string"
+        },
+        "text": {
+          "description": "The full notice as plain text",
+          "type": "string"
+        },
+        "textShort": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Shortened notice; null where it must never be shortened"
+        }
+      },
+      "required": [
+        "id",
+        "form",
+        "permissionBasis",
+        "licence",
+        "sourceName",
+        "sourceUrl",
+        "rightsHolder",
+        "fetchedAt",
+        "stampedAt",
+        "stationLink",
+        "text",
+        "textShort",
+        "parts",
+        "sourceLine",
+        "rawData",
+        "disclaimer",
+        "noOfficialWarning",
+        "termsPath"
+      ],
+      "type": "object"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "description": "Notice of the gauge as shown; show it with any value taken from this gauge. Null where none can be built, then no value is delivered"
+}

changedOutput schema / required

Previous value: -[
-  "stationId",
-  "horizonHours",
-  "unit",
-  "valueDivisor",
-  "generatedAt",
-  "source",
-  "count",
-  "points",
-  "note"
-]New value: +[
+  "stationId",
+  "horizonHours",
+  "sourceNotice",
+  "unit",
+  "valueDivisor",
+  "generatedAt",
+  "source",
+  "count",
+  "points",
+  "note"
+]

First observedSep 11, 2026

TDQS

A3.9/5.0

Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already cover read-only, idempotent and open-world safety, yet the description adds material context beyond them: the value is a model median (not an observation), it is indicative rather than an official warning, empty results are expected, and passing a value on obliges the caller to display the provider notice per the licence. That is substantive behavioral disclosure.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Front-loaded with the primary purpose and then the interpretive caveats, and nearly every clause carries load (empty result, indicativeness, attribution duty). The closing attribution sentence is dense and slightly over-stuffed but not redundant.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With an output schema present, return structure need not be explained, and the description still covers the non-obvious semantics: expected emptiness, model provenance, and the licence obligation on sourceNotice. An agent has what it needs to call and interpret the tool.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so both stationId and horizonHours (including the 72h default and 240h cap) are already documented in the schema. The description only restates the horizon concept in prose and adds no format or edge-case detail for either parameter, so the baseline 3 is correct.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb+resource ('newest published water-level forecast for a station') and narrows it further to the median of the state agency model run over future points in the horizon. This is clearly distinct from get_readings/get_weather, though no sibling is named explicitly to sharpen the contrast.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Explains the precondition that only gauges whose state publishes numeric forecasts return data and that an empty result is therefore normal, which prevents an agent from misreading a null response. It also points at where the sourceNotice is surfaced elsewhere (search and flood situation), but states no explicit when-not-to-use or alternative tool for observed readings.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All pegel 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?