MCP-Server Hessens Tourismusdaten direkt in Ihrem KI-Assistenten

Endpunkt

Streamable HTTP, zustandslos, ausschliesslich lesend. Der Zugang läuft über die Kopfzeile Authorization: Bearer <schlüssel>.

https://hessenexplorer.travel-commerce.de/api/mcp

Die fünf Werkzeuge

Ein Suchwerkzeug für alle Inhaltsarten statt eines je Art — der Datentyp ist ein Filter wie jeder andere. Dazu Auskunft über den Bestand, Nachschlagen gültiger Filterwerte, Abruf ganzer Datensätze und Auszählung.

{
  "name": "hessen_describe_dataset",
  "arguments": {
    "sections": [
      "overview",
      "types"
    ]
  }
}

{
  "notes": [
    "4489 abgelaufene und 4 abgesagte Veranstaltungen sind in allen Zahlen dieses Servers ausgeblendet.",
    "24 Veranstaltungen tragen ein Startdatum vor 2020. Sie werden nicht gefiltert — der Wert steht so im Quellsystem.",
    "1566 sichtbare Datensätze haben keine Koordinate und fehlen daher in jeder Umkreis- und Kartenausschnittsuche (1216 ohne Angabe in der Quelle, 338 mit der unbrauchbaren Angabe 0°/0°, 12 ausserhalb des gültigen Werteberei …"
  ],
  "overview": {
    "total_records": 22480,
    "visible_records": 17987,
    "hidden_expired_events": 4489,
    "hidden_cancelled_events": 4,
    "with_coordinates": 16421,
    "with_image": 10956,
    "with_city": 14500,
    "without_coordinates": {
      "total": 1566,
      "source_had_none": 1216,
      "source_had_null_island": 338,
      "source_out_of_range": 12
    },
    "event_date_range": {
      "earliest_date": "1980-01-01",
      "latest_date": "2028-01-29",
      "implausible_before_2020": 24
    }
  },
  "types": [
    {
      "value": "PointOfInterest",
      "count": 5325,
      "label": "Sehenswürdigkeit"
    },
    {
      "value": "FoodEstablishmentLodgingBusiness",
      "count": 3479,
      "label": "Gastro/Unterkunft"
    },
    {
      "value": "Event",
      "count": 2950,
      "label": "Veranstaltung"
    },
    "… 14 weitere"
  ]
}

{
  "name": "hessen_lookup_values",
  "arguments": {
    "field": "city",
    "q": "Homburg",
    "limit": 3
  }
}

{
  "field": "city",
  "values": [
    {
      "value": "Homberg (Efze)",
      "label": "Homberg (Efze)",
      "count": 99,
      "center_based_on": 99,
      "center": {
        "lat": 51.01828,
        "lon": 9.41134
      }
    },
    {
      "value": "Naumburg",
      "label": "Naumburg",
      "count": 75,
      "center_based_on": 75,
      "center": {
        "lat": 51.23557,
        "lon": 9.17466
      }
    },
    {
      "value": "Homberg (Ohm)",
      "label": "Homberg (Ohm)",
      "count": 39,
      "center_based_on": 39,
      "center": {
        "lat": 50.7294,
        "lon": 8.99851
      }
    }
  ],
  "returned": 3,
  "total_matching": 7,
  "notes": [
    "7 Werte passen insgesamt, 3 sind hier aufgeführt. Mit \"q\" einschränken oder \"limit\" erhöhen (höchstens 50)."
  ]
}

{
  "name": "hessen_search",
  "arguments": {
    "query": "Burg",
    "filters": {
      "destination": [
        "taunus"
      ]
    },
    "pagination": {
      "limit": 2
    }
  }
}

{
  "total_count": 61,
  "returned": 2,
  "has_more": true,
  "next_cursor": "eyJzIjoiaWQiLCJrIjpbImVfMTAwMDM4NzUwLWh1YmVyIiwiZV8xMDAwMzg3NTAtaHViZXIiXSwiaCI6IjE0VW90MDRYV21KSyJ9",
  "truncated": false,
  "applied_filters": {
    "destination": [
      "taunus"
    ]
  },
  "sort": "id",
  "notes": [],
  "facets": {
    "type": [
      {
        "value": "PointOfInterest",
        "count": 43
      },
      {
        "value": "Trail",
        "count": 8
      },
      {
        "value": "Event",
        "count": 5
      },
      "… 1 weitere"
    ],
    "destination": [
      {
        "value": "taunus",
        "count": 61
      }
    ],
    "city": [
      {
        "value": "Kronberg im Taunus",
        "count": 12
      },
      {
        "value": "Eppstein",
        "count": 10
      },
      {
        "value": "Königstein im Taunus",
        "count": 7
      },
      "… 5 weitere"
    ],
    "category": [
      {
        "value": "Burg",
        "count": 26
      },
      {
        "value": "Bauwerk",
        "count": 20
      },
      {
        "value": "Interessantes in der Natur",
        "count": 15
      },
      "… 5 weitere"
    ]
  },
  "results": [
    {
      "id": "e_100038737-huber",
      "type": "FoodEstablishmentLodgingBusiness",
      "title": "Restaurant-Café-Pension Zum Feldbergblick",
      "city": "Schmitten - Hunoldstal",
      "destination": "taunus"
    },
    {
      "id": "e_100038750-huber",
      "type": "FoodEstablishmentLodgingBusiness",
      "title": "Restaurant Bürgerklause",
      "city": "Glashütten",
      "destination": "taunus"
    }
  ]
}

{
  "name": "hessen_get_records",
  "arguments": {
    "ids": [
      "e_01600962-4f80-4de9-9b97-62d23807de69-feratel",
      "e_074d1ce7-af62-4a41-a84a-76547e23fc69-feratel"
    ],
    "include": [
      "contact",
      "opening_hours"
    ]
  }
}

{
  "requested": 2,
  "returned": 2,
  "not_found": [],
  "truncated": false,
  "notes": [],
  "records": [
    {
      "id": "e_01600962-4f80-4de9-9b97-62d23807de69-feratel",
      "type": "PointOfInterest",
      "title": "Wendelgasse",
      "city": "Marburg",
      "postal_code": "35037",
      "region": null,
      "destination": "lahntal",
      "destination_name": "Lahntal",
      "coordinates": {
        "lat": 50.80885,
        "lon": 8.76852
      },
      "categories": [
        "Verkehrsbau",
        "Bauwerk",
        "Straßenbauanlage",
        "… 3 weitere"
      ],
      "languages": [
        "de",
        "en"
      ],
      "url": null,
      "author": "Marburg Stadt und Land Tourismus",
      "license": "https://creativecommons.org/licenses/by/4.0/de/",
      "image_url": "https://resc.deskline.net/images/RPT/1/565d4421-e6ed-4261-aafe-837063ffbc57/99/image.jpg",
      "image_count": 4,
      "is_expired": false,
      "updated_at": "2025-07-07T11:36:36Z",
      "teaser": null,
      "description": "Etwa auf halbem Wege zwischen Lahn und Landgrafenschloss liegt das nicht einmal 100 Meter lange Gässchen, das auf beiden Seiten von den in Marburg typischen Fachwerkhäusern gesäumt wird. Über die dazugehörige Wendeltrepp …",
      "contact": {
        "street": null,
        "country": "Deutschland",
        "phone": null,
        "fax": null,
        "email": null
      },
      "opening_hours": {
        "regular": [
          {
            "day": "Montag",
            "hours": [
              "00:00–00:00"
            ]
          },
          {
            "day": "Dienstag",
            "hours": [
              "00:00–00:00"
            ]
          },
          {
            "day": "Mittwoch",
            "hours": [
              "00:00–00:00"
            ]
          },
          "… 4 weitere"
        ]
      }
    },
    {
      "id": "e_074d1ce7-af62-4a41-a84a-76547e23fc69-feratel",
      "type": "PointOfInterest",
      "title": "Wasserscheide",
      "city": "Marburg",
      "postal_code": "35037",
      "region": null,
      "destination": "lahntal",
      "destination_name": "Lahntal",
      "coordinates": {
        "lat": 50.81085,
        "lon": 8.77044
      },
      "categories": [
        "ZG Kultur- und Landschaftsliebhaber (O)",
        "ZG Kultur- und Landschaftsliebhaber (R)",
        "ZG Städte-Genießer (O)",
        "… 3 weitere"
      ],
      "languages": [
        "de",
        "en"
      ],
      "url": null,
      "author": "Marburg Stadt und Land Tourismus",
      "license": "https://creativecommons.org/licenses/by/3.0/de/",
      "image_url": "https://resc.deskline.net/images/RPT/1/74b350d9-39df-4168-9ace-ec2a8cdd99cb/99/image.jpg",
      "image_count": 1,
      "is_expired": false,
      "updated_at": "2025-07-11T09:13:25Z",
      "teaser": null,
      "description": "An der Wasserscheide wurde \"Christian\", dem letzten Marburger Dienstmann 1988 ein Denkmal aus Bronze gesetzt. Die Geschichte der Wasserscheide indes reicht weit bis in das Mittelalter zurück. Im 13. Jahrhundert betrat hi …",
      "contact": {
        "street": "Wettergasse",
        "country": "Deutschland",
        "phone": null,
        "fax": null,
        "email": null
      },
      "opening_hours": {
        "regular": [
          {
            "day": "Montag",
            "hours": [
              "00:00–00:00"
            ]
          },
          {
            "day": "Dienstag",
            "hours": [
              "00:00–00:00"
            ]
          },
          {
            "day": "Mittwoch",
            "hours": [
              "00:00–00:00"
            ]
          },
          "… 4 weitere"
        ]
      }
    }
  ]
}

{
  "name": "hessen_aggregate",
  "arguments": {
    "group_by": [
      "destination"
    ],
    "metrics": [
      "count",
      "with_image"
    ],
    "limit": 4
  }
}

{
  "group_by": [
    "destination"
  ],
  "metrics": [
    "count",
    "with_image"
  ],
  "cells": [
    {
      "destination": "nordhessen",
      "count": 4900,
      "with_image": 4101
    },
    {
      "destination": "lahntal",
      "count": 3285,
      "with_image": 2056
    },
    {
      "destination": "rhoen",
      "count": 2145,
      "with_image": 14
    },
    "… 1 weitere"
  ],
  "returned": 4,
  "total_cells": 11,
  "total_records": 17987,
  "applied_filters": {},
  "notes": [
    "Die Zelle mit dem Wert null bei destination zählt die Datensätze ohne Angabe in diesem Feld. Sie ist bewusst enthalten, weil ihre Grösse selbst eine Aussage ist.",
    "11 Zellen entstehen insgesamt, 4 sind hier aufgeführt. Enger filtern oder \"limit\" erhöhen."
  ]
}

Blättern, Sortieren, Antwortgrösse

Wenn etwas nicht stimmt

Ein Fehler ist hier eine Antwortmöglichkeit und keine Sackgasse. Ein unbekannter Filterwert führt nicht zu einer leeren Trefferliste, sondern zu einer Ablehnung mit Vorschlägen — sonst liesse sich „falsch gefragt" nicht von „gibt es nicht" unterscheiden. Ein unbekannter Parametername kommt mit der vollständigen Liste der akzeptierten zurück. Und eine Zeitüberschreitung wird als solche benannt, statt wie null Treffer auszusehen.

{
  "error": "unbekannter_wert",
  "field": "filters.type",
  "value": "Museum",
  "message": "„Museum\" ist kein Datentyp, sondern eine Kategorie (im Bestand als „Museum\" mit 290 Datensätzen). Gemeint ist vermutlich filters.category: [\"Museum\"].",
  "valid_values_via": "hessen_lookup_values({field:'type'})"
}

Grenzen