Produktions-MCP-Endpunkt
https://mcp.fbplot.com/mcpTransport: Streambares HTTP; OAuth 2.1-Autorisierungscode + PKCE; Protokollverhandlung unterstützt.
| Werkzeug | Zweck | Bereiche | Grenzen |
|---|---|---|---|
| resolve_players | Verwandeln Sie Namen in stabile IDs | players:read | 30/min |
| search_players | Entdecken und filtern Sie Spieler | Spieler:Lesen + Statistiken:Lesen | 30/min; 50/page |
| get_player_stats | Ausgewählte Metriken lesen | Spieler:Lesen + Statistiken:Lesen | 60/min; 5 players; 250 cells |
| get_fbplot_capabilities | Lesen Sie Abdeckung und Grenzen | players:read | 60/min |
| list_metrics | Entdecken Sie gültige Metrik-IDs | stats:read | 60/min; 50/page |
| list_chart_presets | Entdecken Sie Diagramm-/Stilvoreinstellungen | charts:read | 60/min; 50/page |
| list_chart_styles | Durchsuchen Sie die Voreinstellungen für den UI-Grafikstil | charts:read | 60/min; 50/page |
| get_chart_style | Lesen Sie einen vollständigen Grafikstil | charts:read | 60/min |
| get_chart_style_options | Überprüfen Sie Stiloptionen und Schriftarten | charts:read | 60/min |
| create_chart_style | Speichern Sie einen wiederverwendbaren Grafikstil | presets:write | 10/min |
| update_chart_style | Bearbeiten oder benennen Sie einen Grafikstil um | presets:write | 20/min |
| delete_chart_style | Löschen Sie einen Grafikstil | presets:write | 10/min |
| create_chart | Erstellen Sie inline ein PNG mit privater Website-Parität | Spieler:lesen + Statistiken:lesen + Diagramme:erstellen | 5 renders/min |
| get_chart | Rufen Sie private Diagrammmetadaten/PNG inline ab | charts:read | 60/min |
Verfügbarkeit: Für jedes Tool sind ein aktives FBPlot Pro-Abonnement oder ein Administratorkonto sowie die oben aufgeführten Bereiche erforderlich. Die Berechtigung wird zum Zeitpunkt der Ausführung erneut überprüft.
resolve_players
Siehe Beispiele- Wann zu verwenden
- Use first when the user gives a name and you need a stable FBPlot player_id.
- Eingaben
- name; optional season, competition_id, team_id, and limit (1-10).
- Ausgabe
- Begrenzte Kandidaten mit stabilen IDs und Identitätskontext. Überprüfen Sie unklare Kandidaten, bevor Sie fortfahren.
- Fehler
- PLAYER_NOT_FOUND, AMBIGUOUS_PLAYER, INVALID_INPUT.
Beispieleingabe
{ "name": "Lamine Yamal", "season": "2025/2026", "limit": 5 }search_players
Siehe Beispiele- Wann zu verwenden
- Zur begrenzten Entdeckung, Filterung oder Rangfolge innerhalb einer Saison verwenden.
- Eingaben
- Saison plus optionale Abfrage, Teams, Wettbewerbe, detaillierte Positionen, Marktwert, Vertragsende, Nationalität, Alter, Minuten und metrische Bedingungen.
- Ausgabe
- Eine paginierte Ergebnismenge und die angewendeten Filter. Der vollständige Spielerdatensatz wird nicht verfügbar gemacht.
- Fehler
- QUERY_TOO_COMPLEX, METRIC_NOT_AVAILABLE, SEASON_NOT_AVAILABLE, COMPETITION_NOT_AVAILABLE.
Beispieleingabe
{ "season": "2025/2026", "position_categories": ["Forwards"], "minutes_min": 900, "page_size": 10 }get_player_stats
Siehe Beispiele- Wann zu verwenden
- Wird verwendet, nachdem die Spieler-IDs bestätigt wurden und die angeforderten Messwerte bekannt sind.
- Eingaben
- 1-5 player_ids, up to 3 seasons, up to 3 competitions, aggregation, 1-16 metric_ids, normalization, and percentile preference.
- Ausgabe
- Nur die angeforderten Statistiken, Definitionen, Abdeckung und optionalen Perzentilfelder.
- Fehler
- PLAYER_NOT_FOUND, METRIC_NOT_AVAILABLE, INVALID_COMPARISON, QUERY_TOO_COMPLEX.
Beispieleingabe
{ "player_ids": ["PLAYER_ID"], "seasons": ["2025/2026"], "aggregation": "season_total", "metric_ids": ["goals"], "normalization": "per90" }get_fbplot_capabilities
Siehe Beispiele- Wann zu verwenden
- Verwenden Sie es zu Beginn eines neuen Workflows, um Abdeckung, Kartengrenzen und unterstützte Modi zu ermitteln.
- Eingaben
- Keine Argumente.
- Ausgabe
- Protokollversion, Berechtigungsregel, Datenaktualität, unterstützte Diagrammtypen, Grenzwerte und Datenschutzrichtlinie.
- Fehler
- TEMPORARY_DATA_SERVICE_FAILURE.
Beispieleingabe
{}list_metrics
Siehe Beispiele- Wann zu verwenden
- Verwenden Sie diese Option, bevor Sie eine Metrik-ID erraten oder eine Suche, eine Statistikanfrage oder ein Diagramm erstellen.
- Eingaben
- Optional search, category, chart_type, page, and page_size (1-50).
- Ausgabe
- Metrik-IDs, Beschriftungen, Einheiten, Kategorien, Definitionen und unterstützte Diagramm-/Normalisierungsmodi.
- Fehler
- METRIC_NOT_AVAILABLE, QUERY_TOO_COMPLEX.
Beispieleingabe
{ "search": "progressive", "chart_type": "radar", "page_size": 20 }list_chart_presets
Siehe Beispiele- Wann zu verwenden
- Use to discover supported radar, bar, pizza, scatterplot, swarm, bubble, and visual-style preset IDs before create_chart.
- Eingaben
- Optional chart_type, search, page, and page_size (1-50).
- Ausgabe
- Kompakte voreingestellte Metadaten und die Metriken/Stile, die jede Voreinstellung unterstützt.
- Fehler
- INVALID_COMPARISON, QUERY_TOO_COMPLEX.
Beispieleingabe
{ "chart_type": "radar" }list_chart_styles
Siehe Beispiele- Wann zu verwenden
- Durchsuchen Sie dieselben eigenen, öffentlichen, standardmäßigen und integrierten Grafikvoreinstellungen wie die Benutzeroberfläche. Diese unterscheiden sich von den metrischen Voreinstellungen.
- Eingaben
- Optional chart_type, search, page and page_size (1-50).
- Ausgabe
- Style IDs and compact metadata; use get_chart_style for the payload.
- Fehler
- INSUFFICIENT_SCOPE.
Beispieleingabe
{ "chart_type": "radar" }get_chart_style
Siehe Beispiele- Wann zu verwenden
- Überprüfen Sie eine sichtbare Voreinstellung, bevor Sie sie anwenden oder ihre Einstellungen kopieren.
- Eingaben
- style_preset_id from list_chart_styles.
- Ausgabe
- Vollständige CamelCase-Nutzlast für die native Benutzeroberfläche.
- Fehler
- INVALID_COMPARISON, INSUFFICIENT_SCOPE.
Beispieleingabe
{ "style_preset_id": "builtin:clean-comparison" }get_chart_style_options
Siehe Beispiele- Wann zu verwenden
- Entdecken Sie verfügbare Steuerelemente und zertifizierte Schriftartwerte, bevor Sie einen Stil entwerfen.
- Eingaben
- chart_type.
- Ausgabe
- Unterstützte native Felder, Anpassung des JSON-Schemas, Schriftarten und Prioritätsregeln.
- Fehler
- INSUFFICIENT_SCOPE.
Beispieleingabe
{ "chart_type": "bar" }create_chart_style
Siehe Beispiele- Wann zu verwenden
- Speichern Sie nach Genehmigung durch den Benutzer einen wiederverwendbaren Grafikstil. Erfordert den Presets:write-Bereich; Verbinden Sie einen älteren Zuschuss erneut, um ihn zu genehmigen.
- Eingaben
- name, chart_type, payload in native UI camelCase. Public/default flags are Admin only.
- Ausgabe
- Gespeicherte voreingestellte ID und Nutzlast, sofort in der Benutzeroberfläche verfügbar.
- Fehler
- INVALID_COMPARISON, INSUFFICIENT_SCOPE, RATE_LIMITED.
Beispieleingabe
{ "name": "My editorial style", "chart_type": "bar", "payload": { "backgroundColor": "#ffffff", "labelFontSize": 14 } }update_chart_style
Siehe Beispiele- Wann zu verwenden
- Benennen Sie eine eigene Voreinstellung um oder ersetzen Sie sie nach Zustimmung des Benutzers. Lesen Sie zuerst die aktuelle Nutzlast. Payload ersetzt alle Einstellungen.
- Eingaben
- style_preset_id and at least one field to change.
- Ausgabe
- Aktualisierte Voreinstellung. Vorhandene Diagramm-PNGs bleiben unverändert.
- Fehler
- INVALID_COMPARISON, INSUFFICIENT_SCOPE, RATE_LIMITED.
Beispieleingabe
{ "style_preset_id": "123", "name": "Renamed style" }delete_chart_style
Siehe Beispiele- Wann zu verwenden
- Löschen Sie eine eigene Voreinstellung nach ausdrücklicher Benutzergenehmigung.
- Eingaben
- style_preset_id.
- Ausgabe
- Löschbestätigung. Vorhandene Diagramme bleiben verfügbar.
- Fehler
- INVALID_COMPARISON, INSUFFICIENT_SCOPE, RATE_LIMITED.
Beispieleingabe
{ "style_preset_id": "123" }create_chart
Siehe Beispiele- Wann zu verwenden
- Wird verwendet, nachdem Identitäten und Metriken bestätigt wurden und der Benutzer ausdrücklich eine gespeicherte Visualisierung wünscht.
- Eingaben
- radar, bar, pizza, scatterplot, swarm, or bubble chart_type, bounded player-season series, metrics, normalization, aspect ratio, style_preset_id, native UI style overrides, branding, and optional customization.<chart_type> controls. Explicit fields/customization override the preset.
- Ausgabe
- Private chart_id, edit_url, metadata, data freshness, and the PNG as an inline MCP image block. No PNG URL or public share URL is created.
- Fehler
- INVALID_COMPARISON, PLAYER_NOT_FOUND, METRIC_NOT_AVAILABLE, CHART_RENDER_FAILED, RATE_LIMITED.
Beispieleingabe
{ "chart_type": "scatterplot", "series": [{ "player_id": "PLAYER_ID_1", "season": "2025/2026" }, { "player_id": "PLAYER_ID_2", "season": "2025/2026" }], "metric_ids": ["goals", "assists"], "radius_metric_id": "minutes" }get_chart
Siehe Beispiele- Wann zu verwenden
- Verwenden Sie diese Option, um ein zuvor erstelltes Diagramm und sein Inline-Bild abzurufen, während das gespeicherte Asset aktiv ist.
- Eingaben
- chart_id returned by create_chart.
- Ausgabe
- Eigentümerbezogene Diagrammmetadaten und das gespeicherte PNG als Inline-MCP-Bildblock, wenn es nicht abgelaufen ist.
- Fehler
- CHART_NOT_FOUND, INSUFFICIENT_SCOPE.
Beispieleingabe
{ "chart_id": 123 }Anmerkungen und Kartenvertrag
Lesewerkzeuge sind als schreibgeschützt und idempotent gekennzeichnet. create_chart ist zustandsverändernd und absichtlich nicht als schreibgeschützt markiert; Es erstellt ein privates gespeichertes Diagramm und verbraucht ein Renderkontingent.
create_chart unterstützt radar (2-3 Spieler-Saisonserie, 3-16 Metriken), bar (eine Spielersaisonserie, 1–20 Metriken), pizza (eine Spielersaisonserie, 3–16 Messwerte), scatterplot (2-50-Spieler-Saisonserie, genau zwei Achsenmetriken, plus eine optionale Radiusmetrik), swarm (1–50 Spieler-Saisonserien, bis zu 20 Metriken) und bubble (2–50 Spieler-Saisonserie, genau zwei Achsenmetriken, plus eine optionale Radiusmetrik). Metriken, Saisons und Wettbewerbe werden anhand des FBPlot-Katalogs und der Datenabdeckung validiert.
Parität der Diagrammanpassung
Benutzen customization.<chart_type> um dieselben visuellen Einstellungen zu steuern, die vom FBPlot-Editor gerendert werden. Das MCP und die Website verwenden dieselbe Diagrammvorschau und denselben Exportstamm, sodass das PNG das ausgewählte Layout, die Farben, die Typografie und das Branding beibehält.
{
"chart_type": "bar",
"series": [{ "player_id": "PLAYER_ID", "season": "2025/2026" }],
"metric_ids": ["goals", "assists", "shots"],
"customization": {
"bar": {
"compared_against": "Forwards",
"comparison_scope": "Top 5 leagues",
"stats_filters": { "minutes_min": 900 },
"background_color": "#f7faf9",
"bar_colors": { "attacking": "#c3552b" },
"player_name_font_family": "'Oswald', 'Helvetica Neue', sans-serif",
"label_font_size": 13,
"label_font_weight": 700,
"label_font_color": "#10272a"
}
}
}| Diagramm | Steuerungen über MCP verfügbar |
|---|---|
| Radar | Vergleichskohorte und Filter; fokussierte Serie; Überlagerungs-/Differenzmodus; metrische Reihenfolge, Wertebeschriftungen, Präzision, Perzentilformat, radiale Skala und Richtung; Leinwand, Raster, Achsen, metrische Beschriftungstypografie, Legende, Kopfzeile, Fotos, Abzeichen, Flaggen und Füll-/Strich-/Markierungsstile pro Serie. |
| Bar | Vergleichskohorte und Filter; metrische Ordnung; Spielerentwicklung; Palette; Hintergrund- und Kategoriefarben; Spieler-, Vereins-, Kontext- und Achsenbeschriftungstypografie. |
| Pizza | Vergleichskohorte und Filter; metrische Ordnung; Spielerentwicklung; Hintergrund- und Kategoriefarben; Spieler-, Vereins- und Kontexttypografie; Kreisstrich, Gruppenlücke und Typografie mit kreisförmigen Etiketten. |
| Streudiagramm | Vergleichskohorte und Filter; Achsenbeschriftungen und Teilstrichdichte; Hintergrund-, Raster- und Durchschnittslinien; Titel-/Untertitel-/Credit-Typografie; Blasengröße, Deckkraft, Strich, Anzeigemodus, Farbmodus, Liga/Position/Metrik/Hervorhebungsfarben, Entwicklung und Beschriftungsplatzierung/-versätze. |
| Schwarm | Vergleichskohorte und Filter; Hintergrund und Bonität; Zeilenhöhe, Ränder, Kreisradius, Jitter, Füllung/Kontur/Deckkraft, Logo-Modus, Hervorhebungsfarben, Zeilen-/Spaltenachsen, metrische Beschriftungen und hervorgehobene Player-Beschriftungen. |
| Blase | Vergleichskohorte und Filter; Raster, Links, Trend- und Median-Schalter; X/Y-Beschriftungen und Zahlen-/Prozent-/benutzerdefinierte Achsen; Radius, Logos, Etiketten, Etikettenhintergründe, Regionen, Quadranten, Polsterung, Abmessungen, Thementypografie, Links und Ligafarben. |
Vertragslimits: Felder sind streng und begrenzt; Farben müssen hexadezimal sein; Schriftarten müssen zertifizierte FBPlot-Diagrammschriftarten sein; Beliebige CSS-, HTML-, externe Bilder- und Renderer-Optionen werden abgelehnt. Bei den MCP-Chartdaten handelt es sich derzeit um explizite Spielersaisonreihen. Nur-Website-Zeitraummodi wie die letzten 365 Tage und benutzerdefinierte Daten werden nicht stillschweigend simuliert.