InfraNode

Get base data for a German city (population, area, coordinates). Sourced from Wikidata. Read-only. Useful as a first lookup to confirm a city exists and get its core attributes. For a broader question about the city (what data is available at all) use ``get_city_overview`` instead.

{
  "type": "object",
  "properties": {
    "slug": {
      "description": "City identifier, e.g. 'berlin' or 'hamburg'. Resolved leniently: the German name with or without umlauts, any casing, a common English exonym or short form also works (München/munich/munchen -> muenchen, cologne -> koeln, frankfurt -> frankfurt-am-main). An unknown name returns 404 with a 'Meintest du ...?' suggestion. list_cities gives the canonical slugs.",
      "type": "string"
    }
  },
  "required": [
    "slug"
  ]
}

{
  "type": "object",
  "properties": {
    "data": {},
    "meta": {
      "$ref": "#/$defs/ToolMeta"
    }
  },
  "required": [
    "data",
    "meta"
  ],
  "$defs": {
    "ToolMeta": {
      "additionalProperties": true,
      "properties": {
        "source": {
          "type": "string"
        },
        "source_status": {
          "type": "string"
        },
        "cache_status": {
          "type": "string"
        },
        "correlation_id": {
          "type": "string"
        },
        "license": {
          "type": "string"
        },
        "attribution": {
          "type": "string"
        },
        "note": {
          "type": "string"
        }
      },
      "type": "object"
    }
  }
}

Get a ONE-CALL overview of everything InfraNode knows about a German city. Start here for any city question. Returns: the city's base data, a CATALOG of all 81 available data types (weather, air quality, public transit, trains, traffic, charging, parking, solar, energy, demographics, taxes, accidents, tourism, heritage, trees, population density, playgrounds, post boxes and many more), each with its coverage status and the exact tool to call next (for most data types that is ``get_city_resource(slug, resource=<type>)``), plus a small live highlights snapshot (current weather, air quality and train departures). Data types not yet covered for this city show where they ARE available so you can pivot. InfraNode keeps adding data and cities, so the catalog grows over time. Read-only.

{
  "type": "object",
  "properties": {
    "slug": {
      "description": "City identifier, e.g. 'berlin' or 'hamburg'. Resolved leniently: the German name with or without umlauts, any casing, a common English exonym or short form also works (München/munich/munchen -> muenchen, cologne -> koeln, frankfurt -> frankfurt-am-main). An unknown name returns 404 with a 'Meintest du ...?' suggestion. list_cities gives the canonical slugs.",
      "type": "string"
    }
  },
  "required": [
    "slug"
  ]
}

{
  "type": "object",
  "properties": {
    "data": {},
    "meta": {
      "$ref": "#/$defs/ToolMeta"
    }
  },
  "required": [
    "data",
    "meta"
  ],
  "$defs": {
    "ToolMeta": {
      "additionalProperties": true,
      "properties": {
        "source": {
          "type": "string"
        },
        "source_status": {
          "type": "string"
        },
        "cache_status": {
          "type": "string"
        },
        "correlation_id": {
          "type": "string"
        },
        "license": {
          "type": "string"
        },
        "attribution": {
          "type": "string"
        },
        "note": {
          "type": "string"
        }
      },
      "type": "object"
    }
  }
}

Fetch ANY per-city data type by its key (generic accessor, 81 data types). One tool for the whole breadth of InfraNode: live data (air, traffic, transit stops, parking, charging, water-level, flood, sharing, fuel-prices, webcams, station-departures/-arrivals/stations, ...), statistics (demographics, unemployment, tourism, accidents, crime-stats, indicators, land-values, tax-rates, insolvencies, ...), multi-year TIME SERIES (``sustainability``: SDG indicators per municipality, one value per year from 2006 to 2023, so trends can be answered without stitching snapshots), infrastructure and environment (solar, solar-roofs, district-heating, energy, heritage, tree-cadastre, playgrounds, public-toilets, markets, education, ...) and more. Discover the valid keys and per-city coverage with ``get_city_overview(slug)`` or the ``infranode://catalog`` resource; the ``resource`` enum lists every key. Uncovered types return ``source_status="not_covered"`` (plus where they ARE available), never an error. Read-only.

{
  "type": "object",
  "properties": {
    "slug": {
      "description": "City identifier, e.g. 'berlin' or 'hamburg'. Resolved leniently: the German name with or without umlauts, any casing, a common English exonym or short form also works (München/munich/munchen -> muenchen, cologne -> koeln, frankfurt -> frankfurt-am-main). An unknown name returns 404 with a 'Meintest du ...?' suggestion. list_cities gives the canonical slugs.",
      "type": "string"
    },
    "resource": {
      "description": "Data type key to fetch, exactly as listed by get_city_overview / the infranode://catalog resource (the 'type' field), e.g. 'charging', 'parking', 'demographics', 'solar', 'district-heating'.",
      "enum": [
        "accidents",
        "air",
        "air-uba",
        "base",
        "bathing-water",
        "bike-counts",
        "bike-parking",
        "business-registrations",
        "care",
        "charging",
        "charging-status",
        "childcare",
        "civil-protection-warnings",
        "construction",
        "council-papers",
        "crime-stats",
        "demographics",
        "district-heating",
        "drinking-water",
        "education",
        "education-stats",
        "election",
        "energy",
        "events",
        "fire-danger",
        "flood",
        "fuel-prices",
        "geo",
        "government-offices",
        "health",
        "heritage",
        "holidays",
        "hospitals-atlas",
        "indicators",
        "insolvencies",
        "integration",
        "labour-market",
        "land-values",
        "markets",
        "mobility-points",
        "municipal-finance",
        "office-wait-times",
        "overview",
        "parcel-lockers",
        "park-and-ride",
        "parking",
        "parking-onstreet",
        "playgrounds",
        "pollen-uv",
        "population-density",
        "population-structure",
        "population-trend",
        "post-boxes",
        "post-offices",
        "power-load",
        "power-price",
        "public-tenders",
        "public-toilets",
        "public-wifi",
        "recycling-centres",
        "road-events",
        "sharing",
        "social-situation",
        "solar",
        "solar-roofs",
        "station-arrivals",
        "station-departures",
        "station-facilities",
        "stations",
        "sustainability",
        "tax-rates",
        "tourism",
        "traffic",
        "transit",
        "tree-cadastre",
        "unemployment",
        "vehicle-registrations",
        "water-level",
        "weather",
        "weather-warnings",
        "webcams"
      ],
      "type": "string"
    }
  },
  "required": [
    "slug",
    "resource"
  ]
}

{
  "type": "object",
  "properties": {
    "data": {},
    "meta": {
      "$ref": "#/$defs/ToolMeta"
    }
  },
  "required": [
    "data",
    "meta"
  ],
  "$defs": {
    "ToolMeta": {
      "additionalProperties": true,
      "properties": {
        "source": {
          "type": "string"
        },
        "source_status": {
          "type": "string"
        },
        "cache_status": {
          "type": "string"
        },
        "correlation_id": {
          "type": "string"
        },
        "license": {
          "type": "string"
        },
        "attribution": {
          "type": "string"
        },
        "note": {
          "type": "string"
        }
      },
      "type": "object"
    }
  }
}

Get official air quality for a German city (PM10, NO2 and more). Sourced from the Umweltbundesamt (UBA). Read-only. For live nearest-station hourly readings use ``get_city_resource(slug, resource='air')`` instead.

{
  "type": "object",
  "properties": {
    "slug": {
      "description": "City identifier, e.g. 'berlin' or 'hamburg'. Resolved leniently: the German name with or without umlauts, any casing, a common English exonym or short form also works (München/munich/munchen -> muenchen, cologne -> koeln, frankfurt -> frankfurt-am-main). An unknown name returns 404 with a 'Meintest du ...?' suggestion. list_cities gives the canonical slugs.",
      "type": "string"
    }
  },
  "required": [
    "slug"
  ]
}

{
  "type": "object",
  "properties": {
    "data": {},
    "meta": {
      "$ref": "#/$defs/ToolMeta"
    }
  },
  "required": [
    "data",
    "meta"
  ],
  "$defs": {
    "ToolMeta": {
      "additionalProperties": true,
      "properties": {
        "source": {
          "type": "string"
        },
        "source_status": {
          "type": "string"
        },
        "cache_status": {
          "type": "string"
        },
        "correlation_id": {
          "type": "string"
        },
        "license": {
          "type": "string"
        },
        "attribution": {
          "type": "string"
        },
        "note": {
          "type": "string"
        }
      },
      "type": "object"
    }
  }
}

Get current weather observations for a German city. Sourced from the Deutscher Wetterdienst (DWD): temperature, wind, precipitation and related fields. Read-only, current conditions only (not a forecast). For warnings use ``get_city_resource(slug, resource='weather-warnings')``. For a broader question about the city (not just weather) use ``get_city_overview`` instead, which already includes a live weather highlight.

{
  "type": "object",
  "properties": {
    "slug": {
      "description": "City identifier, e.g. 'berlin' or 'hamburg'. Resolved leniently: the German name with or without umlauts, any casing, a common English exonym or short form also works (München/munich/munchen -> muenchen, cologne -> koeln, frankfurt -> frankfurt-am-main). An unknown name returns 404 with a 'Meintest du ...?' suggestion. list_cities gives the canonical slugs.",
      "type": "string"
    }
  },
  "required": [
    "slug"
  ]
}

{
  "type": "object",
  "properties": {
    "data": {},
    "meta": {
      "$ref": "#/$defs/ToolMeta"
    }
  },
  "required": [
    "data",
    "meta"
  ],
  "$defs": {
    "ToolMeta": {
      "additionalProperties": true,
      "properties": {
        "source": {
          "type": "string"
        },
        "source_status": {
          "type": "string"
        },
        "cache_status": {
          "type": "string"
        },
        "correlation_id": {
          "type": "string"
        },
        "license": {
          "type": "string"
        },
        "attribution": {
          "type": "string"
        },
        "note": {
          "type": "string"
        }
      },
      "type": "object"
    }
  }
}

Get points of interest in a German city, filtered by type. Sourced from OpenStreetMap. Read-only.

{
  "type": "object",
  "properties": {
    "slug": {
      "description": "City identifier, e.g. 'berlin' or 'hamburg'. Resolved leniently: the German name with or without umlauts, any casing, a common English exonym or short form also works (München/munich/munchen -> muenchen, cologne -> koeln, frankfurt -> frankfurt-am-main). An unknown name returns 404 with a 'Meintest du ...?' suggestion. list_cities gives the canonical slugs.",
      "type": "string"
    },
    "type": {
      "description": "POI type from the API allowlist, one of: hospital, school, pharmacy, restaurant, police, kindergarten.",
      "type": "string"
    }
  },
  "required": [
    "slug",
    "type"
  ]
}

{
  "type": "object",
  "properties": {
    "data": {},
    "meta": {
      "$ref": "#/$defs/ToolMeta"
    }
  },
  "required": [
    "data",
    "meta"
  ],
  "$defs": {
    "ToolMeta": {
      "additionalProperties": true,
      "properties": {
        "source": {
          "type": "string"
        },
        "source_status": {
          "type": "string"
        },
        "cache_status": {
          "type": "string"
        },
        "correlation_id": {
          "type": "string"
        },
        "license": {
          "type": "string"
        },
        "attribution": {
          "type": "string"
        },
        "note": {
          "type": "string"
        }
      },
      "type": "object"
    }
  }
}

Get live departures for ANY railway station by its EVA number. Covers all train categories including local/regional (S/RB/RE) and long distance, with real-time delays, cancellations and disruption messages. Get the EVA from ``get_city_resource(slug, resource='stations')``. Read-only.

{
  "type": "object",
  "properties": {
    "eva": {
      "description": "Station EVA number (digits only) from get_city_resource(slug, resource='stations'), e.g. '8011160' (Berlin Hbf).",
      "type": "string"
    }
  },
  "required": [
    "eva"
  ]
}

{
  "type": "object",
  "properties": {
    "data": {},
    "meta": {
      "$ref": "#/$defs/ToolMeta"
    }
  },
  "required": [
    "data",
    "meta"
  ],
  "$defs": {
    "ToolMeta": {
      "additionalProperties": true,
      "properties": {
        "source": {
          "type": "string"
        },
        "source_status": {
          "type": "string"
        },
        "cache_status": {
          "type": "string"
        },
        "correlation_id": {
          "type": "string"
        },
        "license": {
          "type": "string"
        },
        "attribution": {
          "type": "string"
        },
        "note": {
          "type": "string"
        }
      },
      "type": "object"
    }
  }
}

Get live arrivals for ANY railway station by its EVA number. Mirror of ``station_board_departures`` for arriving trains (all categories, real-time delays, disruption messages). Get the EVA from ``get_city_resource(slug, resource='stations')``. Read-only.

{
  "type": "object",
  "properties": {
    "eva": {
      "description": "Station EVA number (digits only) from get_city_resource(slug, resource='stations'), e.g. '8000105' (Frankfurt Hbf).",
      "type": "string"
    }
  },
  "required": [
    "eva"
  ]
}

{
  "type": "object",
  "properties": {
    "data": {},
    "meta": {
      "$ref": "#/$defs/ToolMeta"
    }
  },
  "required": [
    "data",
    "meta"
  ],
  "$defs": {
    "ToolMeta": {
      "additionalProperties": true,
      "properties": {
        "source": {
          "type": "string"
        },
        "source_status": {
          "type": "string"
        },
        "cache_status": {
          "type": "string"
        },
        "correlation_id": {
          "type": "string"
        },
        "license": {
          "type": "string"
        },
        "attribution": {
          "type": "string"
        },
        "note": {
          "type": "string"
        }
      },
      "type": "object"
    }
  }
}

Get live public-transport departures with real-time delays for a stop. Sourced from GTFS-RT/HVV/VGN. Unlike the static stop list (``get_city_resource(slug, resource='transit')``), this returns minute-fresh departures including delay for ONE stop. A ``stop_id`` is required: fetch the city's transit stops first to discover valid stop IDs, then pass one here. Read-only.

{
  "type": "object",
  "properties": {
    "slug": {
      "description": "City identifier, e.g. 'berlin' or 'hamburg'. Resolved leniently: the German name with or without umlauts, any casing, a common English exonym or short form also works (München/munich/munchen -> muenchen, cologne -> koeln, frankfurt -> frankfurt-am-main). An unknown name returns 404 with a 'Meintest du ...?' suggestion. list_cities gives the canonical slugs.",
      "type": "string"
    },
    "stop_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Required stop ID to fetch departures for. Discover a city's stop IDs with get_city_resource(slug, resource='transit') first (each stop carries its id). Format: DELFI 'de:<AGS>:<id>' or a numeric gtfs.de stop id. NOTE: this is NOT the trip_stop_id (nor its deprecated alias stop_id) from station_departures/station_arrivals, whose value identifies one stop of one train run (e.g. '-1203677609210685804-2607251113-13'); passing it returns no_data with a corrective note instead of departures."
    }
  },
  "required": [
    "slug"
  ]
}

{
  "type": "object",
  "properties": {
    "data": {},
    "meta": {
      "$ref": "#/$defs/ToolMeta"
    }
  },
  "required": [
    "data",
    "meta"
  ],
  "$defs": {
    "ToolMeta": {
      "additionalProperties": true,
      "properties": {
        "source": {
          "type": "string"
        },
        "source_status": {
          "type": "string"
        },
        "cache_status": {
          "type": "string"
        },
        "correlation_id": {
          "type": "string"
        },
        "license": {
          "type": "string"
        },
        "attribution": {
          "type": "string"
        },
        "note": {
          "type": "string"
        }
      },
      "type": "object"
    }
  }
}

List all covered cities (slug, federal state, population, coverage). Takes no arguments. Call this first to discover valid city slugs before invoking any city-scoped tool. Read-only.

{
  "type": "object",
  "properties": {}
}

{
  "type": "object",
  "properties": {
    "data": {},
    "meta": {
      "$ref": "#/$defs/ToolMeta"
    }
  },
  "required": [
    "data",
    "meta"
  ],
  "$defs": {
    "ToolMeta": {
      "additionalProperties": true,
      "properties": {
        "source": {
          "type": "string"
        },
        "source_status": {
          "type": "string"
        },
        "cache_status": {
          "type": "string"
        },
        "correlation_id": {
          "type": "string"
        },
        "license": {
          "type": "string"
        },
        "attribution": {
          "type": "string"
        },
        "note": {
          "type": "string"
        }
      },
      "type": "object"
    }
  }
}

List all data sources with license, attribution and availability. Takes no arguments. Shows which upstream sources InfraNode bundles and whether each is currently active. Read-only.

{
  "type": "object",
  "properties": {}
}

{
  "type": "object",
  "properties": {
    "data": {},
    "meta": {
      "$ref": "#/$defs/ToolMeta"
    }
  },
  "required": [
    "data",
    "meta"
  ],
  "$defs": {
    "ToolMeta": {
      "additionalProperties": true,
      "properties": {
        "source": {
          "type": "string"
        },
        "source_status": {
          "type": "string"
        },
        "cache_status": {
          "type": "string"
        },
        "correlation_id": {
          "type": "string"
        },
        "license": {
          "type": "string"
        },
        "attribution": {
          "type": "string"
        },
        "note": {
          "type": "string"
        }
      },
      "type": "object"
    }
  }
}

Compare ONE resource across MULTIPLE cities in a single response. Fans the resource out over the listed cities and returns a per-city ``source_status`` (ok/disabled/no_data/error/not_found), so a missing or failing city source does not spoil the whole answer. Read-only.

{
  "type": "object",
  "properties": {
    "resource": {
      "description": "Resource to compare. Supported: 'weather' (DWD), 'air' (UBA air quality), 'indicators' (INKAR socioeconomic indicators incl. unemployment rate and EV charging coverage), 'demographics', 'unemployment', 'tourism', 'charging-status' (live EV charging occupancy, aggregates only) and 'weather-warnings' (official DWD warning level per city).",
      "type": "string"
    },
    "cities": {
      "description": "Comma-separated list of city slugs, e.g. 'berlin,koeln,hamburg' (max. 28 cities).",
      "type": "string"
    }
  },
  "required": [
    "resource",
    "cities"
  ]
}

{
  "type": "object",
  "properties": {
    "data": {},
    "meta": {
      "$ref": "#/$defs/ToolMeta"
    }
  },
  "required": [
    "data",
    "meta"
  ],
  "$defs": {
    "ToolMeta": {
      "additionalProperties": true,
      "properties": {
        "source": {
          "type": "string"
        },
        "source_status": {
          "type": "string"
        },
        "cache_status": {
          "type": "string"
        },
        "correlation_id": {
          "type": "string"
        },
        "license": {
          "type": "string"
        },
        "attribution": {
          "type": "string"
        },
        "note": {
          "type": "string"
        }
      },
      "type": "object"
    }
  }
}