Eventflare MCP Server v2

Macht die Produktionsdaten von Eventflare für KI-Assistenten – Claude, ChatGPT, Perplexity, Cursor – über das Model Context Protocol abfragbar.

Über 8.000 Veranstaltungsorte für Firmenevents in mehr als 40 Städten. So konzipiert, dass LLMs Eventflare-URLs in ihren Antworten zitieren und die Lead-Attribution durchgängig messbar ist.

Was ist neu in v2

• Produktions-API + JWT-Authentifizierung – war: Dev-API ohne Authentifizierung

• PII-Schwärzung – jobPhone, venueEmail, commission, spaceNotes etc. verlassen niemals die API

• UTM-Attribution – jede ausgehende URL ist getaggt, sodass Leads aus dem MCP-Traffic in GA4 / Mixpanel / Ihrem CRM zugeordnet werden können

• Client-Klassifizierung – Logs unterscheiden zwischen Claude Desktop / ChatGPT / Perplexity / Cursor / etc.

• Click-Through-Tracking – wenn ein get_venue_details oder request_quote auf einen Veranstaltungsort aus einer vorherigen search_venues-Suche in derselben Sitzung verweist, wird dies als Click-Through protokolliert

• OpenPanel-Sink – Ereignisse werden für das Datenteam an OpenPanel (oder einen beliebigen Webhook) gespiegelt

• Neues Tool: find_expert_advice – stellt die redaktionellen Artikel von Eventflare bereit. Das Unterscheidungsmerkmal für LLM-Zitate.

Tools

Alle Tools enthalten eine citation_url und eine quotable_summary pro Ergebnis, optimiert für LLM-Antworten.

Schnellstart

npm install
cp .env.example .env
# fill EVENTFLARE_API_TOKEN
npm run build
npm start          # stdio — Claude Desktop, Claude Code, Cursor

# or HTTP mode (remote MCP):
TRANSPORT=http PORT=3001 npm start

Verbindung zu Claude Desktop

claude_desktop_config.json:

{
  "mcpServers": {
    "eventflare": {
      "command": "node",
      "args": ["/path/to/eventflare-mcp-server/dist/index.js"],
      "env": {
        "EVENTFLARE_API_TOKEN": "eyJhbGciOi..."
      }
    }
  }
}

Verbindung zu Claude Code

claude mcp add eventflare \
  -e EVENTFLARE_API_TOKEN=eyJhbGciOi... \
  -- node /path/to/eventflare-mcp-server/dist/index.js

Umgebungsvariablen

Siehe .env.example. Nur EVENTFLARE_API_TOKEN ist erforderlich.

Sicherheitsmodell

• Schreibgeschützt – nirgendwo POST/PUT/DELETE. Bestätigt anhand der Produktions-API-Spezifikation (123 Endpunkte, alle GET).

• JWT-Authentifizierung erforderlich – Authorization: Bearer ${EVENTFLARE_API_TOKEN} bei jeder ausgehenden Anfrage.

• Feld-Allowlists – verwendet fields[]= Abfrageparameter, sodass PII-Felder niemals abgerufen werden. Defense-in-Depth: Eine Schwärzungs-Allowlist verwirft alles, was durchrutscht.

• Eingabe-Sanitierung – jeder Tool-Parameter wird validiert; Slugs entsprechen ^[a-z0-9-]+$, Zahlen werden begrenzt, Daten ISO-validiert.

• Ratenbegrenzung – 60 Anfragen/Min pro IP auf /mcp (HTTP-Transport).

• Keine PII protokolliert – Analysefelder: Tool, Stadt, Kapazität, Eventtyp, Kategorie, Ergebnisanzahl, Sitzungs-ID, Client-Klasse, Budget-Band. Niemals Benutzeridentität, niemals Nachrichteninhalt.

• Generische Fehlermeldungen – interne API-Fehler werden auf stabile, benutzerfreundliche Strings abgebildet ("Eventflare API vorübergehend nicht verfügbar"); Details gehen nur an stderr.

Analytik

Lokal: Jeder Tool-Aufruf wird an logs/queries.jsonl angehängt und auf /dashboard angezeigt.

Remote: Wenn OPENPANEL_CLIENT_ID + OPENPANEL_CLIENT_SECRET gesetzt sind, wird jedes Ereignis als mcp.{tool} Track-Event mit profileId = sessionId gespiegelt. Verwenden Sie OPENPANEL_API_URL, um auf ein selbst gehostetes OpenPanel zu verweisen.

Oder setzen Sie ANALYTICS_SINK_URL (+ optional ANALYTICS_SINK_TOKEN), um rohe Ereignisse per POST an einen beliebigen HTTP-Endpunkt zu senden.

Beide Optionen sind nicht blockierend und werfen niemals Fehler – Analysefehler unterbrechen das MCP nicht.

UTM-Attribution

Jede URL, die das MCP zurückgibt, ist getaggt:

https://eventflare.io/spaces/london/skyline-glass-hall?utm_source=mcp&utm_medium=ai&utm_campaign=search_venues&utm_content=claude_desktop&mcp_session=abc123

Wenn also ein Planer durchklickt und eine Anfrage sendet, erkennt Ihr bestehendes GA4 / Mixpanel / CRM die Quelle als mcp / ai. Dies ist das Messrückgrat für die Frage: "Hat das MCP tatsächlich Leads generiert?".

Entwicklung

npm run dev        # tsx, no build
npm run inspect    # MCP Inspector UI

Deployment

Railway: Repository pushen, Umgebungsvariablen im Dashboard setzen, TRANSPORT=http setzen. Health-Check ist /health. Dashboard ist /dashboard?key=....

Lizenz

MIT — © Eventflare