MCP-Server für KI-Assistenten

Eventfalcon bietet zwei MCP-Server an. Damit können KI-Assistenten wie Claude, ChatGPT oder Cursor direkt mit Eventfalcon arbeiten – Veranstaltungen finden oder deine eigenen verwalten.

Server	Adresse	Zugang
Veranstaltungen finden	`https://eventfalcon.de/mcp`	offen, ohne Schlüssel
Eigene Veranstaltungen verwalten	`https://eventfalcon.de/mcp/veranstalter`	per Anmeldung (OAuth) oder mit deinem API-Schlüssel

Beide sprechen „Streamable HTTP“, den Standard-Transport von MCP.

Veranstaltungen finden (`/mcp`)

Für alle, ohne Anmeldung. Der Assistent sieht dasselbe wie die Website: öffentliche Termine, Veranstalter und Listen.

Werkzeug	Zweck
`searchEvents`	Termine suchen – nach Ort (mit Umkreis), Text, Kategorie, Wochentag und Zeitraum
`getEvent`	Ein Termin im Detail: Beschreibung, Programm, Preise, Anmeldung (Frist, freie Plätze), weitere Termine, Kalender-Link
`getOrganiser`	Ein Veranstalter mit seinen nächsten Terminen und Listen
`findOrganisers`	Veranstalter mit Terminen rund um einen Ort
`getList`	Die Termine einer geteilten Liste
`listCategories`	Die Kategorien

Anmelden und Tickets kaufen geschieht auf der Veranstaltungsseite – der Assistent bekommt dafür den Link.

Eigene Veranstaltungen verwalten (`/mcp/veranstalter`)

Alles, was die API kann – als Werkzeuge für deinen Assistenten. Er handelt – per Anmeldung oder Schlüssel – in deinem Namen: Was er anlegt oder ändert, ist sofort veröffentlicht (je nach Sichtbarkeit) und erreicht die Kalender deiner Abonnenten.

Werkzeug	Zweck
`whoami`	Für welches Konto der Schlüssel gilt
`listEvents` · `getEvent`	Deine Veranstaltungen und alle Felder einer Veranstaltung
`listDates`	Alle kommenden Termine mit ihren Buchungen (wie das Dashboard)
`createEvent`	Veranstaltung oder Serie anlegen – auch mit Anmeldung, Tickets, Agenda und Bildern (per Bild-URL)
`updateEvent`	Ändern – nur die genannten Felder, alles andere bleibt; ein Termin, ab einem Termin oder alle
`addOccurrence`	Weiteren Termin hinzufügen
`cancelOccurrence` · `deleteOccurrence`	Absagen bzw. löschen
`listBookings` · `getBookingOverview`	Gästeliste eines Termins, Übersicht aller Buchungen
`getSubscriberStats`	Wie viele deine Kalender abonnieren wollten
`listLists` · `createList` · `updateList` · `deleteList`	Deine Listen
`listTemplates` · `listLocations`	Gespeicherte Vorlagen, bisher verwendete Orte
`importEvents`	Viele Veranstaltungen auf einmal aus CSV

Haben Gäste einen Termin gebucht, verschiebt, sagt ab oder löscht der Assistent ihn erst nach einer Rückfrage: Die erste Antwort ist CONFLICT: confirmation_required, erst mit confirm: true geht es weiter – dann werden die Gäste per E-Mail informiert. Die Ticket-Links deiner Gäste gibt der Server nie heraus.

Einrichten

Für /mcp/veranstalter gibt es zwei Wege (beides Premium, nur das Hauptkonto):

Anmelden – in Chat-Oberflächen wie ChatGPT oder Claude: Du fügst die Adresse als Connector hinzu, meldest dich bei Eventfalcon an und erlaubst den Zugriff – auf Wunsch nur lesen. Verbundene Apps siehst und trennst du unter API-Schlüssel.
API-Schlüssel – in Programmen, die einen Header mitschicken können (Claude Code, Cursor …). Den Schlüssel legst du unter API-Schlüssel an; er wird als Authorization: Bearer ef_… oder X-API-Key: ef_… mitgeschickt und darf immer lesen und ändern.

ChatGPT, Claude & Co. im Browser

Füge in den Einstellungen einen benutzerdefinierten Connector hinzu:

https://eventfalcon.de/mcp – Veranstaltungen finden, ohne Anmeldung
https://eventfalcon.de/mcp/veranstalter – eigene Veranstaltungen; beim Verbinden öffnet sich die Eventfalcon-Anmeldung und danach die Frage, was die App darf

Claude Code

claude mcp add --transport http eventfalcon https://eventfalcon.de/mcp
claude mcp add --transport http eventfalcon-veranstalter https://eventfalcon.de/mcp/veranstalter \
  --header "Authorization: Bearer ef_dein_schluessel"

Cursor und andere Programme mit MCP-Konfiguration

Etwa in .cursor/mcp.json (andere Programme nutzen dasselbe Muster aus Adresse und Headern):

{
  "mcpServers": {
    "eventfalcon": {
      "url": "https://eventfalcon.de/mcp"
    },
    "eventfalcon-veranstalter": {
      "url": "https://eventfalcon.de/mcp/veranstalter",
      "headers": { "Authorization": "Bearer ef_dein_schluessel" }
    }
  }
}

Für Entwickler: OAuth

Eventfalcon ist für /mcp/veranstalter ein OAuth-2.1-Autorisierungsserver nach der MCP-Spezifikation: Ohne Zugang antwortet der Server mit 401 und WWW-Authenticate: Bearer resource_metadata="…"; die Metadaten stehen unter /.well-known/oauth-protected-resource/mcp/veranstalter und /.well-known/oauth-authorization-server. Unterstützt werden Authorization Code mit PKCE (S256), Refresh Tokens mit Rotation, Client-ID-Metadaten-Dokumente und dynamische Registrierung (/api/oauth/register), Widerruf (/api/oauth/revoke). Scopes: events:read, events:write. Die Tokens gelten nur für den MCP-Server, nicht für die REST-API.

Fehler

Werkzeuge melden Fehler als CODE: Nachricht, CODE ist eines von UNAUTHORIZED, FORBIDDEN, NOT_FOUND, VALIDATION, CONFLICT, INTERNAL. Die Nachricht beginnt mit dem Fehlercode der API.