ViaFrei

Official21 tools

by mavrovde · JavaScript

German open mobility data: Autobahn traffic, trains, transit, fuel, charging, parking, weather.

de.viafrei/mcp (MCP Server)

This MCP server provides access to German open mobility data across multiple transportation and services domains. Its scope includes Autobahn traffic, trains, transit, fuel, charging, parking, and weather, as described in its catalog entry.

🛠️ Key Features

German open mobility data
Coverage includes: Autobahn traffic, trains, transit
Coverage includes: fuel, charging, parking, weather

🚀 Use Cases

Retrieve mobility-related datasets for Germany across road, rail, and transit contexts
Access infrastructure and services data such as fuel and charging
Use weather information alongside transportation data

⚡ Developer Benefits

Structured grouping of mobility topics (traffic, rail, transit, fuel/charging/parking, weather)
Clear domain focus on German open mobility data

⚠️ Limitations

Available details do not specify supported MCP tools, tool count, or API endpoints

Topics

germanymcpmodel-context-protocolopen-datatransporttypescriptai-agentsautobahnclaudedeutsche-bahnev-charginggeocodingllm-toolsmcp-servernodejsopenstreetmapstreamable-httpweather

Captured live from the server via tools/list.

check_autobahn_traffic

Jams, slow traffic, closures and roadworks in force this minute on up to 5 motorways, with delay/speed. Use when asked about a named motorway now: Stau, a delay, how it looks, or a LIST of closures now; name every motorway (Munich→Berlin: A9). Do NOT use for yes/no: is a road open/closed/passable — check_road_status, even now — nor a closure with no time word or a later one (tonight, weekend); Baustellen dated or geplant — find_roadworks_ahead; Stau in a town, no motorway — check_road_status; fuel (find_cheapest_fuel), trains (get_train_departures). ~5 min old. Show the attribution line.

Parameters5

roads	array	required	Autobahn numbers, e.g. ["A9"] or ["A8", "A99", "A9"] (1–5 per call). Name every motorway on the route so the whole drive is briefed in one call — "A9", "A 9" and "a9" are the same road. Results are grouped per road, in the order you list them.
language	string	optional	Set this on every call to the language the person is writing in: "en" if they wrote English, "de" if they wrote German. Do not leave it out because it has a default — the default is only the fallback when the language is genuinely unclear, and an English question answered in German is a wrong answer. Place names, station names and road numbers are never translated in either language; in English the German term is kept in parentheses so the person recognises it on signs and in local apps.
kinds	array	optional	Which event kinds to return: warning = live traffic (jams, slow traffic, hazards), closure = full closures, roadworks = construction sites. Set it when the SUBJECT of the question is one of those categories by name: "Baustellen auf der A8?" is ["roadworks"], "welche Sperrungen sind in diesem Moment gemeldet?" is ["closure"]. Omit it when the question is how the road IS — Stau, frei, a delay, "wie sieht es aus", "everything"; the German "Stau?" is the idiom for the whole picture, and a filter nobody asked for hides the closure on the same stretch. Whether a closure question is this tool's at all is decided by two things, and the noun (Sperrung, Vollsperrung, closure) is neither. FIRST THE CLOCK: only a question about this minute (jetzt, gerade, in diesem Moment, right now, at this very minute) can be this tool's — with no time word at all, or for a later window (tonight, heute Abend, am Wochenende, the coming days), it is check_road_status. SECOND, WHAT IS ASKED, which the clock cannot see: what is REPORTED or in force on a named motorway is this tool ("which closures are in force on the A100 at this very minute?"), while whether the road is OPEN or passable is check_road_status AT ANY CLOCK — "ist die A8 offen", "ist die A3 in diesem Moment gesperrt?", "komme ich da durch?" — and so is a closure asked around a town instead of on a motorway number. Baustellen with a date or the word geplant are find_roadworks_ahead. Default: all three.
limit	integer	optional	Maximum events to return across all roads (1–50, default 10). Jams on every road come first, then closures and roadworks; roads keep the order you listed them within each. Only what is in force now is listed — closures announced for later are counted apart in the headline.
cursor	string	optional	Pagination cursor from a previous result's _meta.nextCursor. Omit for the first page.

Raw schema

{
  "type": "object",
  "properties": {
    "roads": {
      "minItems": 1,
      "maxItems": 5,
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^[Aa] ?\\d{1,3}$"
      },
      "description": "Autobahn numbers, e.g. [\"A9\"] or [\"A8\", \"A99\", \"A9\"] (1–5 per call). Name every motorway on the route so the whole drive is briefed in one call — \"A9\", \"A 9\" and \"a9\" are the same road. Results are grouped per road, in the order you list them."
    },
    "language": {
      "default": "de",
      "description": "Set this on every call to the language the person is writing in: \"en\" if they wrote English, \"de\" if they wrote German. Do not leave it out because it has a default — the default is only the fallback when the language is genuinely unclear, and an English question answered in German is a wrong answer. Place names, station names and road numbers are never translated in either language; in English the German term is kept in parentheses so the person recognises it on signs and in local apps.",
      "type": "string",
      "enum": [
        "de",
        "en"
      ]
    },
    "kinds": {
      "default": [
        "warning",
        "closure",
        "roadworks"
      ],
      "description": "Which event kinds to return: warning = live traffic (jams, slow traffic, hazards), closure = full closures, roadworks = construction sites. Set it when the SUBJECT of the question is one of those categories by name: \"Baustellen auf der A8?\" is [\"roadworks\"], \"welche Sperrungen sind in diesem Moment gemeldet?\" is [\"closure\"]. Omit it when the question is how the road IS — Stau, frei, a delay, \"wie sieht es aus\", \"everything\"; the German \"Stau?\" is the idiom for the whole picture, and a filter nobody asked for hides the closure on the same stretch. Whether a closure question is this tool's at all is decided by two things, and the noun (Sperrung, Vollsperrung, closure) is neither. FIRST THE CLOCK: only a question about this minute (jetzt, gerade, in diesem Moment, right now, at this very minute) can be this tool's — with no time word at all, or for a later window (tonight, heute Abend, am Wochenende, the coming days), it is check_road_status. SECOND, WHAT IS ASKED, which the clock cannot see: what is REPORTED or in force on a named motorway is this tool (\"which closures are in force on the A100 at this very minute?\"), while whether the road is OPEN or passable is check_road_status AT ANY CLOCK — \"ist die A8 offen\", \"ist die A3 in diesem Moment gesperrt?\", \"komme ich da durch?\" — and so is a closure asked around a town instead of on a motorway number. Baustellen with a date or the word geplant are find_roadworks_ahead. Default: all three.",
      "minItems": 1,
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "warning",
          "roadworks",
          "closure"
        ]
      }
    },
    "limit": {
      "default": 10,
      "description": "Maximum events to return across all roads (1–50, default 10). Jams on every road come first, then closures and roadworks; roads keep the order you listed them within each. Only what is in force now is listed — closures announced for later are counted apart in the headline.",
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    },
    "cursor": {
      "description": "Pagination cursor from a previous result's _meta.nextCursor. Omit for the first page.",
      "type": "string",
      "maxLength": 256
    }
  },
  "required": [
    "roads"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

find_cheapest_fuel

Returns the cheapest stations for one fuel grade near a place or coordinate: price per litre, brand, address, distance, open state. Use when the user asks where to fill up or what fuel costs. Do NOT use for charging an electric car (call find_charging_station), price history, or traffic (call check_autobahn_traffic). Radius ≤ 25 km, at most 10 stations. For a brand, a name, open now or at a named time, or nearest-first, call find_fuel_station. Each line names the age of its price and opening-hours claim. Prices are consumer information only; the attribution line and MTS-K note must be shown.

Parameters7

place	string	optional	Where to look, as free text: a city ("München", "Munich"), a district or Kreis ("Kreis Fulda"), a Bundesland, a station or stop ("Hamburg Hbf"), a motorway junction ("AK Neufahrn"), or a street address with a house number ("Bahnhofstraße 12, 36037 Fulda"). A motorway number alone ("A7") resolves to the road, which has no single point — name a town or junction on it instead. Use this instead of coordinates whenever the person named a place. An address needs its town or postcode — a street and a number alone exist in many towns. Give either place OR lat+lon, never both.
lat	number	optional	Latitude in WGS 84, e.g. 48.137. Use with lon when the caller already holds coordinates; otherwise use place.
lon	number	optional	Longitude in WGS 84, e.g. 11.576. Use with lat; otherwise use place.
language	string	optional	Set this on every call to the language the person is writing in: "en" if they wrote English, "de" if they wrote German. Do not leave it out because it has a default — the default is only the fallback when the language is genuinely unclear, and an English question answered in German is a wrong answer. Place names, station names and road numbers are never translated in either language; in English the German term is kept in parentheses so the person recognises it on signs and in local apps.
fuel	string	optional	Fuel grade: "e5" (Super E5), "e10" (Super E10, the standard German petrol) or "diesel". Default "e10". Pass the grade the person named — a diesel driver is not helped by a petrol price.
radius_km	number	optional	Search radius around the place in kilometres (1–25, default 5). The provider's terms cap it at 25 km — a larger circle is a dataset request, not a consumer question.
limit	integer	optional	How many stations to return, cheapest first (1–10, default 5). The provider's terms cap it at 10.

Raw schema

{
  "type": "object",
  "properties": {
    "place": {
      "description": "Where to look, as free text: a city (\"München\", \"Munich\"), a district or Kreis (\"Kreis Fulda\"), a Bundesland, a station or stop (\"Hamburg Hbf\"), a motorway junction (\"AK Neufahrn\"), or a street address with a house number (\"Bahnhofstraße 12, 36037 Fulda\"). A motorway number alone (\"A7\") resolves to the road, which has no single point — name a town or junction on it instead. Use this instead of coordinates whenever the person named a place. An address needs its town or postcode — a street and a number alone exist in many towns. Give either place OR lat+lon, never both.",
      "type": "string",
      "minLength": 1,
      "maxLength": 120
    },
    "lat": {
      "description": "Latitude in WGS 84, e.g. 48.137. Use with lon when the caller already holds coordinates; otherwise use place.",
      "type": "number",
      "minimum": -90,
      "maximum": 90
    },
    "lon": {
      "description": "Longitude in WGS 84, e.g. 11.576. Use with lat; otherwise use place.",
      "type": "number",
      "minimum": -180,
      "maximum": 180
    },
    "language": {
      "default": "de",
      "description": "Set this on every call to the language the person is writing in: \"en\" if they wrote English, \"de\" if they wrote German. Do not leave it out because it has a default — the default is only the fallback when the language is genuinely unclear, and an English question answered in German is a wrong answer. Place names, station names and road numbers are never translated in either language; in English the German term is kept in parentheses so the person recognises it on signs and in local apps.",
      "type": "string",
      "enum": [
        "de",
        "en"
      ]
    },
    "fuel": {
      "default": "e10",
      "description": "Fuel grade: \"e5\" (Super E5), \"e10\" (Super E10, the standard German petrol) or \"diesel\". Default \"e10\". Pass the grade the person named — a diesel driver is not helped by a petrol price.",
      "type": "string",
      "enum": [
        "e5",
        "e10",
        "diesel"
      ]
    },
    "radius_km": {
      "default": 5,
      "description": "Search radius around the place in kilometres (1–25, default 5). The provider's terms cap it at 25 km — a larger circle is a dataset request, not a consumer question.",
      "type": "number",
      "minimum": 1,
      "maximum": 25
    },
    "limit": {
      "default": 5,
      "description": "How many stations to return, cheapest first (1–10, default 5). The provider's terms cap it at 10.",
      "type": "integer",
      "minimum": 1,
      "maximum": 10
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

find_fuel_station

Finds filling stations around a place or coordinate under any combination of filters — grade, brand, name, open now, open at a time you name, open 24 h — sorted by distance, price or name. Use when the question is WHICH station: the closest diesel to a stop, an ARAL open tonight, what one forecourt sells. Do NOT use for the plain "where is fuel cheapest" question (call find_cheapest_fuel) or for charging an electric car (call find_charging_station). Every result carries the attribution and the MTS-K note, and says how old each price and opening-hours claim is.

Parameters13

place	string	optional	Where to look, as free text: a city ("München", "Munich"), a district or Kreis ("Kreis Fulda"), a Bundesland, a station or stop ("Hamburg Hbf"), a motorway junction ("AK Neufahrn"), or a street address with a house number ("Bahnhofstraße 12, 36037 Fulda"). A motorway number alone ("A7") resolves to the road, which has no single point — name a town or junction on it instead. Use this instead of coordinates whenever the person named a place. An address needs its town or postcode — a street and a number alone exist in many towns. Give either place OR lat+lon, never both.
lat	number	optional	Latitude in WGS 84, e.g. 48.137. Use with lon when the caller already holds coordinates; otherwise use place.
lon	number	optional	Longitude in WGS 84, e.g. 11.576. Use with lat; otherwise use place.
language	string	optional	Set this on every call to the language the person is writing in: "en" if they wrote English, "de" if they wrote German. Do not leave it out because it has a default — the default is only the fallback when the language is genuinely unclear, and an English question answered in German is a wrong answer. Place names, station names and road numbers are never translated in either language; in English the German term is kept in parentheses so the person recognises it on signs and in local apps.
fuel	string	optional	Only stations with a current price for this grade: "e5" (Super E5), "e10" (Super E10) or "diesel". Omit to get every station near the place whatever it sells — the answer then lists all the grades it holds a price for. Required when sort is "price", because a price ordering needs a grade.
radius_km	number	optional	Search radius around the place in kilometres (1–25, default 5). 25 km is the provider's own ceiling — a larger circle is a dataset request, not a consumer question.
brand	string	optional	Only stations of this brand, matched case-insensitively anywhere in the brand field: "ARAL", "Shell", "TotalEnergies", "JET". Use it when the person named a chain ("die ARAL an der B1"). Free stations often carry no brand at all and are then not matched by any brand.
name	string	optional	Part of the station's own name or brand, case-insensitive: "Autohof", "Raststätte Fulda". Use it when the person named a specific forecourt rather than a chain. Combine with place to keep the search local.
open_now	boolean	optional	When true, only stations the published opening hours say are open at this moment. Default false. A station whose hours we have never read is NOT returned by this filter and is counted in the answer instead — the result never guesses that an unknown station is open.
open_at	string	optional	Only stations open at that time in Germany (Europe/Berlin): "23:30" means the next time the clock shows 23:30, and "2026-09-30 06:15" a specific local date and time. Use it for "is it still open tonight". Do not pass it together with open_now — they ask the same question about two different clocks.
whole_day	boolean	optional	When true, only stations the provider flags as open around the clock (24/7). Default false. Use it when asked whether a station never closes ("durchgehend geöffnet", "around the clock") and for a night drive; it is a stricter filter than open_now, which is satisfied by a station that closes at 22:00.
sort	string	optional	Order of the answer: "distance" (nearest first, the default — use it for "closest diesel to Hamburg Hbf"), "price" (cheapest first, needs fuel), or "name" (alphabetical, for a person scanning a list of a brand's forecourts).
limit	integer	optional	How many stations to return (1–10, default 5).

Raw schema

{
  "type": "object",
  "properties": {
    "place": {
      "description": "Where to look, as free text: a city (\"München\", \"Munich\"), a district or Kreis (\"Kreis Fulda\"), a Bundesland, a station or stop (\"Hamburg Hbf\"), a motorway junction (\"AK Neufahrn\"), or a street address with a house number (\"Bahnhofstraße 12, 36037 Fulda\"). A motorway number alone (\"A7\") resolves to the road, which has no single point — name a town or junction on it instead. Use this instead of coordinates whenever the person named a place. An address needs its town or postcode — a street and a number alone exist in many towns. Give either place OR lat+lon, never both.",
      "type": "string",
      "minLength": 1,
      "maxLength": 120
    },
    "lat": {
      "description": "Latitude in WGS 84, e.g. 48.137. Use with lon when the caller already holds coordinates; otherwise use place.",
      "type": "number",
      "minimum": -90,
      "maximum": 90
    },
    "lon": {
      "description": "Longitude in WGS 84, e.g. 11.576. Use with lat; otherwise use place.",
      "type": "number",
      "minimum": -180,
      "maximum": 180
    },
    "language": {
      "default": "de",
      "description": "Set this on every call to the language the person is writing in: \"en\" if they wrote English, \"de\" if they wrote German. Do not leave it out because it has a default — the default is only the fallback when the language is genuinely unclear, and an English question answered in German is a wrong answer. Place names, station names and road numbers are never translated in either language; in English the German term is kept in parentheses so the person recognises it on signs and in local apps.",
      "type": "string",
      "enum": [
        "de",
        "en"
      ]
    },
    "fuel": {
      "description": "Only stations with a current price for this grade: \"e5\" (Super E5), \"e10\" (Super E10) or \"diesel\". Omit to get every station near the place whatever it sells — the answer then lists all the grades it holds a price for. Required when sort is \"price\", because a price ordering needs a grade.",
      "type": "string",
      "enum": [
        "e5",
        "e10",
        "diesel"
      ]
    },
    "radius_km": {
      "default": 5,
      "description": "Search radius around the place in kilometres (1–25, default 5). 25 km is the provider's own ceiling — a larger circle is a dataset request, not a consumer question.",
      "type": "number",
      "minimum": 1,
      "maximum": 25
    },
    "brand": {
      "description": "Only stations of this brand, matched case-insensitively anywhere in the brand field: \"ARAL\", \"Shell\", \"TotalEnergies\", \"JET\". Use it when the person named a chain (\"die ARAL an der B1\"). Free stations often carry no brand at all and are then not matched by any brand.",
      "type": "string",
      "minLength": 1,
      "maxLength": 60
    },
    "name": {
      "description": "Part of the station's own name or brand, case-insensitive: \"Autohof\", \"Raststätte Fulda\". Use it when the person named a specific forecourt rather than a chain. Combine with place to keep the search local.",
      "type": "string",
      "minLength": 1,
      "maxLength": 120
    },
    "open_now": {
      "default": false,
      "description": "When true, only stations the published opening hours say are open at this moment. Default false. A station whose hours we have never read is NOT returned by this filter and is counted in the answer instead — the result never guesses that an unknown station is open.",
      "type": "boolean"
    },
    "open_at": {
      "description": "Only stations open at that time in Germany (Europe/Berlin): \"23:30\" means the next time the clock shows 23:30, and \"2026-09-30 06:15\" a specific local date and time. Use it for \"is it still open tonight\". Do not pass it together with open_now — they ask the same question about two different clocks.",
      "type": "string",
      "pattern": "^(?:\\d{1,2}:\\d{2}|\\d{4}-\\d{2}-\\d{2}[T ]\\d{1,2}:\\d{2})$"
    },
    "whole_day": {
      "default": false,
      "description": "When true, only stations the provider flags as open around the clock (24/7). Default false. Use it when asked whether a station never closes (\"durchgehend geöffnet\", \"around the clock\") and for a night drive; it is a stricter filter than open_now, which is satisfied by a station that closes at 22:00.",
      "type": "boolean"
    },
    "sort": {
      "default": "distance",
      "description": "Order of the answer: \"distance\" (nearest first, the default — use it for \"closest diesel to Hamburg Hbf\"), \"price\" (cheapest first, needs fuel), or \"name\" (alphabetical, for a person scanning a list of a brand's forecourts).",
      "type": "string",
      "enum": [
        "distance",
        "price",
        "name"
      ]
    },
    "limit": {
      "default": 5,
      "description": "How many stations to return (1–10, default 5).",
      "type": "integer",
      "minimum": 1,
      "maximum": 10
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

find_parking

Returns parking near a place, a coordinate or along one motorway: rest areas with lorry spaces, car parks and P+R sites, with total spaces and, where published, free spaces now and the reading's age. Use when asked where to park or leave the car for the train ("Parkhaus in Köln", "Rastplatz A3", "P+R"). Do NOT use for fuel (find_cheapest_fuel) or EV charging (find_charging_station). Radius ≤ 25 km, ≤ 10 sites per list; ODbL and CC BY-SA sources are separate lists (up to three). No "free now" means no published count, not full. No prices: for "was kostet" say so. Show each source's attribution.

Parameters9

place	string	optional	Where to look, as free text: a city ("München", "Munich"), a district or Kreis ("Kreis Fulda"), a Bundesland, a station or stop ("Hamburg Hbf"), a motorway junction ("AK Neufahrn"), or a street address with a house number ("Bahnhofstraße 12, 36037 Fulda"). A motorway number alone ("A7") resolves to the road, which has no single point — name a town or junction on it instead. Use this instead of coordinates whenever the person named a place. An address needs its town or postcode — a street and a number alone exist in many towns. Give either place OR lat+lon, never both.
lat	number	optional	Latitude in WGS 84, e.g. 48.137. Use with lon when the caller already holds coordinates; otherwise use place.
lon	number	optional	Longitude in WGS 84, e.g. 11.576. Use with lat; otherwise use place.
language	string	optional	Set this on every call to the language the person is writing in: "en" if they wrote English, "de" if they wrote German. Do not leave it out because it has a default — the default is only the fallback when the language is genuinely unclear, and an English question answered in German is a wrong answer. Place names, station names and road numbers are never translated in either language; in English the German term is kept in parentheses so the person recognises it on signs and in local apps.
road	string	optional	A single motorway number to list parking along, e.g. "A3" ("A 3" and "a3" are the same road). Use this when the person named a road and no town — "Rastplatz auf der A7". Give road OR place OR lat+lon, never two of them: a road is a 900 km line and a place is a point, so the two answer different questions. When the question names BOTH — "Parkhaus in Köln an der A3" — use the place: a person parks at a point, and the radius already covers the motorway beside it.
kind	string	optional	Which kind of parking: "rest_area" = motorway rest and service area (no feed we ingest classifies this category at all, so an answer filtered to it says so and names the parking we do hold), "car_park" = public car park (Parkhaus/Parkplatz), "park_and_ride" = P+R beside a station, "truck" = lorry parking, "any" = all of them. Default "any". Pass a kind only when the person named one — "Rastanlage"/"Raststätte" is "rest_area", a lorry driver asking for a break wants "truck", someone leaving the car for the train wants "park_and_ride". A camper, a caravan or a coach is none of the five: leave the argument out rather than filtering a tourist into lorry bays.
radius_km	number	optional	Search radius around place or lat+lon in kilometres (1–25, default 10). Ignored when you pass road, which covers the whole motorway. Start small in a city and widen if the answer is empty.
only_with_free_spaces	boolean	optional	Set true only when the person asks whether spaces are free right now. It keeps just the facilities whose operator publishes live occupancy AND currently reports a space, and the result says how many were dropped for publishing nothing — most German parking publishes no occupancy at all, so true usually narrows the answer to very little. Default false.
limit	integer	optional	How many facilities to return, nearest first (1–10, default 5).

Raw schema

{
  "type": "object",
  "properties": {
    "place": {
      "description": "Where to look, as free text: a city (\"München\", \"Munich\"), a district or Kreis (\"Kreis Fulda\"), a Bundesland, a station or stop (\"Hamburg Hbf\"), a motorway junction (\"AK Neufahrn\"), or a street address with a house number (\"Bahnhofstraße 12, 36037 Fulda\"). A motorway number alone (\"A7\") resolves to the road, which has no single point — name a town or junction on it instead. Use this instead of coordinates whenever the person named a place. An address needs its town or postcode — a street and a number alone exist in many towns. Give either place OR lat+lon, never both.",
      "type": "string",
      "minLength": 1,
      "maxLength": 120
    },
    "lat": {
      "description": "Latitude in WGS 84, e.g. 48.137. Use with lon when the caller already holds coordinates; otherwise use place.",
      "type": "number",
      "minimum": -90,
      "maximum": 90
    },
    "lon": {
      "description": "Longitude in WGS 84, e.g. 11.576. Use with lat; otherwise use place.",
      "type": "number",
      "minimum": -180,
      "maximum": 180
    },
    "language": {
      "default": "de",
      "description": "Set this on every call to the language the person is writing in: \"en\" if they wrote English, \"de\" if they wrote German. Do not leave it out because it has a default — the default is only the fallback when the language is genuinely unclear, and an English question answered in German is a wrong answer. Place names, station names and road numbers are never translated in either language; in English the German term is kept in parentheses so the person recognises it on signs and in local apps.",
      "type": "string",
      "enum": [
        "de",
        "en"
      ]
    },
    "road": {
      "description": "A single motorway number to list parking along, e.g. \"A3\" (\"A 3\" and \"a3\" are the same road). Use this when the person named a road and no town — \"Rastplatz auf der A7\". Give road OR place OR lat+lon, never two of them: a road is a 900 km line and a place is a point, so the two answer different questions. When the question names BOTH — \"Parkhaus in Köln an der A3\" — use the place: a person parks at a point, and the radius already covers the motorway beside it.",
      "type": "string",
      "maxLength": 16
    },
    "kind": {
      "default": "any",
      "description": "Which kind of parking: \"rest_area\" = motorway rest and service area (no feed we ingest classifies this category at all, so an answer filtered to it says so and names the parking we do hold), \"car_park\" = public car park (Parkhaus/Parkplatz), \"park_and_ride\" = P+R beside a station, \"truck\" = lorry parking, \"any\" = all of them. Default \"any\". Pass a kind only when the person named one — \"Rastanlage\"/\"Raststätte\" is \"rest_area\", a lorry driver asking for a break wants \"truck\", someone leaving the car for the train wants \"park_and_ride\". A camper, a caravan or a coach is none of the five: leave the argument out rather than filtering a tourist into lorry bays.",
      "type": "string",
      "enum": [
        "any",
        "rest_area",
        "car_park",
        "park_and_ride",
        "truck"
      ]
    },
    "radius_km": {
      "default": 10,
      "description": "Search radius around place or lat+lon in kilometres (1–25, default 10). Ignored when you pass road, which covers the whole motorway. Start small in a city and widen if the answer is empty.",
      "type": "number",
      "minimum": 1,
      "maximum": 25
    },
    "only_with_free_spaces": {
      "default": false,
      "description": "Set true only when the person asks whether spaces are free right now. It keeps just the facilities whose operator publishes live occupancy AND currently reports a space, and the result says how many were dropped for publishing nothing — most German parking publishes no occupancy at all, so true usually narrows the answer to very little. Default false.",
      "type": "boolean"
    },
    "limit": {
      "default": 5,
      "description": "How many facilities to return, nearest first (1–10, default 5).",
      "type": "integer",
      "minimum": 1,
      "maximum": 10
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

check_road_status

Whether a motorway, B road or Land road (NI, SN, TH) is open, closed or restricted, now and in coming days; by place, jams and city/Land messages near a town. Use when asked if a road is open/passable — "ist die A8 in diesem Moment gesperrt", "komme ich durch", at any clock, closures tonight/weekend — or Stau in a city: "Stau in Köln?". Do NOT use for jams/delays on a named motorway or a multi-motorway route — check_autobahn_traffic; roadworks in a date window — find_roadworks_ahead; city street: not held, say so. One road or place per call, ≤ 14 days, ≤ 11 entries. Show the attribution line.

Parameters7

road	string	optional	One German motorway or federal road, e.g. "A8" or "B27", or a Landes- or Staatsstraße in Niedersachsen, Sachsen or Thüringen, e.g. "L1025" or "S296". "A8", "A 8" and "a8" are the same road. Use this whenever the person named a road — it is the only input that reaches the planned-works data, which is filed by road and section and carries no coordinates. When the person also says WHERE — a town or a Bundesland ("die B2 bei Potsdam", "L1025 in Niedersachsen") — pass that as place too: only sources for that Land answer, and a Land no source covers is named. L and S numbers repeat in every Land, so give the Land with them. Otherwise give exactly one of road, place, or lat+lon.
place	string	optional	Where to look, as free text: a city ("München", "Munich"), a district or Kreis ("Kreis Fulda"), a Bundesland, a station or stop ("Hamburg Hbf"), a motorway junction ("AK Neufahrn"), or a street address with a house number ("Bahnhofstraße 12, 36037 Fulda"). A motorway number alone ("A7") resolves to the road, which has no single point — name a town or junction on it instead. Use this instead of coordinates whenever the person named a place. An address needs its town or postcode — a street and a number alone exist in many towns. Give either place OR lat+lon, never both.
lat	number	optional	Latitude in WGS 84, e.g. 48.137. Use with lon when the caller already holds coordinates; otherwise use place.
lon	number	optional	Longitude in WGS 84, e.g. 11.576. Use with lat; otherwise use place.
horizon_days	integer	optional	How many days ahead to look, counting from now (0 = right now only, max 14, default 3). Set it only to what the person actually asked for: 0 when they said right now / gerade / jetzt / in diesem Moment, 1 for tonight or heute Abend, 3 for "this weekend", 7 for "next week", and for a named weekday ("am Freitag", "on Friday") the number of days from today to that day. A bare "is the A8 open?" asks for no window — omit the argument and take the default rather than reading it as 0. Live closures are always included whatever this is, and so, by place, are the jams reported right now ("Stau in Köln?" needs no horizon).
limit	integer	optional	Maximum entries to return (1–11, default 10). By road, closures come first, then restrictions in force, then planned works; by place, nearest first.
language	string	optional	Set this on every call to the language the person is writing in: "en" if they wrote English, "de" if they wrote German. Do not leave it out because it has a default — the default is only the fallback when the language is genuinely unclear, and an English question answered in German is a wrong answer. Place names, station names and road numbers are never translated in either language; in English the German term is kept in parentheses so the person recognises it on signs and in local apps.

Raw schema

{
  "type": "object",
  "properties": {
    "road": {
      "description": "One German motorway or federal road, e.g. \"A8\" or \"B27\", or a Landes- or Staatsstraße in Niedersachsen, Sachsen or Thüringen, e.g. \"L1025\" or \"S296\". \"A8\", \"A 8\" and \"a8\" are the same road. Use this whenever the person named a road — it is the only input that reaches the planned-works data, which is filed by road and section and carries no coordinates. When the person also says WHERE — a town or a Bundesland (\"die B2 bei Potsdam\", \"L1025 in Niedersachsen\") — pass that as place too: only sources for that Land answer, and a Land no source covers is named. L and S numbers repeat in every Land, so give the Land with them. Otherwise give exactly one of road, place, or lat+lon.",
      "type": "string",
      "pattern": "^(?:[ABab] ?\\d{1,3}|[LlSs] ?\\d{1,4})$"
    },
    "place": {
      "description": "Where to look, as free text: a city (\"München\", \"Munich\"), a district or Kreis (\"Kreis Fulda\"), a Bundesland, a station or stop (\"Hamburg Hbf\"), a motorway junction (\"AK Neufahrn\"), or a street address with a house number (\"Bahnhofstraße 12, 36037 Fulda\"). A motorway number alone (\"A7\") resolves to the road, which has no single point — name a town or junction on it instead. Use this instead of coordinates whenever the person named a place. An address needs its town or postcode — a street and a number alone exist in many towns. Give either place OR lat+lon, never both.",
      "type": "string",
      "minLength": 1,
      "maxLength": 120
    },
    "lat": {
      "description": "Latitude in WGS 84, e.g. 48.137. Use with lon when the caller already holds coordinates; otherwise use place.",
      "type": "number",
      "minimum": -90,
      "maximum": 90
    },
    "lon": {
      "description": "Longitude in WGS 84, e.g. 11.576. Use with lat; otherwise use place.",
      "type": "number",
      "minimum": -180,
      "maximum": 180
    },
    "horizon_days": {
      "default": 3,
      "description": "How many days ahead to look, counting from now (0 = right now only, max 14, default 3). Set it only to what the person actually asked for: 0 when they said right now / gerade / jetzt / in diesem Moment, 1 for tonight or heute Abend, 3 for \"this weekend\", 7 for \"next week\", and for a named weekday (\"am Freitag\", \"on Friday\") the number of days from today to that day. A bare \"is the A8 open?\" asks for no window — omit the argument and take the default rather than reading it as 0. Live closures are always included whatever this is, and so, by place, are the jams reported right now (\"Stau in Köln?\" needs no horizon).",
      "type": "integer",
      "minimum": 0,
      "maximum": 14
    },
    "limit": {
      "default": 10,
      "description": "Maximum entries to return (1–11, default 10). By road, closures come first, then restrictions in force, then planned works; by place, nearest first.",
      "type": "integer",
      "minimum": 1,
      "maximum": 11
    },
    "language": {
      "default": "de",
      "description": "Set this on every call to the language the person is writing in: \"en\" if they wrote English, \"de\" if they wrote German. Do not leave it out because it has a default — the default is only the fallback when the language is genuinely unclear, and an English question answered in German is a wrong answer. Place names, station names and road numbers are never translated in either language; in English the German term is kept in parentheses so the person recognises it on signs and in local apps.",
      "type": "string",
      "enum": [
        "de",
        "en"
      ]
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

find_roadworks_ahead

Returns roadworks PLANNED on one German motorway, or one Bundes- or Landesstraße in Niedersachsen, Sachsen or Thüringen, in a date window: section, restriction, start and end. Use when a date or window is named, the question says geplant, or how long a site lasts ("Baustellen auf der A7 in den Sommerferien?"). ONE road per call. Do NOT use when more than one motorway is named, for the situation this minute, or for Baustellen with neither date nor geplant — all three are check_autobahn_traffic; whether a road is open — call check_road_status. ≤ 92 days, max 20 sites. Show the attribution line.

Parameters5

road	string	required	The road to look at, one per call: an Autobahn, e.g. "A7" or "A100", or a Bundesstraße, Landesstraße or Staatsstraße in Niedersachsen, Sachsen or Thüringen, e.g. "B6", "L1025", "S296" — "A7", "A 7" and "a7" are the same road. B and L roads in other Länder, Kreisstraßen and city streets are not covered. Ask again for a second road.
from	string	optional	First day of the window, as YYYY-MM-DD in German local time. Omit for today. Resolve relative wording ("next Friday", "in den Sommerferien", "nächsten Monat") into real dates yourself, counted from today's date; this argument never takes words, and it never takes a fixed example date — the window a person means moves with the calendar.
to	string	optional	Last day of the window, inclusive, as YYYY-MM-DD. Omit for 7 days after `from`, which is the right window for "am I going to hit roadworks on this drive". The window may span at most 92 days. For "how long will this last" / "wie lange dauert die Baustelle noch", leave both dates out: the default 7 days already returns the site's planned end date. Only widen — 28 days is the sensible step — when the person asked about a period that long.
language	string	optional	Set this on every call to the language the person is writing in: "en" if they wrote English, "de" if they wrote German. Do not leave it out because it has a default — the default is only the fallback when the language is genuinely unclear, and an English question answered in German is a wrong answer. Place names, station names and road numbers are never translated in either language; in English the German term is kept in parentheses so the person recognises it on signs and in local apps.
limit	integer	optional	Maximum sites to return (1–20, default 10), ordered by planned start. Every returned site is in the structured result; the readable text prints the first 10 and says how many more of them are in the structured half. The answer always names how many sites the window holds in total, so a small limit never hides the size of the problem.

Raw schema

{
  "type": "object",
  "properties": {
    "road": {
      "type": "string",
      "pattern": "^(?:[AaBb] ?\\d{1,3}|[LlSs] ?\\d{1,4})$",
      "description": "The road to look at, one per call: an Autobahn, e.g. \"A7\" or \"A100\", or a Bundesstraße, Landesstraße or Staatsstraße in Niedersachsen, Sachsen or Thüringen, e.g. \"B6\", \"L1025\", \"S296\" — \"A7\", \"A 7\" and \"a7\" are the same road. B and L roads in other Länder, Kreisstraßen and city streets are not covered. Ask again for a second road."
    },
    "from": {
      "description": "First day of the window, as YYYY-MM-DD in German local time. Omit for today. Resolve relative wording (\"next Friday\", \"in den Sommerferien\", \"nächsten Monat\") into real dates yourself, counted from today's date; this argument never takes words, and it never takes a fixed example date — the window a person means moves with the calendar.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "to": {
      "description": "Last day of the window, inclusive, as YYYY-MM-DD. Omit for 7 days after `from`, which is the right window for \"am I going to hit roadworks on this drive\". The window may span at most 92 days. For \"how long will this last\" / \"wie lange dauert die Baustelle noch\", leave both dates out: the default 7 days already returns the site's planned end date. Only widen — 28 days is the sensible step — when the person asked about a period that long.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "language": {
      "default": "de",
      "description": "Set this on every call to the language the person is writing in: \"en\" if they wrote English, \"de\" if they wrote German. Do not leave it out because it has a default — the default is only the fallback when the language is genuinely unclear, and an English question answered in German is a wrong answer. Place names, station names and road numbers are never translated in either language; in English the German term is kept in parentheses so the person recognises it on signs and in local apps.",
      "type": "string",
      "enum": [
        "de",
        "en"
      ]
    },
    "limit": {
      "default": 10,
      "description": "Maximum sites to return (1–20, default 10), ordered by planned start. Every returned site is in the structured result; the readable text prints the first 10 and says how many more of them are in the structured half. The answer always names how many sites the window holds in total, so a small limit never hides the size of the problem.",
      "type": "integer",
      "minimum": 1,
      "maximum": 20
    }
  },
  "required": [
    "road"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

find_charging_station

Returns EV charging sites near a place or coordinate with operator, connector types, maximum power, price per kWh where published, and how many points are free right now where the operator publishes live status. Use when an EV driver asks where to charge ("Wo kann ich laden?", "CCS 150 kW near Leipzig", "ist gerade eine Säule frei?"). Do NOT use for petrol or diesel — call find_cheapest_fuel; for E-Kennzeichen or Ladekarte rules — call get_driving_rules. Radius ≤ 25 km, ≤ 10 sites; availability is missing for most operators and is then unknown, never free. Show the attribution line.

Parameters9

place	string	optional	Where to look, as free text: a city ("München", "Munich"), a district or Kreis ("Kreis Fulda"), a Bundesland, a station or stop ("Hamburg Hbf"), a motorway junction ("AK Neufahrn"), or a street address with a house number ("Bahnhofstraße 12, 36037 Fulda"). A motorway number alone ("A7") resolves to the road, which has no single point — name a town or junction on it instead. Use this instead of coordinates whenever the person named a place. An address needs its town or postcode — a street and a number alone exist in many towns. Give either place OR lat+lon, never both.
lat	number	optional	Latitude in WGS 84, e.g. 48.137. Use with lon when the caller already holds coordinates; otherwise use place.
lon	number	optional	Longitude in WGS 84, e.g. 11.576. Use with lat; otherwise use place.
language	string	optional	Set this on every call to the language the person is writing in: "en" if they wrote English, "de" if they wrote German. Do not leave it out because it has a default — the default is only the fallback when the language is genuinely unclear, and an English question answered in German is a wrong answer. Place names, station names and road numbers are never translated in either language; in English the German term is kept in parentheses so the person recognises it on signs and in local apps.
radius_km	number	optional	Search radius around the place in kilometres (1–25, default 10). A charging stop is worth a detour, so this is wider than the fuel radius — but 25 km is the cap, and a larger circle is a dataset request rather than a driver's question.
connector	string	optional	Plug the car needs: "ccs2" (CCS Combo 2 — the DC fast-charging standard on almost every European EV), "type2" (Typ 2 / Mennekes, the AC socket) or "chademo" (older Japanese DC, e.g. Nissan Leaf). Omit unless the person named their plug or their car model — filtering on a guess hides chargers they could have used.
min_power_kw	number	optional	Only charging points of at least this many kW (1–1000). Use when the person names a number or asks for fast charging: 50 = DC fast (a bare "fast"/"schnell"/"Schnelllader"), 150 = HPC ("HPC", "ultra", "ultraschnell"), 300 = the fastest posts in Germany. Omit for "where can I charge" — 11 kW overnight is a valid answer to that question.
only_available	boolean	optional	When true, return only sites with at least one point reported FREE right now. Default false. Use it when the person asks what is free at this moment. Note that only some operators publish live status: the result always says how many nearby sites were dropped because their status is unknown, so the filter never silently hides a charger that may well be free.
limit	integer	optional	How many charging sites to return, nearest first (1–10, default 5).

Raw schema

{
  "type": "object",
  "properties": {
    "place": {
      "description": "Where to look, as free text: a city (\"München\", \"Munich\"), a district or Kreis (\"Kreis Fulda\"), a Bundesland, a station or stop (\"Hamburg Hbf\"), a motorway junction (\"AK Neufahrn\"), or a street address with a house number (\"Bahnhofstraße 12, 36037 Fulda\"). A motorway number alone (\"A7\") resolves to the road, which has no single point — name a town or junction on it instead. Use this instead of coordinates whenever the person named a place. An address needs its town or postcode — a street and a number alone exist in many towns. Give either place OR lat+lon, never both.",
      "type": "string",
      "minLength": 1,
      "maxLength": 120
    },
    "lat": {
      "description": "Latitude in WGS 84, e.g. 48.137. Use with lon when the caller already holds coordinates; otherwise use place.",
      "type": "number",
      "minimum": -90,
      "maximum": 90
    },
    "lon": {
      "description": "Longitude in WGS 84, e.g. 11.576. Use with lat; otherwise use place.",
      "type": "number",
      "minimum": -180,
      "maximum": 180
    },
    "language": {
      "default": "de",
      "description": "Set this on every call to the language the person is writing in: \"en\" if they wrote English, \"de\" if they wrote German. Do not leave it out because it has a default — the default is only the fallback when the language is genuinely unclear, and an English question answered in German is a wrong answer. Place names, station names and road numbers are never translated in either language; in English the German term is kept in parentheses so the person recognises it on signs and in local apps.",
      "type": "string",
      "enum": [
        "de",
        "en"
      ]
    },
    "radius_km": {
      "default": 10,
      "description": "Search radius around the place in kilometres (1–25, default 10). A charging stop is worth a detour, so this is wider than the fuel radius — but 25 km is the cap, and a larger circle is a dataset request rather than a driver's question.",
      "type": "number",
      "minimum": 1,
      "maximum": 25
    },
    "connector": {
      "description": "Plug the car needs: \"ccs2\" (CCS Combo 2 — the DC fast-charging standard on almost every European EV), \"type2\" (Typ 2 / Mennekes, the AC socket) or \"chademo\" (older Japanese DC, e.g. Nissan Leaf). Omit unless the person named their plug or their car model — filtering on a guess hides chargers they could have used.",
      "type": "string",
      "enum": [
        "ccs2",
        "type2",
        "chademo"
      ]
    },
    "min_power_kw": {
      "description": "Only charging points of at least this many kW (1–1000). Use when the person names a number or asks for fast charging: 50 = DC fast (a bare \"fast\"/\"schnell\"/\"Schnelllader\"), 150 = HPC (\"HPC\", \"ultra\", \"ultraschnell\"), 300 = the fastest posts in Germany. Omit for \"where can I charge\" — 11 kW overnight is a valid answer to that question.",
      "type": "number",
      "minimum": 1,
      "maximum": 1000
    },
    "only_available": {
      "default": false,
      "description": "When true, return only sites with at least one point reported FREE right now. Default false. Use it when the person asks what is free at this moment. Note that only some operators publish live status: the result always says how many nearby sites were dropped because their status is unknown, so the filter never silently hides a charger that may well be free.",
      "type": "boolean"
    },
    "limit": {
      "default": 5,
      "description": "How many charging sites to return, nearest first (1–10, default 5).",
      "type": "integer",
      "minimum": 1,
      "maximum": 10
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

find_place

Looks up a place name and returns every place that matches, each with its kind, official key (AGS/RS), population, English name and coordinate. Use when the person asks where somewhere is, when you need a coordinate for another tool, and above all to RECOVER after a tool reported a name as ambiguous — this is where you find out which Neustadt is which. Pass `near` to rank and separate same-named places by distance. Do NOT use to find a company, shop or landmark: call find_poi. At most 10 results, radius <= 200 km. Every result carries an attribution line that must be shown to the user.

Parameters8

language	string	optional	Set this on every call to the language the person is writing in: "en" if they wrote English, "de" if they wrote German. Do not leave it out because it has a default — the default is only the fallback when the language is genuinely unclear, and an English question answered in German is a wrong answer. Place names, station names and road numbers are never translated in either language; in English the German term is kept in parentheses so the person recognises it on signs and in local apps.
query	string	required	The place name to look up, as the person said it — "Neustadt", "Munich", "Kreis Fulda", "Köln Hbf". English names and spellings without umlauts both work.
kind	string	optional	Narrow to one kind: "city", "district" (Kreis), "admin" (Land or Regierungsbezirk), "station", "stop", "motorway" or "junction". Omit unless the person was specific.
near	string	optional	A second place to measure from, used to tell same-named candidates apart: "Neustadt" near "Hamburg" is one of twenty Neustadts. Every result then carries its distance from this point.
lat	number	optional	Latitude to measure from, instead of `near`.
lon	number	optional	Longitude to measure from, instead of `near`.
radius_km	number	optional	When near/lat+lon is given, keep only candidates within this many kilometres (1–200). Omit to rank by distance without dropping any.
limit	integer	optional	How many candidates to return, best match first (1–10, default 5).

Raw schema

{
  "type": "object",
  "properties": {
    "language": {
      "default": "de",
      "description": "Set this on every call to the language the person is writing in: \"en\" if they wrote English, \"de\" if they wrote German. Do not leave it out because it has a default — the default is only the fallback when the language is genuinely unclear, and an English question answered in German is a wrong answer. Place names, station names and road numbers are never translated in either language; in English the German term is kept in parentheses so the person recognises it on signs and in local apps.",
      "type": "string",
      "enum": [
        "de",
        "en"
      ]
    },
    "query": {
      "type": "string",
      "minLength": 2,
      "maxLength": 120,
      "description": "The place name to look up, as the person said it — \"Neustadt\", \"Munich\", \"Kreis Fulda\", \"Köln Hbf\". English names and spellings without umlauts both work."
    },
    "kind": {
      "description": "Narrow to one kind: \"city\", \"district\" (Kreis), \"admin\" (Land or Regierungsbezirk), \"station\", \"stop\", \"motorway\" or \"junction\". Omit unless the person was specific.",
      "type": "string",
      "enum": [
        "city",
        "district",
        "admin",
        "station",
        "stop",
        "motorway",
        "junction"
      ]
    },
    "near": {
      "description": "A second place to measure from, used to tell same-named candidates apart: \"Neustadt\" near \"Hamburg\" is one of twenty Neustadts. Every result then carries its distance from this point.",
      "type": "string",
      "maxLength": 120
    },
    "lat": {
      "description": "Latitude to measure from, instead of `near`.",
      "type": "number",
      "minimum": -90,
      "maximum": 90
    },
    "lon": {
      "description": "Longitude to measure from, instead of `near`.",
      "type": "number",
      "minimum": -180,
      "maximum": 180
    },
    "radius_km": {
      "description": "When near/lat+lon is given, keep only candidates within this many kilometres (1–200). Omit to rank by distance without dropping any.",
      "type": "number",
      "minimum": 1,
      "maximum": 200
    },
    "limit": {
      "default": 5,
      "description": "How many candidates to return, best match first (1–10, default 5).",
      "type": "integer",
      "minimum": 1,
      "maximum": 10
    }
  },
  "required": [
    "query"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

find_poi

Finds a named business or landmark — company, shop, clinic, hotel — and returns its address, category and coordinate. Use when the person names a THING rather than a town: "the adesso office in Dortmund", "the nearest Aldi". The coordinate it returns passes to any other tool as lat/lon. Do NOT use for a town, district or station (every tool's `place` resolves those), nor for fuel, charging or parking, which have their own tools. Give "in" (a town) when you can: far faster than searching nationwide. At most 10 results, radius <= 50 km. OpenStreetMap under ODbL 1.0; show the attribution line.

Parameters9

language	string	optional	Set this on every call to the language the person is writing in: "en" if they wrote English, "de" if they wrote German. Do not leave it out because it has a default — the default is only the fallback when the language is genuinely unclear, and an English question answered in German is a wrong answer. Place names, station names and road numbers are never translated in either language; in English the German term is kept in parentheses so the person recognises it on signs and in local apps.
name	string	required	The name of the thing to find — a company, shop, clinic, hotel, office or landmark. Part of the name is enough: "adesso" finds "adesso SE". A chain name works too, because brands are matched as well as names.
in	string	optional	A town to search in — "Dortmund", "Fulda". Strongly preferred: it is both far faster and far less ambiguous than a nationwide search. Use this OR near/lat+lon, not both.
near	string	optional	A place to search around, when the question is "the nearest X" rather than "X in Y". Use with radius_km.
lat	number	optional	Latitude of the point to search around, when the caller already holds a coordinate.
lon	number	optional	Longitude of the point to search around.
category	string	optional	Narrow to one OpenStreetMap family: "office" (companies, agencies), "shop", "amenity" (fuel, pharmacy, school, restaurant, town hall), "healthcare", "tourism" (hotels, attractions), "leisure", "industrial", "historic" (castles, monuments, city gates), "natural" (mountain peaks) or "building". Omit unless the person was specific.
radius_km	number	optional	Search radius in kilometres around near/lat+lon (1–50, default 10). Ignored when "in" is used.
limit	integer	optional	How many to return, best match first (1–10, default 5).

Raw schema

{
  "type": "object",
  "properties": {
    "language": {
      "default": "de",
      "description": "Set this on every call to the language the person is writing in: \"en\" if they wrote English, \"de\" if they wrote German. Do not leave it out because it has a default — the default is only the fallback when the language is genuinely unclear, and an English question answered in German is a wrong answer. Place names, station names and road numbers are never translated in either language; in English the German term is kept in parentheses so the person recognises it on signs and in local apps.",
      "type": "string",
      "enum": [
        "de",
        "en"
      ]
    },
    "name": {
      "type": "string",
      "minLength": 2,
      "maxLength": 120,
      "description": "The name of the thing to find — a company, shop, clinic, hotel, office or landmark. Part of the name is enough: \"adesso\" finds \"adesso SE\". A chain name works too, because brands are matched as well as names."
    },
    "in": {
      "description": "A town to search in — \"Dortmund\", \"Fulda\". Strongly preferred: it is both far faster and far less ambiguous than a nationwide search. Use this OR near/lat+lon, not both.",
      "type": "string",
      "maxLength": 120
    },
    "near": {
      "description": "A place to search around, when the question is \"the nearest X\" rather than \"X in Y\". Use with radius_km.",
      "type": "string",
      "maxLength": 120
    },
    "lat": {
      "description": "Latitude of the point to search around, when the caller already holds a coordinate.",
      "type": "number",
      "minimum": -90,
      "maximum": 90
    },
    "lon": {
      "description": "Longitude of the point to search around.",
      "type": "number",
      "minimum": -180,
      "maximum": 180
    },
    "category": {
      "description": "Narrow to one OpenStreetMap family: \"office\" (companies, agencies), \"shop\", \"amenity\" (fuel, pharmacy, school, restaurant, town hall), \"healthcare\", \"tourism\" (hotels, attractions), \"leisure\", \"industrial\", \"historic\" (castles, monuments, city gates), \"natural\" (mountain peaks) or \"building\". Omit unless the person was specific.",
      "type": "string",
      "enum": [
        "office",
        "amenity",
        "shop",
        "tourism",
        "healthcare",
        "leisure",
        "industrial",
        "historic",
        "natural",
        "building"
      ]
    },
    "radius_km": {
      "default": 10,
      "description": "Search radius in kilometres around near/lat+lon (1–50, default 10). Ignored when \"in\" is used.",
      "type": "number",
      "minimum": 1,
      "maximum": 50
    },
    "limit": {
      "default": 5,
      "description": "How many to return, best match first (1–10, default 5).",
      "type": "integer",
      "minimum": 1,
      "maximum": 10
    }
  },
  "required": [
    "name"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

find_address

Looks up a street address and returns its coordinate, plus what OpenStreetMap holds under it. Use when the person gives a STREET AND NUMBER — "Bahnhofstraße 12, Fulda" — for the point, or to see what is mapped there. The coordinate passes to any other tool as lat/lon. Do NOT use for a town/district/station name alone (find_place) or a company/shop/landmark by name (find_poi) — needs a street and a number. At most 5 results; more than one in ONE town means the door is mapped twice, and results in several towns are a question to ask the person. OpenStreetMap ODbL 1.0; show the attribution line.

Parameters3

language	string	optional	Set this on every call to the language the person is writing in: "en" if they wrote English, "de" if they wrote German. Do not leave it out because it has a default — the default is only the fallback when the language is genuinely unclear, and an English question answered in German is a wrong answer. Place names, station names and road numbers are never translated in either language; in English the German term is kept in parentheses so the person recognises it on signs and in local apps.
query	string	required	A street address, as a person writes one: street and house number, plus a town or postcode — "Bahnhofstraße 12, 36037 Fulda" or "Bahnhofstraße 12, Fulda". Both orders work. A street and number with neither a town nor a postcode cannot be placed (the same street name exists in about two thousand German towns) and is refused.
limit	integer	optional	How many results to return (1–5, default 3) — more than one means the same address carries more than one OpenStreetMap object.

Raw schema

{
  "type": "object",
  "properties": {
    "language": {
      "default": "de",
      "description": "Set this on every call to the language the person is writing in: \"en\" if they wrote English, \"de\" if they wrote German. Do not leave it out because it has a default — the default is only the fallback when the language is genuinely unclear, and an English question answered in German is a wrong answer. Place names, station names and road numbers are never translated in either language; in English the German term is kept in parentheses so the person recognises it on signs and in local apps.",
      "type": "string",
      "enum": [
        "de",
        "en"
      ]
    },
    "query": {
      "type": "string",
      "minLength": 3,
      "maxLength": 160,
      "description": "A street address, as a person writes one: street and house number, plus a town or postcode — \"Bahnhofstraße 12, 36037 Fulda\" or \"Bahnhofstraße 12, Fulda\". Both orders work. A street and number with neither a town nor a postcode cannot be placed (the same street name exists in about two thousand German towns) and is refused."
    },
    "limit": {
      "default": 3,
      "description": "How many results to return (1–5, default 3) — more than one means the same address carries more than one OpenStreetMap object.",
      "type": "integer",
      "minimum": 1,
      "maximum": 5
    }
  },
  "required": [
    "query"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

describe_location

Turns a coordinate into words: the nearest address, settlement, Kreis, administrative area and motorway junction, each with its own distance. Use when you already HAVE a lat/lon and need to say where that is. Do NOT use to look up a place or address BY NAME — that is find_place, find_poi or find_address; this only goes coordinate to words. The gazetteer facts are the NEAREST point, not a boundary lookup — near a border it can differ, and the admin point can be a Regierungsbezirk, not a Land. OpenStreetMap ODbL 1.0 for the address; show the attribution line.

Parameters3

language	string	optional	Set this on every call to the language the person is writing in: "en" if they wrote English, "de" if they wrote German. Do not leave it out because it has a default — the default is only the fallback when the language is genuinely unclear, and an English question answered in German is a wrong answer. Place names, station names and road numbers are never translated in either language; in English the German term is kept in parentheses so the person recognises it on signs and in local apps.
lat	number	required	Latitude of the point to describe (WGS84).
lon	number	required	Longitude of the point to describe (WGS84).

Raw schema

{
  "type": "object",
  "properties": {
    "language": {
      "default": "de",
      "description": "Set this on every call to the language the person is writing in: \"en\" if they wrote English, \"de\" if they wrote German. Do not leave it out because it has a default — the default is only the fallback when the language is genuinely unclear, and an English question answered in German is a wrong answer. Place names, station names and road numbers are never translated in either language; in English the German term is kept in parentheses so the person recognises it on signs and in local apps.",
      "type": "string",
      "enum": [
        "de",
        "en"
      ]
    },
    "lat": {
      "type": "number",
      "minimum": -90,
      "maximum": 90,
      "description": "Latitude of the point to describe (WGS84)."
    },
    "lon": {
      "type": "number",
      "minimum": -180,
      "maximum": 180,
      "description": "Longitude of the point to describe (WGS84)."
    }
  },
  "required": [
    "lat",
    "lon"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

find_nearby

Overview of what is around a place or coordinate: nearby fuel stations, EV charging, parking, the nearest railway station and motorway junction, each with its distance. Use when someone asks "what is around me" or "what is near <place>" — a broad look, not one category in depth. Do NOT use for a fuel grade's price (find_cheapest_fuel), charger/connector status (find_charging_station), parking kind/occupancy (find_parking), a NAME lookup (find_place/find_poi/find_address), or a coordinate's address (describe_location). Radius ≤ 15 km, up to 3 per category. Shows each source's attribution.

Parameters6

place	string	optional	Where to look, as free text: a city ("München", "Munich"), a district or Kreis ("Kreis Fulda"), a Bundesland, a station or stop ("Hamburg Hbf"), a motorway junction ("AK Neufahrn"), or a street address with a house number ("Bahnhofstraße 12, 36037 Fulda"). A motorway number alone ("A7") resolves to the road, which has no single point — name a town or junction on it instead. Use this instead of coordinates whenever the person named a place. An address needs its town or postcode — a street and a number alone exist in many towns. Give either place OR lat+lon, never both.
lat	number	optional	Latitude in WGS 84, e.g. 48.137. Use with lon when the caller already holds coordinates; otherwise use place.
lon	number	optional	Longitude in WGS 84, e.g. 11.576. Use with lat; otherwise use place.
language	string	optional	Set this on every call to the language the person is writing in: "en" if they wrote English, "de" if they wrote German. Do not leave it out because it has a default — the default is only the fallback when the language is genuinely unclear, and an English question answered in German is a wrong answer. Place names, station names and road numbers are never translated in either language; in English the German term is kept in parentheses so the person recognises it on signs and in local apps.
radius_km	number	optional	Search radius around place or lat+lon in kilometres (1–15, default 5). This tool answers "what is around me", not "search a wide area" — for that, use the specific tool with its own wider radius.
categories	array	optional	Which categories to include: "fuel", "charging", "parking", "station" (railway station), "junction" (motorway junction). Omit for all five. Pass a subset only when the person named one — otherwise the full picture is the point of this tool.

Raw schema

{
  "type": "object",
  "properties": {
    "place": {
      "description": "Where to look, as free text: a city (\"München\", \"Munich\"), a district or Kreis (\"Kreis Fulda\"), a Bundesland, a station or stop (\"Hamburg Hbf\"), a motorway junction (\"AK Neufahrn\"), or a street address with a house number (\"Bahnhofstraße 12, 36037 Fulda\"). A motorway number alone (\"A7\") resolves to the road, which has no single point — name a town or junction on it instead. Use this instead of coordinates whenever the person named a place. An address needs its town or postcode — a street and a number alone exist in many towns. Give either place OR lat+lon, never both.",
      "type": "string",
      "minLength": 1,
      "maxLength": 120
    },
    "lat": {
      "description": "Latitude in WGS 84, e.g. 48.137. Use with lon when the caller already holds coordinates; otherwise use place.",
      "type": "number",
      "minimum": -90,
      "maximum": 90
    },
    "lon": {
      "description": "Longitude in WGS 84, e.g. 11.576. Use with lat; otherwise use place.",
      "type": "number",
      "minimum": -180,
      "maximum": 180
    },
    "language": {
      "default": "de",
      "description": "Set this on every call to the language the person is writing in: \"en\" if they wrote English, \"de\" if they wrote German. Do not leave it out because it has a default — the default is only the fallback when the language is genuinely unclear, and an English question answered in German is a wrong answer. Place names, station names and road numbers are never translated in either language; in English the German term is kept in parentheses so the person recognises it on signs and in local apps.",
      "type": "string",
      "enum": [
        "de",
        "en"
      ]
    },
    "radius_km": {
      "default": 5,
      "description": "Search radius around place or lat+lon in kilometres (1–15, default 5). This tool answers \"what is around me\", not \"search a wide area\" — for that, use the specific tool with its own wider radius.",
      "type": "number",
      "minimum": 1,
      "maximum": 15
    },
    "categories": {
      "description": "Which categories to include: \"fuel\", \"charging\", \"parking\", \"station\" (railway station), \"junction\" (motorway junction). Omit for all five. Pass a subset only when the person named one — otherwise the full picture is the point of this tool.",
      "minItems": 1,
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "fuel",
          "charging",
          "parking",
          "station",
          "junction"
        ]
      }
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

find_sharing

Returns rentable shared bikes near a place or coordinate: bike-sharing stations with bikes and free docks now, and free-floating bikes around, with distance and data age (nextbike incl. KVB Rad, MyRadl, VAG_Rad; Donkey Republic). Use when someone asks for a rental or shared bike ("Leihrad", "Fahrradverleih", "nächstes nextbike", "bike share near me"). Do NOT use for parking (find_parking) or a general look around a place (find_nearby). Radius ≤ 5 km, ≤ 20 stations; e-scooters are not covered. Shows each source's attribution.

Parameters7

place	string	optional	Where to look, as free text: a city ("München", "Munich"), a district or Kreis ("Kreis Fulda"), a Bundesland, a station or stop ("Hamburg Hbf"), a motorway junction ("AK Neufahrn"), or a street address with a house number ("Bahnhofstraße 12, 36037 Fulda"). A motorway number alone ("A7") resolves to the road, which has no single point — name a town or junction on it instead. Use this instead of coordinates whenever the person named a place. An address needs its town or postcode — a street and a number alone exist in many towns. Give either place OR lat+lon, never both.
lat	number	optional	Latitude in WGS 84, e.g. 48.137. Use with lon when the caller already holds coordinates; otherwise use place.
lon	number	optional	Longitude in WGS 84, e.g. 11.576. Use with lat; otherwise use place.
language	string	optional	Set this on every call to the language the person is writing in: "en" if they wrote English, "de" if they wrote German. Do not leave it out because it has a default — the default is only the fallback when the language is genuinely unclear, and an English question answered in German is a wrong answer. Place names, station names and road numbers are never translated in either language; in English the German term is kept in parentheses so the person recognises it on signs and in local apps.
radius_km	number	optional	Search radius around place or lat+lon in kilometres (0.1–5, default 1). Example: 1
limit	integer	optional	How many stations to list, nearest first (1–20, default 8). Free-floating bikes are summarised, not listed one by one.
only_available	boolean	optional	true (default): list only stations with at least one bike to rent right now. false: also list empty stations, e.g. to find a free dock to return a bike.

Raw schema

{
  "type": "object",
  "properties": {
    "place": {
      "description": "Where to look, as free text: a city (\"München\", \"Munich\"), a district or Kreis (\"Kreis Fulda\"), a Bundesland, a station or stop (\"Hamburg Hbf\"), a motorway junction (\"AK Neufahrn\"), or a street address with a house number (\"Bahnhofstraße 12, 36037 Fulda\"). A motorway number alone (\"A7\") resolves to the road, which has no single point — name a town or junction on it instead. Use this instead of coordinates whenever the person named a place. An address needs its town or postcode — a street and a number alone exist in many towns. Give either place OR lat+lon, never both.",
      "type": "string",
      "minLength": 1,
      "maxLength": 120
    },
    "lat": {
      "description": "Latitude in WGS 84, e.g. 48.137. Use with lon when the caller already holds coordinates; otherwise use place.",
      "type": "number",
      "minimum": -90,
      "maximum": 90
    },
    "lon": {
      "description": "Longitude in WGS 84, e.g. 11.576. Use with lat; otherwise use place.",
      "type": "number",
      "minimum": -180,
      "maximum": 180
    },
    "language": {
      "default": "de",
      "description": "Set this on every call to the language the person is writing in: \"en\" if they wrote English, \"de\" if they wrote German. Do not leave it out because it has a default — the default is only the fallback when the language is genuinely unclear, and an English question answered in German is a wrong answer. Place names, station names and road numbers are never translated in either language; in English the German term is kept in parentheses so the person recognises it on signs and in local apps.",
      "type": "string",
      "enum": [
        "de",
        "en"
      ]
    },
    "radius_km": {
      "default": 1,
      "description": "Search radius around place or lat+lon in kilometres (0.1–5, default 1). Example: 1",
      "type": "number",
      "minimum": 0.1,
      "maximum": 5
    },
    "limit": {
      "default": 8,
      "description": "How many stations to list, nearest first (1–20, default 8). Free-floating bikes are summarised, not listed one by one.",
      "type": "integer",
      "minimum": 1,
      "maximum": 20
    },
    "only_available": {
      "default": true,
      "description": "true (default): list only stations with at least one bike to rent right now. false: also list empty stations, e.g. to find a free dock to return a bike.",
      "type": "boolean"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_driving_rules

Returns the German road rules a visitor needs: low-emission zones (Umweltzone) and which Feinstaubplakette a city requires, speed limits (advisory 130), winter tyres, alcohol, the Sunday lorry ban, tolls (no car toll), Rettungsgasse, what must be in the car, and electric cars (E-Kennzeichen, ad-hoc payment, plugs). Use when someone drives through Germany or asks whether they may enter a city. Do NOT use for live traffic or closures: check_autobahn_traffic; to FIND a charger: find_charging_station. Optional city narrows to its zone. Sourced and dated; show the attribution. Not legal advice.

Parameters3

topic	string	optional	Which rule to answer. "lez" = low-emission zone and Feinstaubplakette, "speed" = speed limits including the Autobahn advisory 130, "winter" = winter-tyre duty, "alcohol" = alcohol and drugs, "toll" = car and lorry toll, "truck_ban" = Sunday and holiday lorry ban, "equipment" = what the law requires in the car, "emergency" = 112/110, rescue lane, breakdown, crash, "ev" = electric car (E-Kennzeichen, charging payment, plugs). Omit for a one-line overview of all nine.
city	string	optional	City the question is about, e.g. "Stuttgart", "München", "Munich". Narrows "lez" to that city's zone and adds the per-city caveat for "ev". Other topics are nationwide. Omit when the question is not about one city.
language	string	optional	Set this on every call to the language the person is writing in: "en" if they wrote English, "de" if they wrote German. Do not leave it out because it has a default — the default is only the fallback when the language is genuinely unclear, and an English question answered in German is a wrong answer. Place names, station names and road numbers are never translated in either language; in English the German term is kept in parentheses so the person recognises it on signs and in local apps.

Raw schema

{
  "type": "object",
  "properties": {
    "topic": {
      "description": "Which rule to answer. \"lez\" = low-emission zone and Feinstaubplakette, \"speed\" = speed limits including the Autobahn advisory 130, \"winter\" = winter-tyre duty, \"alcohol\" = alcohol and drugs, \"toll\" = car and lorry toll, \"truck_ban\" = Sunday and holiday lorry ban, \"equipment\" = what the law requires in the car, \"emergency\" = 112/110, rescue lane, breakdown, crash, \"ev\" = electric car (E-Kennzeichen, charging payment, plugs). Omit for a one-line overview of all nine.",
      "type": "string",
      "enum": [
        "lez",
        "speed",
        "winter",
        "alcohol",
        "toll",
        "truck_ban",
        "equipment",
        "emergency",
        "ev"
      ]
    },
    "city": {
      "description": "City the question is about, e.g. \"Stuttgart\", \"München\", \"Munich\". Narrows \"lez\" to that city's zone and adds the per-city caveat for \"ev\". Other topics are nationwide. Omit when the question is not about one city.",
      "type": "string",
      "minLength": 2,
      "maxLength": 60
    },
    "language": {
      "default": "de",
      "description": "Set this on every call to the language the person is writing in: \"en\" if they wrote English, \"de\" if they wrote German. Do not leave it out because it has a default — the default is only the fallback when the language is genuinely unclear, and an English question answered in German is a wrong answer. Place names, station names and road numbers are never translated in either language; in English the German term is kept in parentheses so the person recognises it on signs and in local apps.",
      "type": "string",
      "enum": [
        "de",
        "en"
      ]
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

check_transit_disruption

How punctual public transport is now in one German region: the share of trips ever over 5 min late, trips with a cancelled stop, the trend, and the service alerts in force there (diversions, closed stops). Use when asked whether buses and trains run normally, or a strike, storm or works disrupt them. Do NOT use for a station's departures or a line from a named DEPARTURE station ("RE1 ab Köln Hbf verspätet?"; a destination, "nach …"/"zum …", is not one) — get_train_departures. No per-line figures. Window ≤ 120 min. CC BY-SA (DELFI) or CC BY 4.0 (VBB, Berlin/Brandenburg): show attribution.

Parameters5

region	string	optional	The German region to report on, as free text: a Bundesland ("Bayern", "Bavaria", "Nordrhein-Westfalen"), a city ("Hamburg", "Köln"), a Kreis ("Landkreis Fulda") or one of the conurbations Ruhrgebiet, Rhein-Ruhr and Rhein-Main. A town inside a Kreis is reported as that Kreis and the answer says so, because the data is filed at Kreis level. Not a stop, not a street, not an address. Give either region OR lat+lon, never both.
lat	number	optional	Latitude in WGS 84, e.g. 48.137. Use with lon when the caller already holds coordinates; otherwise use region.
lon	number	optional	Longitude in WGS 84, e.g. 11.576. Use with lat; otherwise use region.
language	string	optional	Set this on every call to the language the person is writing in: "en" if they wrote English, "de" if they wrote German. Do not leave it out because it has a default — the default is only the fallback when the language is genuinely unclear, and an English question answered in German is a wrong answer. Place names, station names and road numbers are never translated in either language; in English the German term is kept in parentheses so the person recognises it on signs and in local apps.
window_min	integer	optional	How many minutes back to look, 5–120 (default 60). The trend compares this window with the equally long one before it, so 60 means "the last hour against the hour before". Use a short window for "right now" and a long one for "has it been bad all morning".

Raw schema

{
  "type": "object",
  "properties": {
    "region": {
      "description": "The German region to report on, as free text: a Bundesland (\"Bayern\", \"Bavaria\", \"Nordrhein-Westfalen\"), a city (\"Hamburg\", \"Köln\"), a Kreis (\"Landkreis Fulda\") or one of the conurbations Ruhrgebiet, Rhein-Ruhr and Rhein-Main. A town inside a Kreis is reported as that Kreis and the answer says so, because the data is filed at Kreis level. Not a stop, not a street, not an address. Give either region OR lat+lon, never both.",
      "type": "string",
      "minLength": 1,
      "maxLength": 120
    },
    "lat": {
      "description": "Latitude in WGS 84, e.g. 48.137. Use with lon when the caller already holds coordinates; otherwise use region.",
      "type": "number",
      "minimum": -90,
      "maximum": 90
    },
    "lon": {
      "description": "Longitude in WGS 84, e.g. 11.576. Use with lat; otherwise use region.",
      "type": "number",
      "minimum": -180,
      "maximum": 180
    },
    "language": {
      "default": "de",
      "description": "Set this on every call to the language the person is writing in: \"en\" if they wrote English, \"de\" if they wrote German. Do not leave it out because it has a default — the default is only the fallback when the language is genuinely unclear, and an English question answered in German is a wrong answer. Place names, station names and road numbers are never translated in either language; in English the German term is kept in parentheses so the person recognises it on signs and in local apps.",
      "type": "string",
      "enum": [
        "de",
        "en"
      ]
    },
    "window_min": {
      "default": 60,
      "description": "How many minutes back to look, 5–120 (default 60). The trend compares this window with the equally long one before it, so 60 means \"the last hour against the hour before\". Use a short window for \"right now\" and a long one for \"has it been bad all morning\".",
      "type": "integer",
      "minimum": 5,
      "maximum": 120
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

check_weather_warnings

Returns the official DWD weather warnings in force for a place or coordinate — storm, snow, ice, heavy rain, thunderstorm, heat — with the DWD's own Warnstufe 1–4, the area, the local validity window and the official text unaltered. Use when someone asks about weather for a trip, whether it is safe to drive somewhere, or about storm, snow or ice warnings. Do NOT use for a plain forecast (not offered: warnings only) or for closures and jams (call check_autobahn_traffic). Says so when the data is not current instead of reporting an all-clear. Show the result's attribution line to the user.

Parameters5

place	string	optional	Where to look, as free text: a city ("München", "Munich"), a district or Kreis ("Kreis Fulda"), a Bundesland, a station or stop ("Hamburg Hbf"), a motorway junction ("AK Neufahrn"), or a street address with a house number ("Bahnhofstraße 12, 36037 Fulda"). A motorway number alone ("A7") resolves to the road, which has no single point — name a town or junction on it instead. Use this instead of coordinates whenever the person named a place. An address needs its town or postcode — a street and a number alone exist in many towns. Give either place OR lat+lon, never both.
lat	number	optional	Latitude in WGS 84, e.g. 48.137. Use with lon when the caller already holds coordinates; otherwise use place.
lon	number	optional	Longitude in WGS 84, e.g. 11.576. Use with lat; otherwise use place.
language	string	optional	Set this on every call to the language the person is writing in: "en" if they wrote English, "de" if they wrote German. Do not leave it out because it has a default — the default is only the fallback when the language is genuinely unclear, and an English question answered in German is a wrong answer. Place names, station names and road numbers are never translated in either language; in English the German term is kept in parentheses so the person recognises it on signs and in local apps.
min_level	integer	optional	Lowest official DWD level to report, 0–4 (default 0, i.e. everything). The DWD's own names: 1 = Wetterwarnung, 2 = Markante Wetterwarnung, 3 = Unwetterwarnung, 4 = Warnung vor extremem Unwetter; 0 = Vorabinformation Unwetter, an advance notice that is not yet a Warnstufe. Raise it ONLY when the question names a level or a Warnstufe in so many words ("ab Stufe 3", "level 3 or higher", "nur Stufe 4"). Unwetter, Unwetterwarnung, severe and storm are the ordinary way to ask about bad weather, not a filter: leave it at 0 there — a level the caller filtered away is a warning the person is never told about.

Raw schema

{
  "type": "object",
  "properties": {
    "place": {
      "description": "Where to look, as free text: a city (\"München\", \"Munich\"), a district or Kreis (\"Kreis Fulda\"), a Bundesland, a station or stop (\"Hamburg Hbf\"), a motorway junction (\"AK Neufahrn\"), or a street address with a house number (\"Bahnhofstraße 12, 36037 Fulda\"). A motorway number alone (\"A7\") resolves to the road, which has no single point — name a town or junction on it instead. Use this instead of coordinates whenever the person named a place. An address needs its town or postcode — a street and a number alone exist in many towns. Give either place OR lat+lon, never both.",
      "type": "string",
      "minLength": 1,
      "maxLength": 120
    },
    "lat": {
      "description": "Latitude in WGS 84, e.g. 48.137. Use with lon when the caller already holds coordinates; otherwise use place.",
      "type": "number",
      "minimum": -90,
      "maximum": 90
    },
    "lon": {
      "description": "Longitude in WGS 84, e.g. 11.576. Use with lat; otherwise use place.",
      "type": "number",
      "minimum": -180,
      "maximum": 180
    },
    "language": {
      "default": "de",
      "description": "Set this on every call to the language the person is writing in: \"en\" if they wrote English, \"de\" if they wrote German. Do not leave it out because it has a default — the default is only the fallback when the language is genuinely unclear, and an English question answered in German is a wrong answer. Place names, station names and road numbers are never translated in either language; in English the German term is kept in parentheses so the person recognises it on signs and in local apps.",
      "type": "string",
      "enum": [
        "de",
        "en"
      ]
    },
    "min_level": {
      "default": 0,
      "description": "Lowest official DWD level to report, 0–4 (default 0, i.e. everything). The DWD's own names: 1 = Wetterwarnung, 2 = Markante Wetterwarnung, 3 = Unwetterwarnung, 4 = Warnung vor extremem Unwetter; 0 = Vorabinformation Unwetter, an advance notice that is not yet a Warnstufe. Raise it ONLY when the question names a level or a Warnstufe in so many words (\"ab Stufe 3\", \"level 3 or higher\", \"nur Stufe 4\"). Unwetter, Unwetterwarnung, severe and storm are the ordinary way to ask about bad weather, not a filter: leave it at 0 there — a level the caller filtered away is a warning the person is never told about.",
      "type": "integer",
      "minimum": 0,
      "maximum": 4
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_train_departures

Next departures from a German railway station, with platform, delay, cancellations. Use when asked when a train, S-Bahn or ICE leaves a named station, or if a train or line from it is late ("RE1 from Köln Hbf late?"); later today ("heute Abend") stays here. A line with no DEPARTURE station ("ist die S1 pünktlich?"; a destination, "nach …"/"zum …", is not one) — check_transit_disruption. Do NOT use for buses, trams, a non-railway stop, another day or a time over 2 h away — get_departures. No destination filter: read the board. ≤ 15 departures, window 120 min. Show the attribution line.

Parameters6

station	string	optional	The railway station, as the person says it: "Hamburg Hbf", "Köln Hbf", "Munich Central", "Frankfurt (Main) Hbf". Pass their words — English names and "central station" are understood. If the name fits several stations (a bare "Hauptbahnhof"), call anyway: the result lists them and asks which; do not guess one yourself. Give either station OR eva_no, never both.
eva_no	string	optional	The station's EVA number (6–8 digits, e.g. 8002549 for Hamburg Hbf), when a previous result gave you one. It skips the name lookup and is exact — use it to answer a follow-up about a station this tool has already named.
when	string	optional	Start of the window as an ISO-8601 instant with an offset ("2026-09-20T18:30:00+02:00"). Leave it out for "now", which is what almost every question means. Times in the answer are Europe/Berlin whatever you pass.
duration_min	integer	optional	How far ahead to look, in minutes (5–120, default 60). Use a small window for "what leaves now" and a larger one for "this evening". Above 120 is refused: a departure board is not a timetable search.
limit	integer	optional	How many departures to return, earliest first (1–15, default 10). More than 15 is refused — that is a board a person can read, not a dataset.
language	string	optional	Set this on every call to the language the person is writing in: "en" if they wrote English, "de" if they wrote German. Do not leave it out because it has a default — the default is only the fallback when the language is genuinely unclear, and an English question answered in German is a wrong answer. Place names, station names and road numbers are never translated in either language; in English the German term is kept in parentheses so the person recognises it on signs and in local apps.

Raw schema

{
  "type": "object",
  "properties": {
    "station": {
      "description": "The railway station, as the person says it: \"Hamburg Hbf\", \"Köln Hbf\", \"Munich Central\", \"Frankfurt (Main) Hbf\". Pass their words — English names and \"central station\" are understood. If the name fits several stations (a bare \"Hauptbahnhof\"), call anyway: the result lists them and asks which; do not guess one yourself. Give either station OR eva_no, never both.",
      "type": "string",
      "minLength": 1,
      "maxLength": 120
    },
    "eva_no": {
      "description": "The station's EVA number (6–8 digits, e.g. 8002549 for Hamburg Hbf), when a previous result gave you one. It skips the name lookup and is exact — use it to answer a follow-up about a station this tool has already named.",
      "type": "string",
      "pattern": "^\\d{6,8}$"
    },
    "when": {
      "description": "Start of the window as an ISO-8601 instant with an offset (\"2026-09-20T18:30:00+02:00\"). Leave it out for \"now\", which is what almost every question means. Times in the answer are Europe/Berlin whatever you pass.",
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
    },
    "duration_min": {
      "default": 60,
      "description": "How far ahead to look, in minutes (5–120, default 60). Use a small window for \"what leaves now\" and a larger one for \"this evening\". Above 120 is refused: a departure board is not a timetable search.",
      "type": "integer",
      "minimum": 5,
      "maximum": 120
    },
    "limit": {
      "default": 10,
      "description": "How many departures to return, earliest first (1–15, default 10). More than 15 is refused — that is a board a person can read, not a dataset.",
      "type": "integer",
      "minimum": 1,
      "maximum": 15
    },
    "language": {
      "default": "de",
      "description": "Set this on every call to the language the person is writing in: \"en\" if they wrote English, \"de\" if they wrote German. Do not leave it out because it has a default — the default is only the fallback when the language is genuinely unclear, and an English question answered in German is a wrong answer. Place names, station names and road numbers are never translated in either language; in English the German term is kept in parentheses so the person recognises it on signs and in local apps.",
      "type": "string",
      "enum": [
        "de",
        "en"
      ]
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_departures

Scheduled departures from any German stop — bus, tram, U-Bahn, S-Bahn, train, ferry — with line, destination, platform. Use when asked when a bus, tram, U-Bahn or ferry goes, or for another DAY or a clock time over 2 h away: "Wann fährt der nächste Bus ab Fulda Bahnhof?" Do NOT use for a railway station's trains now or later today — get_train_departures. Planned times only: for "is my bus late?" give the plan and say so; regional punctuality check_transit_disruption. No A-to-B journeys: say so, no call. Holds ≥ 48 h ahead, ≤ 3 days; further out, say so. 15 per call. Show the attribution line.

Parameters7

stop	string	optional	The stop, as the person says it: "Fulda, Bahnhof", "München, Marienplatz", "Köln, Hbf", "Hamburg, Rathausmarkt" (town first). Include the town when the person did — half the names in Germany exist in twenty towns, and a bare "Bahnhof" or "Hauptbahnhof" comes back as a list of candidates to choose from, so call it and let the result ask. Pass their words; do not guess an id. Give either stop OR the stop id, never both.
stop_id	string	optional	The stop's timetable id, exactly as a previous result of this tool gave it ("de:06631:1234"). It skips the name lookup and is exact — use it for a follow-up about a stop this tool has already named, and for one the person picked out of a candidate list.
when	string	optional	Start of the window as an ISO-8601 instant with an offset ("2026-10-02T07:30:00+02:00"). Leave it out for "now". Convert the person's words yourself — "morgen früh", "tonight" — and pass the instant; the answer is always rendered in Europe/Berlin.
duration_min	integer	optional	How far past that moment to look, in minutes (5–1440, default 60). Small for "what goes now", a few hours for an evening. To look further ahead (the timetable reaches at least 48 h), move `when` instead of widening this: a window of a whole day returns at most 15 rows and would answer about the wrong half of it.
modes	array	optional	Keep only these kinds of service: "bus", "tram", "subway" (U-Bahn), "rail" (every train, including S-Bahn and regional) or "ferry". Omit it unless the person named a kind — "nur Busse", "welche Tram". Several are allowed, which is what "die Busse und Bahnen vor dem Hbf" means. An S-Bahn is "rail": the feed does not always distinguish it, and the line name ("S 6") says which it is.
limit	integer	optional	How many departures to return, earliest first (1–15, default 10). The result always says how many more were in the window.
language	string	optional	Set this on every call to the language the person is writing in: "en" if they wrote English, "de" if they wrote German. Do not leave it out because it has a default — the default is only the fallback when the language is genuinely unclear, and an English question answered in German is a wrong answer. Place names, station names and road numbers are never translated in either language; in English the German term is kept in parentheses so the person recognises it on signs and in local apps.

Raw schema

{
  "type": "object",
  "properties": {
    "stop": {
      "description": "The stop, as the person says it: \"Fulda, Bahnhof\", \"München, Marienplatz\", \"Köln, Hbf\", \"Hamburg, Rathausmarkt\" (town first). Include the town when the person did — half the names in Germany exist in twenty towns, and a bare \"Bahnhof\" or \"Hauptbahnhof\" comes back as a list of candidates to choose from, so call it and let the result ask. Pass their words; do not guess an id. Give either stop OR the stop id, never both.",
      "type": "string",
      "minLength": 2,
      "maxLength": 120
    },
    "stop_id": {
      "description": "The stop's timetable id, exactly as a previous result of this tool gave it (\"de:06631:1234\"). It skips the name lookup and is exact — use it for a follow-up about a stop this tool has already named, and for one the person picked out of a candidate list.",
      "type": "string",
      "minLength": 3,
      "maxLength": 64
    },
    "when": {
      "description": "Start of the window as an ISO-8601 instant with an offset (\"2026-10-02T07:30:00+02:00\"). Leave it out for \"now\". Convert the person's words yourself — \"morgen früh\", \"tonight\" — and pass the instant; the answer is always rendered in Europe/Berlin.",
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
    },
    "duration_min": {
      "default": 60,
      "description": "How far past that moment to look, in minutes (5–1440, default 60). Small for \"what goes now\", a few hours for an evening. To look further ahead (the timetable reaches at least 48 h), move `when` instead of widening this: a window of a whole day returns at most 15 rows and would answer about the wrong half of it.",
      "type": "integer",
      "minimum": 5,
      "maximum": 1440
    },
    "modes": {
      "description": "Keep only these kinds of service: \"bus\", \"tram\", \"subway\" (U-Bahn), \"rail\" (every train, including S-Bahn and regional) or \"ferry\". Omit it unless the person named a kind — \"nur Busse\", \"welche Tram\". Several are allowed, which is what \"die Busse und Bahnen vor dem Hbf\" means. An S-Bahn is \"rail\": the feed does not always distinguish it, and the line name (\"S 6\") says which it is.",
      "minItems": 1,
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "rail",
          "subway",
          "tram",
          "bus",
          "ferry"
        ]
      }
    },
    "limit": {
      "default": 10,
      "description": "How many departures to return, earliest first (1–15, default 10). The result always says how many more were in the window.",
      "type": "integer",
      "minimum": 1,
      "maximum": 15
    },
    "language": {
      "default": "de",
      "description": "Set this on every call to the language the person is writing in: \"en\" if they wrote English, \"de\" if they wrote German. Do not leave it out because it has a default — the default is only the fallback when the language is genuinely unclear, and an English question answered in German is a wrong answer. Place names, station names and road numbers are never translated in either language; in English the German term is kept in parentheses so the person recognises it on signs and in local apps.",
      "type": "string",
      "enum": [
        "de",
        "en"
      ]
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

check_station_facilities

Report whether the lifts and escalators of a German railway station — or of a Köln Stadtbahn stop — are working now: each one, where it is, its state (in service / out of service / unknown) and the operator's explanation. Use when asked about step-free access or a broken lift: "Funktioniert der Aufzug am Kölner Hauptbahnhof?", "is the lift at Hamburg Hbf working?", "Rolltreppe am Neumarkt kaputt?", wheelchair, pram, heavy luggage. Do NOT use for train times, platforms or delays — call get_train_departures. At most 50 facilities, out-of-service ones first. Results carry their attribution line.

Parameters5

station	string	optional	The railway station — or Köln Stadtbahn stop — as the person says it: "Köln Hbf", "Hamburg Hbf", "Munich Central", "Neumarkt Köln". Pass their words — English names and "central station" are understood. If the name fits several stations the result lists them and asks which; do not guess one yourself. Give either station OR eva_no, never both.
eva_no	string	optional	The station's EVA number (6–8 digits, e.g. 8000207 for Köln Hbf), when a previous result — a departure board, for instance — already gave you one. It skips the name lookup and is exact.
facility	string	optional	Which equipment to report: "elevator" for lifts only, "escalator" for escalators only, "any" for both (default). Pass a value only when the person named the equipment itself ("Aufzug", "Rolltreppe", "lift", "escalator"): a question about a wheelchair, a pram, heavy luggage or step-free access keeps the default — an escalator carries a suitcase too, and a filter there hides half of what the traveller needs. Filtering does not change how a broken one is reported, only which ones are listed.
limit	integer	optional	How many facilities to list (1–50, default 20). Out-of-service equipment is listed first and the counts in the summary always cover ALL of them, so a shorter list never hides a broken lift.
language	string	optional	Set this on every call to the language the person is writing in: "en" if they wrote English, "de" if they wrote German. Do not leave it out because it has a default — the default is only the fallback when the language is genuinely unclear, and an English question answered in German is a wrong answer. Place names, station names and road numbers are never translated in either language; in English the German term is kept in parentheses so the person recognises it on signs and in local apps.

Raw schema

{
  "type": "object",
  "properties": {
    "station": {
      "description": "The railway station — or Köln Stadtbahn stop — as the person says it: \"Köln Hbf\", \"Hamburg Hbf\", \"Munich Central\", \"Neumarkt Köln\". Pass their words — English names and \"central station\" are understood. If the name fits several stations the result lists them and asks which; do not guess one yourself. Give either station OR eva_no, never both.",
      "type": "string",
      "minLength": 1,
      "maxLength": 120
    },
    "eva_no": {
      "description": "The station's EVA number (6–8 digits, e.g. 8000207 for Köln Hbf), when a previous result — a departure board, for instance — already gave you one. It skips the name lookup and is exact.",
      "type": "string",
      "pattern": "^\\d{6,8}$"
    },
    "facility": {
      "default": "any",
      "description": "Which equipment to report: \"elevator\" for lifts only, \"escalator\" for escalators only, \"any\" for both (default). Pass a value only when the person named the equipment itself (\"Aufzug\", \"Rolltreppe\", \"lift\", \"escalator\"): a question about a wheelchair, a pram, heavy luggage or step-free access keeps the default — an escalator carries a suitcase too, and a filter there hides half of what the traveller needs. Filtering does not change how a broken one is reported, only which ones are listed.",
      "type": "string",
      "enum": [
        "any",
        "elevator",
        "escalator"
      ]
    },
    "limit": {
      "default": 20,
      "description": "How many facilities to list (1–50, default 20). Out-of-service equipment is listed first and the counts in the summary always cover ALL of them, so a shorter list never hides a broken lift.",
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    },
    "language": {
      "default": "de",
      "description": "Set this on every call to the language the person is writing in: \"en\" if they wrote English, \"de\" if they wrote German. Do not leave it out because it has a default — the default is only the fallback when the language is genuinely unclear, and an English question answered in German is a wrong answer. Place names, station names and road numbers are never translated in either language; in English the German term is kept in parentheses so the person recognises it on signs and in local apps.",
      "type": "string",
      "enum": [
        "de",
        "en"
      ]
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

watch_situation

Opens a watch so THIS conversation is told when something changes: a road reopening, a stop running late, a weather warning starting, a charge point turning free. Use when the person asks to be told later: "sag mir Bescheid, wenn die A8 wieder frei ist", "tell me when a charger is free". Do NOT use to look something up now (call check_road_status, check_autobahn_traffic or find_charging_station), and do NOT use when an e-mail, SMS or any alert outside this chat was asked for — we cannot send one; say so. Session-scoped. At most 10 watches, 24 h each. Results carry their attribution line.

Parameters6

language	string	optional	Set this on every call to the language the person is writing in: "en" if they wrote English, "de" if they wrote German. Do not leave it out because it has a default — the default is only the fallback when the language is genuinely unclear, and an English question answered in German is a wrong answer. Place names, station names and road numbers are never translated in either language; in English the German term is kept in parentheses so the person recognises it on signs and in local apps.
kind	string	required	What kind of thing to watch. `road` = one motorway or federal road (key: "A8", "B27") — reports a closure or restriction appearing or clearing; `station` = one public-transport stop by its DHID (key: "de:14612:28") — reports departures running late past the threshold; `region` = a city or district by AGS prefix (key: "14612") — reports the share of late trips crossing the threshold; `place` = a town or address (key: "Fulda") — reports road restrictions appearing within the radius; `weather` = a DWD warncell (key: "105315000") — reports an official warning coming into force; `charger` = one charging site (key: the site id from find_charging_station) — reports a point turning free.
key	string	required	The thing being watched, in the vocabulary of `kind`: a road number, a stop DHID, an AGS prefix, a place name, a DWD warncell, a charging site id. For `road` and `place` it is the person's own words — "A8", "B27", "Fulda" — and needs no lookup. For `station`, `region`, `weather` and `charger` it is an identifier the matching read tool returned — look it up first: `station` = one of `stop.stopIds` from get_departures ("de:14612:28"); an EVA number from get_train_departures ("8000207") is NOT a stop id and is refused, as is any id no known stop carries; `region` from check_transit_disruption, `weather` from check_weather_warnings, `charger` from find_charging_station — a key nothing matches there produces a watch that is simply never triggered.
hours	number	optional	How long to watch, in hours (default 3, maximum 24). Prefer this over `until`: it needs no knowledge of the current time. Give one of `hours` or `until`, never both.
until	string	optional	An explicit end instant as ISO-8601 with an offset ("2026-09-20T18:40:00+02:00"), at most 24 hours ahead. Use only when the person named a time; otherwise use `hours`. Give one of `hours` or `until`, never both.
condition	object	optional	Optional threshold. Each key belongs to ONE kind and a key that does not belong to the chosen kind is refused by name; leave it out to use that kind's default.

Raw schema

{
  "type": "object",
  "properties": {
    "language": {
      "default": "de",
      "description": "Set this on every call to the language the person is writing in: \"en\" if they wrote English, \"de\" if they wrote German. Do not leave it out because it has a default — the default is only the fallback when the language is genuinely unclear, and an English question answered in German is a wrong answer. Place names, station names and road numbers are never translated in either language; in English the German term is kept in parentheses so the person recognises it on signs and in local apps.",
      "type": "string",
      "enum": [
        "de",
        "en"
      ]
    },
    "kind": {
      "type": "string",
      "enum": [
        "road",
        "station",
        "region",
        "place",
        "weather",
        "charger"
      ],
      "description": "What kind of thing to watch. `road` = one motorway or federal road (key: \"A8\", \"B27\") — reports a closure or restriction appearing or clearing; `station` = one public-transport stop by its DHID (key: \"de:14612:28\") — reports departures running late past the threshold; `region` = a city or district by AGS prefix (key: \"14612\") — reports the share of late trips crossing the threshold; `place` = a town or address (key: \"Fulda\") — reports road restrictions appearing within the radius; `weather` = a DWD warncell (key: \"105315000\") — reports an official warning coming into force; `charger` = one charging site (key: the site id from find_charging_station) — reports a point turning free."
    },
    "key": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "The thing being watched, in the vocabulary of `kind`: a road number, a stop DHID, an AGS prefix, a place name, a DWD warncell, a charging site id. For `road` and `place` it is the person's own words — \"A8\", \"B27\", \"Fulda\" — and needs no lookup. For `station`, `region`, `weather` and `charger` it is an identifier the matching read tool returned — look it up first: `station` = one of `stop.stopIds` from get_departures (\"de:14612:28\"); an EVA number from get_train_departures (\"8000207\") is NOT a stop id and is refused, as is any id no known stop carries; `region` from check_transit_disruption, `weather` from check_weather_warnings, `charger` from find_charging_station — a key nothing matches there produces a watch that is simply never triggered."
    },
    "hours": {
      "description": "How long to watch, in hours (default 3, maximum 24). Prefer this over `until`: it needs no knowledge of the current time. Give one of `hours` or `until`, never both.",
      "type": "number",
      "minimum": 0.25,
      "maximum": 24
    },
    "until": {
      "description": "An explicit end instant as ISO-8601 with an offset (\"2026-09-20T18:40:00+02:00\"), at most 24 hours ahead. Use only when the person named a time; otherwise use `hours`. Give one of `hours` or `until`, never both.",
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
    },
    "condition": {
      "description": "Optional threshold. Each key belongs to ONE kind and a key that does not belong to the chosen kind is refused by name; leave it out to use that kind's default.",
      "type": "object",
      "properties": {
        "delay_min": {
          "description": "station: minutes of delay that count as a disruption (default 10).",
          "type": "integer",
          "minimum": 1,
          "maximum": 600
        },
        "late_share": {
          "description": "region: share of observed trips running late that trips the watch (default 0.25).",
          "type": "number",
          "minimum": 0.01,
          "maximum": 1
        },
        "min_trips": {
          "description": "region: below this many observed trips the share is noise (default 10).",
          "type": "integer",
          "minimum": 1,
          "maximum": 10000
        },
        "radius_km": {
          "description": "place: how far around the place to look (default 25).",
          "type": "number",
          "minimum": 0.1,
          "maximum": 200
        },
        "min_level": {
          "description": "weather: lowest DWD warning level worth reporting (default 2).",
          "type": "integer",
          "minimum": 0,
          "maximum": 4
        },
        "event": {
          "description": "road: 'reopen' reports only a restriction clearing; 'any' reports both (default).",
          "type": "string",
          "enum": [
            "reopen",
            "any"
          ]
        },
        "point_id": {
          "description": "charger: one charge point of the site instead of any of them.",
          "type": "string",
          "minLength": 1,
          "maxLength": 200
        }
      }
    }
  },
  "required": [
    "kind",
    "key"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

stop_watch

Ends a watch this conversation opened with watch_situation, so no further notifications arrive for it. Use when the person no longer needs to be told — "du musst mir nichts mehr zur A8 sagen", "stop watching that charger". No id at hand: pass kind ("charger") and, for a road or place, key ("A8", "Bamberg"); one match is stopped, several are listed. Do NOT use to look a situation up (call check_road_status), to list what is running (read viafrei://watches), or to cancel anything outside this chat. Another session's watch is never found. Results carry their attribution line.

Parameters5

language	string	optional	Set this on every call to the language the person is writing in: "en" if they wrote English, "de" if they wrote German. Do not leave it out because it has a default — the default is only the fallback when the language is genuinely unclear, and an English question answered in German is a wrong answer. Place names, station names and road numbers are never translated in either language; in English the German term is kept in parentheses so the person recognises it on signs and in local apps.
watch_id	integer	optional	The numeric id of the watch to stop, as `watch_situation` returned it (the 12 in viafrei://watch/12).
uri	string	optional	The watch's resource uri, e.g. "viafrei://watch/12". Give either this or `watch_id`, not both.
kind	string	optional	Instead of an id: the kind of watch the person means, as watch_situation took it ("road", "station", "region", "place", "weather", "charger"). "Turn off the charging alert" is kind "charger" alone.
key	string	optional	Instead of an id: the watched subject in the person's words, as watch_situation took it — works for road and place watches ("A8", "Bamberg"). For station, region, weather and charger watches `kind` alone is enough when one is open, and a key that matches none of them falls back to the kind alone. Matched against this session's open watches, case and spaces ignored. One match is stopped; several are listed and none is stopped.

Raw schema

{
  "type": "object",
  "properties": {
    "language": {
      "default": "de",
      "description": "Set this on every call to the language the person is writing in: \"en\" if they wrote English, \"de\" if they wrote German. Do not leave it out because it has a default — the default is only the fallback when the language is genuinely unclear, and an English question answered in German is a wrong answer. Place names, station names and road numbers are never translated in either language; in English the German term is kept in parentheses so the person recognises it on signs and in local apps.",
      "type": "string",
      "enum": [
        "de",
        "en"
      ]
    },
    "watch_id": {
      "description": "The numeric id of the watch to stop, as `watch_situation` returned it (the 12 in viafrei://watch/12).",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "uri": {
      "description": "The watch's resource uri, e.g. \"viafrei://watch/12\". Give either this or `watch_id`, not both.",
      "type": "string",
      "maxLength": 64
    },
    "kind": {
      "description": "Instead of an id: the kind of watch the person means, as watch_situation took it (\"road\", \"station\", \"region\", \"place\", \"weather\", \"charger\"). \"Turn off the charging alert\" is kind \"charger\" alone.",
      "type": "string",
      "enum": [
        "road",
        "station",
        "region",
        "place",
        "weather",
        "charger"
      ]
    },
    "key": {
      "description": "Instead of an id: the watched subject in the person's words, as watch_situation took it — works for road and place watches (\"A8\", \"Bamberg\"). For station, region, weather and charger watches `kind` alone is enough when one is open, and a key that matches none of them falls back to the kind alone. Matched against this session's open watches, case and spaces ignored. One match is stopped; several are listed and none is stopped.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

README.md38 KBView on GitHub

ViaFrei

Germany's traffic, trains, charging and roads — in your AI assistant.

Ask in plain words. Get the live answer, with its source.

viafrei.de · Connect your assistant · For developers · For businesses · All tools · API reference

code

claude mcp add --transport http viafrei https://mcp.viafrei.de/mcp

Free. No account, no API key, no sign-up. One line and your assistant knows whether the A8 is jammed, whether your train is late, where the nearest Type 2 charger is (and whether it is free, where the operator publishes that) and whether the lift at your station works — from official German open data, live, with the source named in every answer.

Beta. ViaFrei is being stabilised: sources are still being added, and answers and coverage can change. The answers are written by an AI assistant from our data, and AI can make mistakes, so check anything important (a closure, a departure, a price) against the source each answer names.

New in 1.8: a twenty-first tool, find_sharing, for shared bikes (nextbike and Donkey Republic). Berlin and Brandenburg punctuality now comes from VBB's own realtime feed. Road answers now include police and city traffic reports from Baden-Württemberg, Schleswig-Holstein and Berlin (and from Köln and Hannover whenever those cities publish one), and roadworks on Bundes- and Landesstraßen in Niedersachsen, Sachsen and Thüringen. Charging gains the Bundesnetzagentur register and more live status, and parking gains Hamburg, Münster and NRW car parks. Every source is listed in SOURCES.md.

🧳 What you can ask

You don't need to know any tool names. Ask the way you'd ask a friend who happens to have every German traffic feed open. German or English; the answer comes back in the language you asked in.

when you're…	ask
🌅 about to commute	Fahren Busse und Bahnen in Bayern gerade pünktlich? · When does the next train leave Hamburg Hbf?
🚗 about to drive	Gibt es Stau auf der A8? · Are there roadworks on the A7 next week? · Is the A1 closed anywhere?
🚧 stuck in traffic	How much time is the jam on the A3 between Frankfurt and Würzburg costing right now? · Is traffic backed up on the Cologne motorway ring — A1, A3 or A4? · Ist der Elbtunnel auf der A7 heute Nacht gesperrt?
⚡ driving electric	Where can I charge with Type 2 near Leipzig? · Wo gibt es einen Schnelllader mit 150 kW bei Nürnberg?
🅿️ driving a lorry	Find a rest area with lorry parking on the A9 · Wo ist der nächste Lkw-Parkplatz an der A7?
♿ travelling step-free	Funktioniert der Aufzug am Bahnhof Köln Messe/Deutz?
🌦️ watching the weather	Gibt es eine Unwetterwarnung für Freiburg?
📍 looking for a place	What is the address of the Elbphilharmonie in Hamburg? · Welche Apotheken gibt es in Fulda? · My satnav shows 50.1109, 8.6821 — what address is that?
🇩🇪 new to German roads	Do I need an emission sticker for Stuttgart? · Is there a speed limit on the Autobahn?
⏳ waiting for news	Tell me as soon as the closure on the A7 is lifted. · Sag mir Bescheid, wenn in Köln ein Viertel oder mehr der Bus- und Bahnfahrten verspätet ist. · Warn me when a DWD severe-weather warning comes into force for Cologne.

What the answers cover, honestly. Live traffic is the motorways. Closures and roadworks also cover federal roads, Land roads in Niedersachsen, Sachsen and Thüringen, and the traffic reports some Länder and cities publish (Baden-Württemberg, Schleswig-Holstein, Berlin, Köln, Hannover); other city streets are not covered. Places and addresses come from OpenStreetMap, so what is not mapped there cannot be found, and opening hours and ratings are not part of it. A watch lives in the conversation that opened it: the server keeps every change there, and your assistant shows it when you ask, or on its own if your client supports MCP notifications. Nothing is sent by e-mail or SMS. Up to 10 watches per conversation, each for up to 24 hours (3 by default), and a road is watched as a whole, not one section of it.

💬 Real answers

These came back from the production server at https://mcp.viafrei.de/mcp (server 1.8.18) on 2026-10-06, 23:00 Berlin time. They are not mock-ups. Each one shows the first lines of what the tool returned, and the source line exactly as it was sent, shortened where marked.

🚆 "Welche Züge fahren als Nächstes ab Hamburg Hbf?" — get_train_departures

text

Abfahrten ab Hamburg Hbf (nächste 60 Minuten):
23:00 S S5 → Hamburg Elbgaustraße, ab Hamburg Hbf (S-Bahn), Gleis 2, pünktlich
23:00 S S7 → Hamburg-Altona(S), ab Hamburg Hbf (S-Bahn), Gleis 1, pünktlich
23:02 S S5 → Hamburg-Neugraben, ab Hamburg Hbf (S-Bahn), Gleis 4, pünktlich
23:06 RE RE5 → Cuxhaven, ab Hamburg Hbf, Gleis 14A-C, pünktlich

Stand 22:59 · Quelle: Fahrplandaten: Deutsche Bahn AG, DB API Marketplace, CC BY 4.0, bearbeitet (https://developers.deutschebahn.com; …) · …

Platform, delay and the estimated real departure, in one line each. Edited: six of ten departures omitted. The board listed the first two S-Bahn rows twice; that is a known defect being fixed, and the repeats are among the omitted rows.

♿ "Funktioniert der Aufzug am Bahnhof Köln Messe/Deutz?" — check_station_facilities

text

In Köln Messe/Deutz ist 1 von 10 gemeldeten Anlagen außer Betrieb.
Fahrtreppe zu Gleis 4/5: außer Betrieb
Aufzug Aufzug Gl. 12 KVB Tunnel: in Betrieb
Aufzug zu Gleis 11: in Betrieb
…
Stadtbahn Köln Bf Deutz/Messe LANXESS arena (Störungsliste Stand 22:59): 1 von 17 gemeldeten Anlagen ist außer Betrieb. …
Fahrtreppe 60 - HÜ 083 (Bf. Deutz/Messe): außer Betrieb, gemeldet seit 17:32

The railway station and the Stadtbahn stop below it, from two operators, in one answer. For anyone with a wheelchair, a pram or a heavy suitcase, this is the difference between a station being usable and not. Edited: most facilities of both lists omitted, and the source lines cut.

⚡ "Where can I charge with Type 2 near Leipzig?" — find_charging_station

text

Charging around Leipzig (within 10 km, Type 2), nearest first:
1. Parkhaus Neumarkt, Neumarkt 30, 04109 Leipzig (Parkhaus Neumarkt) — 0.2 km, Type 2, up to 22 kW, no status data, per charging point register
2. Motel One Leipzig Nikolaikirche, Schuhmachergäßchen 5, 04109 Leipzig (Wirelane GmbH) — 0.3 km, Type 2, up to 11 kW, no status data, per charging point register
…
Only a few operators publish live occupancy; "no status data" means unknown, not free.
Charging point register as of 2026-09-01 — chargers as reported by their operators to the Bundesnetzagentur, with no live occupancy and no warranty of accuracy or completeness.

As of 23:00 · Source: Ladesäulenregister: Bundesnetzagentur.de, CC BY 4.0, bearbeitet (…) · …

It says what it does not know: "no status data" is unknown, never free. Edited: entries 3–5 omitted, a municipality key removed from the heading, and the sources cut to ….

🚦 "Is public transport in North Rhine-Westphalia running on time?" — check_transit_disruption

text

North Rhine-Westphalia: 8% of observed trips more than 5 minutes late (324 of 4,088 trips
in the last 60 minutes, from 60,858 reports at 18,923 stops), 90 trips with cancelled stops.
…
Trend: about the same as the 60 minutes before (9%).
…
Published service alerts for North Rhine-Westphalia, in force now (1):
- Line 515: Straßensperrung Liebigstraße / Haltestellenentfall (valid 2026-05-18 to 2026-11-12)

As of 22:58 · Source: Echtzeitdaten: DELFI e.V. via Mobilithek, CC BY-SA, bearbeitet (…) · …

Region-wide, with the method stated, and the operators' own service alerts beside the figure. The share-alike condition arrives as part of the answer, because it is part of the data. Edited: the method paragraphs between the figure and the alerts omitted, and the sources cut to ….

📍 "What is at 52.5163, 13.3777?" — describe_location

text

Description of 52.5163, 13.3777:
- Nearest address: Pariser Platz 1, 10117 Berlin (3 m)
- Settlement: Unter den Linden (0.7 km)
- District: Berlin (1.9 km)
- Administrative area: Berlin (2.3 km)
- Junction: AS Sachsendamm (A100) (5.0 km)

Address data as of 2026-10-04
As of 23:00 · Source: Ortsdaten: © GeoNames (CC BY 4.0), bearbeitet (…) · … · OSM-Standortdaten: © OpenStreetMap-Mitwirkende, ODbL 1.0 (https://www.openstreetmap.org/copyright; …)

That's the Brandenburg Gate. Edited: two of four sources cut to ….

🇩🇪 "Do I need an emission sticker for Stuttgart?" — get_driving_rules

text

Low-emission zone Stuttgart: yes, you need the green Feinstaubplakette.
• Stuttgart: Zone covering the entire city area — it starts at the city boundary, not at the centre.
  Required: the green plaque (emission group 4). …
  [to verify: Stuttgart's additional diesel restrictions have changed repeatedly; check the city's current position]
  (Umweltbundesamt, Umweltzonen in Deutschland)
…

Every statement carries its source, and says [to verify] where we could not confirm it. Edited: most points omitted.

🅿️ "Find lorry parking on the A9" — find_parking

text

Parking along the A9:
1. Aster Moos O — Lorry parking (Lkw-Parkplatz), 14 lorry spaces, no occupancy published
2. Baarer Weiher O — Lorry parking (Lkw-Parkplatz), 45 lorry spaces, no occupancy published
…
As of 23:00 · Source: Verkehrsdaten: Autobahn GmbH des Bundes (https://verkehr.autobahn.de)
Where no "free" count is shown the operator publishes no occupancy — it does not mean the site is full.

Edited: three of five sites omitted.

Why the source line matters. Every answer ends with one, and it is the licence speaking: show it to whoever reads the answer. Copy the line the server sends you, not the ones on this page, which are shortened. See Using the data you get back.

🔌 Connect in one minute

The product is a hosted MCP server. Point your client at it and the tools appear. There is nothing to install, no key to request and no quota to negotiate. Step-by-step guides for each assistant: viafrei.de/en/connect.

Claude Code

bash

claude mcp add --transport http viafrei https://mcp.viafrei.de/mcp

Claude (desktop app and claude.ai), ChatGPT and other apps that take a connector URL — add a custom connector with this address (in Claude: Settings → Connectors → Add custom connector; in ChatGPT the connector settings need developer mode):

code

https://mcp.viafrei.de/mcp

Cursor, and any client with an mcpServers file that takes a url, over HTTP:

json

{ "mcpServers": { "viafrei": { "url": "https://mcp.viafrei.de/mcp" } } }

VS Code (.vscode/mcp.json, or MCP: Add Server from the command palette):

json

{ "servers": { "viafrei": { "type": "http", "url": "https://mcp.viafrei.de/mcp" } } }

Clients that speak only stdio — for example Claude Desktop's config file (claude_desktop_config.json, opened from Settings → Developer → Edit Config). That is what this package is for:

json

{ "mcpServers": { "viafrei": { "command": "npx", "args": ["-y", "viafrei"] } } }

Node 22 or newer. npx fetches the bridge when your client starts it. If the file already has an mcpServers block, add the "viafrei" entry inside it rather than pasting a second block.

An older client on HTTP+SSE is answered too, at https://mcp.viafrei.de/sse. The transport is deprecated in the specification, so prefer the address above when you can:

bash

claude mcp add --transport sse viafrei https://mcp.viafrei.de/sse

Restart the client and ask one of the questions above.

Where to find ViaFrei

npm — viafrei. This package: the stdio bridge, for the config line above. Its page shows the current version and this README.
Smithery — smithery.ai/servers/viafrei/viafrei. Connect through Smithery's hosted connection, with no local install.
Glama — glama.ai/mcp/servers/mavrovde/viafrei-mcp. The directory listing for this repository, with the tool list.
Official MCP Registry — de.viafrei/mcp. The hosted endpoint, as MCP clients and directories that read the registry find it; server.json is the entry. It is the registry's own record, republished by hand when the listing changes, so its version may differ from this package's.
For AI tools — viafrei.de/llms.txt and llms-full.txt: what ViaFrei is, how to connect, and every tool in one line each.

🧰 Everything it can do

21 tools, 9 prompts, 10 resources and 2 resource templates — server 1.8.30, snapshot of 2026-10-08. Each line is the server's own words; the full parameters are in API.md.

🚗 On the road

tool	what it answers
`check_autobahn_traffic` — Autobahn traffic	Jams, slow traffic, closures and roadworks in force this minute on up to 5 motorways, with delay/speed.
`check_road_status` — Road status and closures	Whether a motorway, B road or Land road (NI, SN, TH) is open, closed or restricted, now and in coming days; by place, jams and city/Land messages near a town.
`find_roadworks_ahead` — Planned roadworks	Returns roadworks PLANNED on one German motorway, or one Bundes- or Landesstraße in Niedersachsen, Sachsen or Thüringen, in a date window: section, restriction, start and end.
`find_parking` — Parking nearby	Returns parking near a place, a coordinate or along one motorway: rest areas with lorry spaces, car parks and P+R sites, with total spaces and, where published, free spaces now and the reading's age.

🚆 Public transport

tool	what it answers
`get_train_departures` — Train departures	Next departures from a German railway station, with platform, delay, cancellations.
`get_departures` — Scheduled departures (bus, tram, train)	Scheduled departures from any German stop — bus, tram, U-Bahn, S-Bahn, train, ferry — with line, destination, platform.
`check_transit_disruption` — Public-transport disruption in a region	How punctual public transport is now in one German region: the share of trips ever over 5 min late, trips with a cancelled stop, the trend, and the service alerts in force there (diversions, closed stops).
`check_station_facilities` — Station lifts and escalators	Report whether the lifts and escalators of a German railway station — or of a Köln Stadtbahn stop — are working now: each one, where it is, its state (in service / out of service / unknown) and the operator's explanation.

⚡ Charging and fuel

tool	what it answers
`find_charging_station` — EV charging nearby	Returns EV charging sites near a place or coordinate with operator, connector types, maximum power, price per kWh where published, and how many points are free right now where the operator publishes live status.
`find_cheapest_fuel` — Cheapest fuel nearby	Returns the cheapest stations for one fuel grade near a place or coordinate: price per litre, brand, address, distance, open state.
`find_fuel_station` — Find a filling station	Finds filling stations around a place or coordinate under any combination of filters — grade, brand, name, open now, open at a time you name, open 24 h — sorted by distance, price or name.

📍 Places and addresses

tool	what it answers
`find_place` — Look up a place	Looks up a place name and returns every place that matches, each with its kind, official key (AGS/RS), population, English name and coordinate.
`find_poi` — Find a named place	Finds a named business or landmark — company, shop, clinic, hotel — and returns its address, category and coordinate.
`find_address` — Look up a street address	Looks up a street address and returns its coordinate, plus what OpenStreetMap holds under it.
`describe_location` — Describe a coordinate	Turns a coordinate into words: the nearest address, settlement, Kreis, administrative area and motorway junction, each with its own distance.
`find_nearby` — What is nearby	Overview of what is around a place or coordinate: nearby fuel stations, EV charging, parking, the nearest railway station and motorway junction, each with its distance.

tool	what it answers
`find_sharing` — Shared bikes nearby	Returns rentable shared bikes near a place or coordinate: bike-sharing stations with bikes and free docks now, and free-floating bikes around, with distance and data age (nextbike incl. KVB Rad, MyRadl, VAG_Rad; Donkey Republic).

🌦️ Weather and rules

tool	what it answers
`check_weather_warnings` — Official weather warnings	Returns the official DWD weather warnings in force for a place or coordinate — storm, snow, ice, heavy rain, thunderstorm, heat — with the DWD's own Warnstufe 1–4, the area, the local validity window and the official text unaltered.
`get_driving_rules` — German driving rules	Returns the German road rules a visitor needs: low-emission zones (Umweltzone) and which Feinstaubplakette a city requires, speed limits (advisory 130), winter tyres, alcohol, the Sunday lorry ban, tolls (no car toll), Rettungsgasse, what must be in the car, and electric cars (E-Kennzeichen, ad-hoc payment, plugs).

🔔 Watches

tool	what it answers
`watch_situation` — Watch for a change	Opens a watch so THIS conversation is told when something changes: a road reopening, a stop running late, a weather warning starting, a charge point turning free.
`stop_watch` — Stop a watch	Ends a watch this conversation opened with watch_situation, so no further notifications arrive for it.

🧭 Prompts — ready-made briefings

Pick one in your client's prompt menu and fill in the blanks; it calls the right tools in the right order.

prompt	what it does
`plan_departure` — Trip briefing before departure — Reise-Briefing vor der Abfahrt	Briefs a drive that is about to start: the official weather warnings at both ends, whether each motorway is open, and the jams in force this minute, ending in one go/no-go sentence.
`compare_travel_options` — Drive or take the train? — Auto oder Bahn?	Weighs one trip by car against the same trip by rail: closures and live jams on the motorway side, the next departures and the region's punctuality on the rail side, as two paragraphs the traveller can compare.
`prepare_car_trip` — What you need before driving in Germany — Vorbereitung der Autofahrt	Collects what a driver must carry and know before driving in Germany and into one particular city: the low-emission-zone badge, speed limits, winter tyres, the alcohol limit, tolls, mandatory equipment and the rules for an electric car.
`plan_fuel_stop` — Refuel or charge on the way — Tank- oder Ladestopp unterwegs	Finds where this traveller fills up or charges on the way: the cheapest stations for one fuel grade around one place, or the charging points with the right connector and power, and the rest area beside them if they also need a break.
`plan_commute` — Plan today's commute by train — Pendelfahrt für heute planen	Plans one public-transport leg on the day itself: the next departures from the station with delays, platforms and cancellations, and whether the region's buses and trains are running normally at this hour.
`plan_arrival_parking` — Where to leave the car on arrival — Parken am Ziel	Finds where to leave the car at the end of the drive: the car park in town, the park-and-ride at the edge with the onward departures, or the rest area if the traveller is early.
`find_a_place` — Find out what a name refers to — Herausfinden, was ein Name meint	Resolves a bare name of unknown kind into a place, a named thing, or an address, trying each table in turn and stopping at the first that answers.
`plan_local_errand` — What is around this place? — Was ist hier in der Nähe?	Answers "what is around here" for one place: the nearest fuel, EV charging, parking, railway station and motorway junction in one glance, then — only if the traveller wants more than the nearest one — the depth tool for that one category.
`explain_this_coordinate` — Say where a coordinate is — Sagen, wo eine Koordinate liegt	Turns a bare lat/lon into a sentence a traveller understands: the nearest address, settlement, Kreis, administrative area and motorway junction, each with its own distance.

📚 Resources — reference your assistant can read

resource	what it holds
`viafrei://attribution` — Data sources & attribution	Licence and attribution text for every data source ViaFrei uses.
`viafrei://coverage` — Coverage	Which feeds, places and vehicles ViaFrei can answer for right now — licence, cadence and freshness per feed, which large cities hold no fuel price yet, plus what is deliberately not covered.
`viafrei://rules/driving-in-germany` — Driving in Germany — the rules a visitor needs (DE/EN)	Curated, sourced and dated: low-emission zones, speed, winter tyres, alcohol, tolls, the Sunday lorry ban, equipment, emergencies and electric driving.
`viafrei://rules/low-emission-zones` — Low-emission zones (Umweltzonen) — city, zone, plaque, where to buy it (DE/EN)	Which German cities run a low-emission zone, which Feinstaubplakette they require and where to buy it.
`viafrei://emergency` — Emergency in Germany — 112, 110, rescue lane, breakdown, crash (DE/EN)	What to dial, how to form the Rettungsgasse, what to do in a breakdown or after a crash, and what the law requires you to carry.
`viafrei://rules/electric-driving` — Electric driving in Germany — E plate, charging, payment, plugs (DE/EN)	What an electric car needs in Germany: the E-Kennzeichen and why its privileges differ per city, the green plaque, the right to ad-hoc card payment, plug standards, how prices are shown, etiquette and what to do in an emergency.
`viafrei://status/feeds` — Feed status	Per feed: is it still arriving?
`viafrei://watches` — My watches	The watches THIS conversation has open, with what each one is watching and when it expires.
`viafrei://gazetteer` — Gazetteer coverage	What the place index (gazetteer_places) holds: rows and last load per source and kind, how many carry an English name, and the sixteen Länder it can name — the coverage behind find_place/find_poi/find_nearby's place answers.
`viafrei://addresses` — Address coverage	What the OSM-derived address table (osm_addresses) holds per Bundesland — the Länder and each one's extract date read from the rows, the row counts estimated from the planner's statistics and labelled so — plus the ODbL § 4.6 offer owed to anyone who receives an address-derived result.
`viafrei://watch/{id}` — One watch	One watch of this conversation: what is being watched, what it has reported, and the attribution of the data behind each report.
`viafrei://place/{query}` — A resolved place	One place, poi or address resolved the same way every tool resolves `place` — a point, a short list of candidates, or an honest no — so a name can be pinned once and reused as lat/lon.

The running server is the source of truth. This list and API.md are rendered from a dated snapshot of it, and CI fails if either drifts from that snapshot. Ask any MCP client for tools/list to see what is live this minute.

Worked use cases

Walkthroughs that chain several tools, each naming what comes back:

🛣️ Driving Munich to Berlin: several motorways in one call, roadworks ahead, a fuel or charging stop, and parking at the far end.
🚉 The commute that broke: departures, regional disruption, and a station lift that is out.
🔋 An EV on a long weekend: charging by connector and power, low-emission-zone rules, and what is around a stop.
🚚 Fleet and logistics briefings: a dispatcher's morning brief, and watches that report a change instead of being polled.
🗺️ Building a local guide agent: a vague place to coordinates and back, and what OpenStreetMap's licence asks of you.

How well it answers, measured: test rounds, 1000 questions in German and English against production, with every finding published.

🛠️ For developers

It's plain MCP over HTTP. You can call it without an SDK:

bash

# 1. open a session
curl -si https://mcp.viafrei.de/mcp \
  -H 'content-type: application/json' -H 'accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"me","version":"0"}}}' \
  | grep -i mcp-session-id

# 1b. tell the server you are ready — the MCP lifecycle requires it before any request
curl -s https://mcp.viafrei.de/mcp \
  -H 'content-type: application/json' -H 'accept: application/json, text/event-stream' \
  -H 'mcp-session-id: <from step 1>' -H 'mcp-protocol-version: 2025-06-18' \
  -d '{"jsonrpc":"2.0","method":"notifications/initialized"}'

# 2. ask a question (put the session id from step 1 in the header)
curl -s https://mcp.viafrei.de/mcp \
  -H 'content-type: application/json' -H 'accept: application/json, text/event-stream' \
  -H 'mcp-session-id: <from step 1>' -H 'mcp-protocol-version: 2025-06-18' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"check_weather_warnings","arguments":{"place":"Freiburg im Breisgau","language":"en"}}}'

One endpoint instead of a stack of integrations. SOURCES.md lists the publishers behind it, among them Autobahn GmbH, Deutsche Bahn, DWD, DELFI, the national access point Mobilithek, BKG, GeoNames, OpenStreetMap and MTS-K. Each has its own format, release rhythm and licence, and they arrive here as one protocol.
Results are written to be read aloud. A tool answers in sentences an assistant can pass on, says what it does not know ("no status data means unknown, not free"), and ends with the source line.
Annotated honestly. Nineteen of the twenty-one tools are read-only and idempotent (readOnlyHint, idempotentHint), so a client can call them without a confirmation prompt. The two watch tools are not, because opening or stopping a watch changes what the server will tell you later, and their annotations say so.
Prompts and resources, not only tools. Nine ready-made briefings, and a reference shelf (driving rules, emission zones, emergency numbers, attribution) your assistant can read directly.
Watches. watch_situation turns polling into a notification for as long as the session lives: a road closure appearing or clearing, a stop's departures running late, a region's late share reaching a threshold (a quarter by default), a DWD warning coming into force, a charge point turning free. Three hours by default, 24 at most, and at most 10 per session. What a watch has reported is readable at viafrei://watches and viafrei://watch/{id}, and a client that subscribes to that resource is told when it reports something new. It reaches no inbox and no phone.
Machine-readable failures, in the bridge too: one line on stderr and a distinct exit code per cause (see below).

Bridge configuration

option	what it does
`--url <url>`	endpoint to relay to. Default `https://mcp.viafrei.de/mcp`. See the note below
`--header "Name: value"`	extra HTTP header on every request, repeatable. For an API key, when there is one
`--timeout <ms>`	per-request timeout, default 30000. The event stream is never timed out
`--version`, `--help`	print and exit

Many MCP clients can only pass an env block, not arguments, so every option has an environment variable too:

variable	same as
`VIAFREI_MCP_URL`	`--url`
`VIAFREI_MCP_HEADER`	`--header`. Separate several headers with a newline, which can never appear in a header name or value. That way nothing you might need to send is unrepresentable: a comma, a semicolon and a space all occur inside real header values
`VIAFREI_MCP_TIMEOUT_MS`	`--timeout`

A flag wins over the variable, and the variable wins over the built-in default. A --header of the same name replaces one from the variable; a --header of a different name is added alongside it.

There is no self-hosted ViaFrei. The server is a hosted service. --url is not a way to run your own: it exists for a proxy or gateway in front of the service, and for the stub server this repository's test suite starts.

When something is wrong

The bridge prints one line to stderr and exits with a code that says what happened. No stack traces:

code

viafrei: cannot reach https://example.invalid/mcp: host not found (DNS) (ENOTFOUND) - check your network connection; --url only if you relay through a proxy

The same text also goes back to the client as a JSON-RPC error, so an assistant can say what went wrong instead of going quiet.

exit	meaning
`0`	clean shutdown (the client closed stdin, or sent SIGINT/SIGTERM)
`1`	something else went wrong; the line says what
`2`	bad usage: a flag or a value the bridge does not accept
`3`	the endpoint could not be reached, stopped answering, or never answered in time
`4`	the endpoint answered and the bridge cannot continue: it refused (the line names the HTTP status), forgot the session, answered with something that is not MCP, or redirected to another origin
`5`	protocol version mismatch; the line names the version the server speaks

A slow call may be a retried call. A 429, 502, 503 or 504 is tried again once, after the delay the server asked for in Retry-After, or 250 ms when it asked for none. A connection that fails outright (reset, broken pipe, socket or connect timeout) is tried once more after 250 ms. Two cases are not retried, because waiting would be worse than answering: a 429 with no usable Retry-After, and any requested delay longer than your timeout. An event stream is never retried.

Your timeout bounds each request, not the whole call. Two attempts plus a delay can add up to about three times the timeout, and more if the endpoint redirects. If you need a hard ceiling, enforce it on your side.

An established session may wobble: a dropped event stream is a warning, and the bridge reconnects. It may not stay dead in silence. Several failures in a row with nothing succeeding in between end the process with the code above, so the client that started it finds out.

What the bridge does not do

No tracking. No telemetry, no analytics, no usage counter, no update check.
No stored files or credentials. It writes no file outside the OS temp directory. --header is passed through to the endpoint and is never persisted or logged.
No cross-origin redirects. A redirect off the origin you pointed it at is refused with one line naming both ends, so a server cannot forward your API key somewhere you did not choose. Same-origin redirects are followed normally.

💼 For businesses

The licence work is done, and it travels with the answer. Each result carries the attribution its sources require. Where a source attaches a condition, the result states it: share-alike is flagged, and the MTS-K purpose limit arrives as a sentence you are meant to show.
Built for answering people. Live figures, sourced and dated, in the language of the question. Good for travel and mobility assistants, dispatchers' briefings, customer service and step-free station checks.
Read the business page: viafrei.de/en/business. It covers six use cases and how to work with us.

⚖️ Using the data you get back

Every result carries an attribution line. Show it to the person reading the answer. The full register is at the resource viafrei://attribution, and SOURCES.md is the readable version: every publisher, what it covers, its licence, and the exact line to reproduce.

Two constraints matter more than the rest, because getting them wrong is a licence breach rather than a style problem:

MTS-K fuel prices are consumer information only. Any other use is unlawful in any form, raw, reformatted or aggregated, and never for the fuel industry or its IT providers. On top of that we ask for no redistribution at all: answer the person who asked; do not build a product out of it. (This is also why this page shows no fuel price.)
DELFI's realtime and disruption feeds are Creative Commons Attribution-ShareAlike (its static timetable and stop directory are CC BY 4.0, and so is VBB's Berlin-Brandenburg feed). Share-alike travels with anything you derive from it: recompute it, reshape it, rearrange it or build a delay table out of it, and that is Adapted Material you must license under BY-SA (art. 1(a) names material "translated, altered, arranged, transformed, or otherwise modified"). Merely showing it beside another source's data is an aggregation and puts no obligation on the other source. The realtime feeds' catalogue records name no licence version, so do not rely on one for a derivative; SOURCES.md has the detail, and also covers the two share-alike databases under the ODbL (OpenStreetMap and one lorry-park operator).

🗣️ Tell us when an answer is wrong

ViaFrei is live, free, and still growing. Some sources are thinner than they will be, and a tool can be slow or wrong. A tool that fails is something the server sees. A tool that answers confidently with the wrong thing is not. Use the A tool answered badly, or not at all issue template, saying what you asked and what came back. That report is the one thing we cannot get any other way.

The server itself

The MCP server is a hosted service, and its source is closed. It is not in this repository and is not published. What is public is the part meant to be: the tool names, descriptions, input schemas, result shapes and attribution lines, which is everything a client reads from tools/list. We say this plainly so nobody spends an evening looking for the server code.

Contributing · Security · Licence

Contributing: yes, please. See CONTRIBUTING.md and CODE_OF_CONDUCT.md. The bridge is small and self-contained, which makes it a good place for a first patch.
Security: never open a public issue for a key, a token or anything that looks like one. SECURITY.md has the private reporting path.
Licence: Apache-2.0 for this code. Data obtained through the server keeps its provider's licence; see NOTICE.

viafrei.de — Deutsch · English · Русский · Български · Українська · Română · Türkçe

Install

Tools (21)

check_autobahn_trafficfind_cheapest_fuelfind_fuel_stationfind_parkingcheck_road_statusfind_roadworks_aheadfind_charging_stationfind_place

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://mcp.viafrei.de/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.viafrei.de/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

de.viafrei/mcp (MCP Server)

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

check_autobahn_traffic

find_cheapest_fuel

find_fuel_station

find_parking

check_road_status

find_roadworks_ahead

find_charging_station

find_place

find_poi

find_address

describe_location

find_nearby

find_sharing

get_driving_rules

check_transit_disruption

check_weather_warnings

get_train_departures

get_departures

check_station_facilities

watch_situation

stop_watch

ViaFrei

Germany's traffic, trains, charging and roads — in your AI assistant.

🧳 What you can ask

💬 Real answers

🔌 Connect in one minute

Where to find ViaFrei

🧰 Everything it can do

🚗 On the road

🚆 Public transport

⚡ Charging and fuel

📍 Places and addresses

🚲 Sharing

🌦️ Weather and rules

🔔 Watches

🧭 Prompts — ready-made briefings

📚 Resources — reference your assistant can read

Worked use cases

🛠️ For developers

Bridge configuration

When something is wrong

What the bridge does not do

💼 For businesses

⚖️ Using the data you get back

🗣️ Tell us when an answer is wrong

The server itself

Contributing · Security · Licence

Install

Remote endpoint

Related servers