Endpoint MCP di produzione
https://mcp.fbplot.com/mcpTrasporto: HTTP streaming; Codice di autorizzazione OAuth 2.1 + PKCE; negoziazione del protocollo supportata.
| Strumento | Scopo | Ambiti | Limiti |
|---|---|---|---|
| resolve_players | Trasforma i nomi in ID stabili | players:read | 30/min |
| search_players | Scopri e filtra i giocatori | giocatori:leggi + statistiche:leggi | 30/min; 50/page |
| get_player_stats | Leggi le metriche selezionate | giocatori:leggi + statistiche:leggi | 60/min; 5 players; 250 cells |
| get_fbplot_capabilities | Leggi copertura e limiti | players:read | 60/min |
| list_metrics | Scopri ID metrica validi | stats:read | 60/min; 50/page |
| list_chart_presets | Scopri i preset di grafici/stili | charts:read | 60/min; 50/page |
| list_chart_styles | Sfoglia le preimpostazioni di stile grafico dell'interfaccia utente | charts:read | 60/min; 50/page |
| get_chart_style | Leggere uno stile grafico completo | charts:read | 60/min |
| get_chart_style_options | Controlla le opzioni di stile e i caratteri | charts:read | 60/min |
| create_chart_style | Salva uno stile grafico riutilizzabile | presets:write | 10/min |
| update_chart_style | Modifica o rinomina uno stile grafico | presets:write | 20/min |
| delete_chart_style | Elimina uno stile grafico | presets:write | 10/min |
| create_chart | Crea un PNG privato con parità di sito web in linea | giocatori:leggi + statistiche:leggi + classifiche:crea | 5 renders/min |
| get_chart | Recupera metadati/PNG della carta privata in linea | charts:read | 60/min |
Disponibilità: ogni strumento richiede un abbonamento FBPlot Pro attivo o un account amministratore, oltre agli ambiti sopra elencati. Il diritto viene nuovamente controllato al momento dell'esecuzione.
resolve_players
Vedi esempi- Quando usarlo
- Use first when the user gives a name and you need a stable FBPlot player_id.
- Ingressi
- name; optional season, competition_id, team_id, and limit (1-10).
- Uscita
- Candidati vincolati con ID stabili e contesto di identità. Ispezionare i candidati ambigui prima di continuare.
- Errori
- PLAYER_NOT_FOUND, AMBIGUOUS_PLAYER, INVALID_INPUT.
Ingresso di esempio
{ "name": "Lamine Yamal", "season": "2025/2026", "limit": 5 }search_players
Vedi esempi- Quando usarlo
- Utilizzare per la scoperta limitata, il filtraggio o la classificazione all'interno di una stagione.
- Ingressi
- stagione più query facoltative, squadre, competizioni, posizioni dettagliate, valore di mercato, fine del contratto, nazionalità, età, minuti e condizioni metriche.
- Uscita
- Un set di risultati impaginati e i filtri applicati. Non espone il set di dati completo del giocatore.
- Errori
- QUERY_TOO_COMPLEX, METRIC_NOT_AVAILABLE, SEASON_NOT_AVAILABLE, COMPETITION_NOT_AVAILABLE.
Ingresso di esempio
{ "season": "2025/2026", "position_categories": ["Forwards"], "minutes_min": 900, "page_size": 10 }get_player_stats
Vedi esempi- Quando usarlo
- Utilizzare dopo la conferma degli ID giocatore e la conoscenza delle metriche richieste.
- Ingressi
- 1-5 player_ids, up to 3 seasons, up to 3 competitions, aggregation, 1-16 metric_ids, normalization, and percentile preference.
- Uscita
- Only the requested statistics, definitions, coverage, and optional percentile fields.
- Errori
- PLAYER_NOT_FOUND, METRIC_NOT_AVAILABLE, INVALID_COMPARISON, QUERY_TOO_COMPLEX.
Ingresso di esempio
{ "player_ids": ["PLAYER_ID"], "seasons": ["2025/2026"], "aggregation": "season_total", "metric_ids": ["goals"], "normalization": "per90" }get_fbplot_capabilities
Vedi esempi- Quando usarlo
- Utilizzalo all'inizio di un nuovo flusso di lavoro per scoprire copertura, limiti della carta e modalità supportate.
- Ingressi
- Nessun argomento.
- Uscita
- Versione del protocollo, regola di autorizzazione, aggiornamento dei dati, tipi di grafici supportati, limiti e policy sulla privacy.
- Errori
- TEMPORARY_DATA_SERVICE_FAILURE.
Ingresso di esempio
{}list_metrics
Vedi esempi- Quando usarlo
- Da utilizzare prima di indovinare un ID metrica o creare una ricerca, una richiesta di statistiche o un grafico.
- Ingressi
- Optional search, category, chart_type, page, and page_size (1-50).
- Uscita
- ID parametri, etichette, unità, categorie, definizioni e modalità di grafico/normalizzazione supportate.
- Errori
- METRIC_NOT_AVAILABLE, QUERY_TOO_COMPLEX.
Ingresso di esempio
{ "search": "progressive", "chart_type": "radar", "page_size": 20 }list_chart_presets
Vedi esempi- Quando usarlo
- Use to discover supported radar, bar, pizza, scatterplot, swarm, bubble, and visual-style preset IDs before create_chart.
- Ingressi
- Optional chart_type, search, page, and page_size (1-50).
- Uscita
- Metadati preimpostati compatti e metriche/stili supportati da ogni preimpostazione.
- Errori
- INVALID_COMPARISON, QUERY_TOO_COMPLEX.
Ingresso di esempio
{ "chart_type": "radar" }list_chart_styles
Vedi esempi- Quando usarlo
- Sfoglia le stesse preimpostazioni grafiche di proprietà, pubbliche, predefinite e integrate dell'interfaccia utente. Questi sono separati dalle preimpostazioni metriche.
- Ingressi
- Optional chart_type, search, page and page_size (1-50).
- Uscita
- Style IDs and compact metadata; use get_chart_style for the payload.
- Errori
- INSUFFICIENT_SCOPE.
Ingresso di esempio
{ "chart_type": "radar" }get_chart_style
Vedi esempi- Quando usarlo
- Esamina una preimpostazione visibile prima di applicarla o di copiarne le impostazioni.
- Ingressi
- style_preset_id from list_chart_styles.
- Uscita
- Payload camelCase completo dell'interfaccia utente nativa.
- Errori
- INVALID_COMPARISON, INSUFFICIENT_SCOPE.
Ingresso di esempio
{ "style_preset_id": "builtin:clean-comparison" }get_chart_style_options
Vedi esempi- Quando usarlo
- Scopri i controlli disponibili e i valori dei caratteri certificati prima di progettare uno stile.
- Ingressi
- chart_type.
- Uscita
- Campi nativi supportati, schema JSON di personalizzazione, caratteri e regole di precedenza.
- Errori
- INSUFFICIENT_SCOPE.
Ingresso di esempio
{ "chart_type": "bar" }create_chart_style
Vedi esempi- Quando usarlo
- Salva uno stile grafico riutilizzabile dopo l'approvazione dell'utente. Richiede le preimpostazioni: ambito di scrittura; ricollegare una sovvenzione precedente per approvarla.
- Ingressi
- name, chart_type, payload in native UI camelCase. Public/default flags are Admin only.
- Uscita
- ID preimpostato e payload salvati, immediatamente disponibili nell'interfaccia utente.
- Errori
- INVALID_COMPARISON, INSUFFICIENT_SCOPE, RATE_LIMITED.
Ingresso di esempio
{ "name": "My editorial style", "chart_type": "bar", "payload": { "backgroundColor": "#ffffff", "labelFontSize": 14 } }update_chart_style
Vedi esempi- Quando usarlo
- Rinominare o sostituire una preimpostazione di proprietà dopo l'approvazione dell'utente. Leggi prima il suo carico utile attuale; il payload sostituisce tutte le impostazioni.
- Ingressi
- style_preset_id and at least one field to change.
- Uscita
- Preimpostazione aggiornata. I PNG dei grafici esistenti rimangono invariati.
- Errori
- INVALID_COMPARISON, INSUFFICIENT_SCOPE, RATE_LIMITED.
Ingresso di esempio
{ "style_preset_id": "123", "name": "Renamed style" }delete_chart_style
Vedi esempi- Quando usarlo
- Elimina una preimpostazione di proprietà dopo l'approvazione esplicita dell'utente.
- Ingressi
- style_preset_id.
- Uscita
- Conferma dell'eliminazione. Le carte esistenti rimangono disponibili.
- Errori
- INVALID_COMPARISON, INSUFFICIENT_SCOPE, RATE_LIMITED.
Ingresso di esempio
{ "style_preset_id": "123" }create_chart
Vedi esempi- Quando usarlo
- Utilizzare dopo che identità e metriche sono state confermate e l'utente desidera esplicitamente una visualizzazione salvata.
- Ingressi
- 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.
- Uscita
- 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.
- Errori
- INVALID_COMPARISON, PLAYER_NOT_FOUND, METRIC_NOT_AVAILABLE, CHART_RENDER_FAILED, RATE_LIMITED.
Ingresso di esempio
{ "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
Vedi esempi- Quando usarlo
- Utilizzare per recuperare un grafico creato in precedenza e la relativa immagine in linea mentre la risorsa archiviata è attiva.
- Ingressi
- chart_id returned by create_chart.
- Uscita
- Owner-scoped chart metadata and the stored PNG as an inline MCP image block when it has not expired.
- Errori
- CHART_NOT_FOUND, INSUFFICIENT_SCOPE.
Ingresso di esempio
{ "chart_id": 123 }Annotazioni e contratto grafico
Gli strumenti di lettura sono contrassegnati come di sola lettura e idempotenti. create_chart cambia stato e non è intenzionalmente contrassegnato come di sola lettura; crea un grafico salvato privato e consuma una quota di rendering.
create_chart supporta radar (serie di 2-3 giocatori per stagione, metriche 3-16), bar (serie di un giocatore per stagione, metriche 1-20), pizza (serie di un giocatore per stagione, metriche 3-16), scatterplot (serie da 2 a 50 giocatori per stagione, metriche esattamente su due assi, più una metrica del raggio opzionale), swarm (serie da 1 a 50 giocatori per stagione, fino a 20 metriche) e bubble (Serie da 2 a 50 giocatori per stagione, metriche esattamente su due assi, più una metrica del raggio opzionale). Metriche, stagioni e competizioni vengono convalidate rispetto al catalogo FBPlot e alla copertura dei dati.
Parità di personalizzazione del grafico
Utilizzare customization.<chart_type> per controllare le stesse impostazioni visive renderizzate dall'editor FBPlot. MCP e sito Web utilizzano la stessa anteprima del grafico e la stessa radice di esportazione, quindi il PNG mantiene il layout, i colori, la tipografia e il marchio selezionati.
{
"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"
}
}
}| Grafico | Controlli disponibili tramite MCP |
|---|---|
| radar | Coorte di confronto e filtri; serie focalizzate; modalità sovrapposizione/differenza; ordine metrico, etichette dei valori, precisione, formato percentile, scala radiale e direzione; tela, griglia, assi, tipografia di etichette metriche, legenda, intestazione, foto, badge, flag e stili di riempimento/tratto/marcatore per serie. |
| barra | Coorte di confronto e filtri; ordine metrico; evoluzione del giocatore; tavolozza; colori dello sfondo e delle categorie; tipografia del giocatore, del club, del contesto e dell'etichetta dell'asse. |
| pizza | Coorte di confronto e filtri; ordine metrico; evoluzione del giocatore; colori dello sfondo e delle categorie; tipografia del giocatore, del club e del contesto; tratto circolare, gap di gruppo e tipografia con etichetta circolare. |
| grafico a dispersione | Coorte di confronto e filtri; etichette degli assi e densità delle zecche; sfondo, griglia e linee medie; tipografia titolo/sottotitolo/credito; dimensione delle bolle, opacità, tratto, modalità di visualizzazione, modalità colore, lega/posizione/metrica/colori evidenziati, evoluzione e posizionamento/offset delle etichette. |
| sciame | Coorte di confronto e filtri; background e credito; altezza della riga, margini, raggio del cerchio, jitter, riempimento/tratto/opacità, modalità logo, colori evidenziati, assi di riga/colonna, etichette metriche ed etichette del giocatore evidenziato. |
| bolla | Coorte di confronto e filtri; griglia, collegamenti, trend e commutatori mediani; Etichette X/Y e assi numerici/percentuali/personalizzati; raggio, loghi, etichette, sfondi delle etichette, regioni, quadranti, imbottitura, dimensioni, tipografia del tema, collegamenti e colori della lega. |
Limiti contrattuali: i campi sono rigorosi e delimitati; i colori devono essere esadecimali; i caratteri devono essere caratteri grafici FBPlot certificati; CSS, HTML, immagini esterne e opzioni di rendering arbitrari vengono rifiutati. I dati del grafico MCP sono attualmente serie esplicite di stagione dei giocatori. Le modalità periodiche solo per il sito Web, come gli ultimi 365 giorni e le date personalizzate, non vengono simulate in modo silenzioso.