KI & API – Kulturon für KI-Assistenten

Kulturon ist für KI-Assistenten gebaut: Agenten finden Events, lesen Verfügbarkeiten und übergeben einen fertigen Warenkorb an den Menschen – bezahlt wird immer im Browser. Veranstalter können ihre Events zusätzlich per KI eintragen.

Zwei Zugangswege

1. llms.txt + Agent-API – öffentlich, ohne Anmeldung, JSON oder Markdown. Für Suchmaschinen-Assistenten, Chatbots und eigene Agenten.
2. MCP-Server (Model Context Protocol) – für Claude, Cursor & Co. Ohne Anmeldung: Suchen und Checkout-Links. Mit Anmeldung (claude.ai-Connector per OAuth oder Application Password): Verwaltungs-Tools (Events anlegen, Ticketkategorien, Verkäufe).

llms.txt

Unter https://kulturon.cloudcompany.at/llms.txt steht eine Markdown-Beschreibung der Plattform: was Kulturon ist, die nächsten 20 Events mit Kurzbeschreibung, Preis und Verfügbarkeit, die neuesten Magazinbeiträge, alle Bereiche und rechtlichen Seiten. /llms-full.txt enthält die vollständigen Texte. Übersetzungen: /en/llms.txt, /hu/llms.txt, /sk/llms.txt. Jede Seite verweist im Kopf mit <link rel="describedby" type="text/markdown"> darauf; die Datei wird bei jeder Inhaltsänderung neu erzeugt.

Agent-API (öffentlich)

Basis: https://kulturon.cloudcompany.at/wp-json/kulturon/v1/agent · maschinenlesbar: OpenAPI 3.1. Antworten als JSON {data, meta, errors} oder mit ?format=md (bzw. Accept: text/markdown) als kompaktes Markdown. Sprache mit ?lang=de|en|hu|sk. Limits: 120 Abfragen pro Minute und IP, Checkout 10 pro 10 Minuten.

curl 'https://kulturon.cloudcompany.at/wp-json/kulturon/v1/agent/events?q=kabarett&from=2026-10-08&format=md'

Tickets kaufen: Checkout-Übergabe

Agenten bezahlen nie und geben keine Zahlungs- oder Kartendaten ein. Stattdessen:

1. POST /agent/checkout mit {"event_id": 123, "items": [{"sku": "STD", "qty": 2}]} – bei Sitzplan-Events "seats": ["Sitz-ID", …]. Die Tickets werden wie im Warenkorb geprüft und 30 Minuten reserviert.
2. Die Antwort enthält checkout_url. Der Agent gibt diesen Link an den Menschen weiter.
3. Beim Öffnen landen die Tickets im Warenkorb dieses Browsers und die Kasse öffnet sich. Dort werden Name, Adresse und Zahlung eingegeben – ab dann gilt die normale Reservierung von 20 Minuten. Ein abgelaufener oder bereits benutzter Link gibt die Tickets wieder frei.

MCP-Server

Endpunkt: https://kulturon.cloudcompany.at/wp-json/kulturon/v1/mcp (Streamable HTTP, JSON-RPC 2.0, Protokoll 2025-06-18 und neuer, JSON-Antworten ohne SSE).

• Ohne Anmeldung: search_events, get_event, list_genres, list_venues, search_artists, check_availability, create_checkout_link; Ressourcen llms.txt und OpenAPI.
• Veranstalter (eigene Events): my_events, create_event (immer als Entwurf), update_event, set_ticket_types, upload_event_image (Bild per URL), list_orders, sales_summary, get_attendee_count, translate_event.
• Verwaltung zusätzlich: publish_event, list_requests.

Die Liste der Tools richtet sich nach dem Zugang: es erscheinen nur Tools, die der Benutzer auch ausführen darf.

Verbinden: claude.ai (Web, Desktop-App, Mobil)

Für Veranstalter- und Verwaltungskonten – ohne Passwort-Weitergabe, die Anmeldung läuft über Kulturon (OAuth 2.1):

1. In Claude Einstellungen › Connectors › Eigenen Connector hinzufügen öffnen.
2. Name z. B. „Kulturon“, als URL https://kulturon.cloudcompany.at/wp-json/kulturon/v1/mcp/secure eintragen und hinzufügen.
3. Auf „Verbinden“ klicken: Kulturon öffnet sich, mit dem eigenen Konto anmelden.
4. Auf der Bestätigungsseite App, Rücksprung-Adresse und Rechte prüfen und „Erlauben“ wählen.

Die Verbindung erscheint danach in den Kontoeinstellungen unter Verbundene KI-Apps und kann dort jederzeit getrennt werden. Rechte: mcp:read (öffentliche Tools) und mcp:write (Verwaltungs-Tools im Rahmen der Kontorechte). Kundenkonten können keine Verbindung herstellen; für die öffentlichen Tools genügt https://kulturon.cloudcompany.at/wp-json/kulturon/v1/mcp ohne Anmeldung.

Claude Code (Terminal):

claude mcp add --transport http kulturon https://kulturon.cloudcompany.at/wp-json/kulturon/v1/mcp \
  --header "Authorization: Basic BASE64(benutzername:application-password)"

Claude Desktop (claude_desktop_config.json, über mcp-remote):

{"mcpServers": {"kulturon": {"command": "npx",
  "args": ["-y", "mcp-remote", "https://kulturon.cloudcompany.at/wp-json/kulturon/v1/mcp", "--header", "Authorization:${KULTURON_AUTH}"],
  "env": {"KULTURON_AUTH": "Basic BASE64(benutzername:application-password)"}}}}

Cursor (.cursor/mcp.json):

{"mcpServers": {"kulturon": {"url": "https://kulturon.cloudcompany.at/wp-json/kulturon/v1/mcp",
  "headers": {"Authorization": "Basic BASE64(benutzername:application-password)"}}}}

Ohne Header funktionieren die öffentlichen Tools. Die fertigen Konfigurationen mit eingesetztem Passwort zeigt die Verwaltung beim Erstellen eines Zugangs einmalig an. Clients mit OAuth-Unterstützung (z. B. claude mcp add --transport http kulturon https://kulturon.cloudcompany.at/wp-json/kulturon/v1/mcp/secure) brauchen kein Passwort: sie starten die Anmeldung im Browser.

Zugänge (Application Passwords)

• Zugänge gibt es nur für die Verwaltung und für Veranstalter – nie für Kundenkonten.
• Die Kulturon-Verwaltung erstellt sie unter Konto › Verwaltung › Benutzer › (Benutzer) › KI-/API-Zugänge. Das Passwort wird nur einmal angezeigt; „Neu erzeugen“ ersetzt es, „Widerrufen“ sperrt es sofort.
• Veranstalter sehen ihre Zugänge (Name, zuletzt verwendet, Anzahl der Aufrufe) in den Kontoeinstellungen und können sie dort selbst widerrufen.
• Jeder Aufruf mit einem Zugang oder einer OAuth-Verbindung wird protokolliert (Benutzer, Zugang, Route bzw. Tool, Status, Dauer, IP nur als Hash) und nach der Aufbewahrungsfrist gelöscht.
• Rechte wie im Konto: Veranstalter bearbeiten nur Events ihrer eigenen Veranstalter; veröffentlicht wird nach den üblichen Regeln (Pflichtfelder, Bestätigung) bzw. durch die Verwaltung.

Für Veranstalter: Events per KI eintragen

Beispiel-Auftrag an Claude: „Lege mein Konzert am 5. Dezember um 19:30 im Stadttheater an, Genre Konzerte, Stehplatz 29 €, 300 Stück, Plakat: https://…/plakat.jpg“. Der Assistent ruft create_event auf, speichert einen Entwurf und meldet, welche Angaben für die Veröffentlichung noch fehlen, samt Link zum Event-Editor im Konto.

Datenschutz

Die öffentlichen Schnittstellen enthalten keine personenbezogenen Daten (keine Kontaktpersonen, keine E-Mail-Adressen oder Telefonnummern von Veranstaltern, keine Kundendaten). Bei der Checkout-Übergabe wird eine optional übergebene E-Mail-Adresse höchstens 30 Minuten gespeichert. Fragen: office@kulturon.at.