Bauen Sie auf Sporfie
Eine REST-API und ein MCP-Server für die Events, Videos und Livestreams, die Ihre Organisation bereits auf Sporfie betreibt. Erstellen Sie Events aus Ihrem Buchungssystem, senden Sie Live-Spielstände, schneiden Sie Highlights, empfangen Sie Webhooks — oder fragen Sie einfach Ihren KI-Assistenten.
Funktioniert in den KI-Tools, die Sie bereits nutzen
Sporfie liefert einen MCP-Server, der die Public API als 19 kuratierte Tools bereitstellt. Einmal verbinden und in natürlicher Sprache fragen. Jeder Tool-Aufruf ist darunter ein normaler API-Aufruf — gleiche IDs, gleiche Berechtigungen, gleiche Limits.
- Claude
- ChatGPT
- Grok Bot
- Cursor
- und jeder andere MCP-kompatible Client
Streamable-HTTP-Transport. Die Help-Center-Tools funktionieren ohne Token.
Verbinden mit einem Klick
Fügen Sie den Server ohne Header hinzu, und Ihr Client startet den Standard-OAuth-Flow von MCP: einmal bei Sporfie anmelden, Verbindung bestätigen, fertig. Kein Schlüssel zum Kopieren.
Oder eigenen Schlüssel verwenden
Für CLIs, CI und Skripte erstellen Sie unter Einstellungen → Entwickler einen persönlichen Schlüssel und übergeben ihn als Bearer-Header. Derselbe Schlüssel funktioniert auch für direkte REST-Aufrufe.
API-Schlüssel verwaltenWas die Tools abdecken
Events erstellen, lesen, ändern, schließen und löschen · Suche und Live-Abfrage · Orte und Sportarten · Highlight-Momente · Event-Webhooks · Help-Center-Suche.
Fragen statt integrieren
Drei Unterhaltungen, die ausschließlich Tools verwenden, die der Sporfie-MCP-Server tatsächlich bereitstellt.
Erledigt — ich habe 6 Spiele aus dem Foto gelesen und auf Ihren Kamera-Plätzen eingeplant:
- Sa 09:00 · U14 Tigers – Falcons · Platz 1
- Sa 10:30 · U16 Tigers – Ravens · Platz 1
- Sa 12:00 · U19 Tigers – Bulls · Platz 2
- + 3 weitere am Sonntag
Jedes Spiel wird beim Start automatisch aufgezeichnet und gestreamt. Soll ich einen Webhook einrichten, damit Ihre Website aktualisiert wird, sobald sie live gehen?
Das habe ich zum Finale des Spring Cup gefunden (26. Apr., Platz 1):
Am meisten gesehen: der Matchball bei 2:31:07 mit 412 Aufrufen.
Aufrufe werden pro Highlight-Clip gezählt. Livestream-Zuschauer meldet die API nicht.
Das U19-Finale ist für Samstag 14:00–16:00 auf Platz 2 geplant, das Event steht also. RTMP-URLs werden in Sporfie pro Encoder vergeben, nicht über die API. Der schnellste Weg:
- Öffnen Sie Einstellungen → Encoder und fügen Sie Ihre GoPro hinzu (oder wählen Sie sie aus).
- Kopieren Sie ihre RTMP-URL in die GoPro-App.
- Oder zeigen Sie den GoPro-QR-Code an und scannen Sie ihn mit der Kamera — der Stream wird automatisch konfiguriert.
Beispielhafte Unterhaltungen. Die Formulierung variiert je nach Assistent; die Tool-Aufrufe sind echt.
Was Sie bauen können
Alles hier steht heute in der öffentlichen OpenAPI-Spezifikation — keine Roadmap-Punkte.
Events mit Ihren IDs
Events erstellen, ändern, schließen und löschen. Adressieren Sie sie über Ihre eigene externalID, damit Ihr System die Quelle der Wahrheit bleibt.
Geplante Aufzeichnung
Verknüpfen Sie ein Event mit Start- und Endzeit mit einem kameraausgestatteten Ort — es zeichnet auf und streamt von selbst.
Live-Spielstände
Senden Sie einen Score-Stream aus Ihrer Scoring-App oder Ihrem Gerät; Anzeigetafel und Event folgen.
Highlights auf Abruf
Registrieren Sie einen Klick zu einem Zeitpunkt, und Sporfie schneidet einen Clip darum — per Knopf, Sensor oder eigener Logik.
Webhooks
Beobachten Sie ein Event und erhalten Sie bei jeder Änderung das vollständige Event-Objekt. Besser als Polling.
Momente, Reels und Lesezeichen
Clip-URLs und Aufrufzahlen lesen, Reels und Lesezeichen-Sammlungen verwalten, getaggte Clips exportieren.
Player einbetten
Der Sporfie-Player lässt sich als iframe in jede Seite einfügen.
Fünf Aufrufe decken die meisten Integrationen ab
Direkt aus der Dokumentation. Setzen Sie SPORFIE_TOKEN, COMPANY_KEY und PLACE_KEY in Ihrer Umgebung, dann laufen sie unverändert.
curl -X POST "https://api.sporfie.com/public/events/booking-48213" \
-H "Authorization: Bearer $SPORFIE_TOKEN" \
-H "Content-Type: application/json" \
-d @- <<JSON
{
"companyKey": "$COMPANY_KEY",
"name": "U16 semi-final",
"sport": "volleyball",
"homeTeam": "Tigers",
"awayTeam": "Falcons",
"placeKey": "$PLACE_KEY",
"scheduledStartTime": 1757683200000,
"scheduledEndTime": 1757690400000
}
JSON
# → { "eventKey": "-Nq7xK2mBv9pL3aRt8Zc" }›Prüfen Sie zuerst Ihren Schlüssel
curl -o /dev/null -w '%{http_code}\n' \
-H "Authorization: Bearer $SPORFIE_TOKEN" \
https://api.sporfie.com/public/sports
# 200 means the key works. 401 means it doesn't.So funktioniert der Zugang
Persönlichen Schlüssel erstellen
Unter Einstellungen → Entwickler. Das Geheimnis wird nur einmal angezeigt — legen Sie es in einem Secret-Manager ab.
Er handelt in Ihrem Namen
Ein Schlüssel erreicht die Organisationen, die Sie verwalten, und kann bei der Erstellung auf bestimmte eingeschränkt werden. Jeder Aufruf wird gegen Ihre aktuelle Mitgliedschaft geprüft.
API aufrufen oder MCP verbinden
REST unter api.sporfie.com, Tools unter mcp.sporfie.com — gleicher Schlüssel, gleicher Umfang, gleiche Limits.
Sie müssen Organisationen verwalten, die Sie nicht administrieren? Dafür ist ein von Sporfie ausgestellter Integrationsschlüssel nötig.
Sprechen Sie mit unsGut zu wissen
- Etwa 1 Anfrage pro Sekunde und Schlüssel. Verteilen Sie Massenarbeit und drosseln Sie bei 429.
- Alle Zeiten sind UTC-Millisekunden seit der Unix-Epoche.
- Event-Watches laufen nach 12 Stunden ab — registrieren Sie sie regelmäßig neu.
- Ein Klick wird angenommen, nicht abgeschlossen: Clips brauchen einige Sekunden. Fragen Sie den Moment ab, wenn Sie die Datei brauchen.
- Schlüssel gehören auf den Server. Niemals in einen Browser, eine Mobile-App oder ein Repository.
Loslegen
Die vollständige Referenz, die OpenAPI-Spezifikation und ein Leitfaden für KI-Agenten finden Sie auf docs.sporfie.com.
Leitfaden für KI-Agenten