Punto final de MCP de producción
https://mcp.fbplot.com/mcpTransporte: HTTP transmitible; Código de autorización OAuth 2.1 + PKCE; Se admite la negociación de protocolos.
| Herramienta | Propósito | Alcances | Límites |
|---|---|---|---|
| resolve_players | Convierta nombres en identificaciones estables | players:read | 30/min |
| search_players | Descubre y filtra jugadores | jugadores: leer + estadísticas: leer | 30/min; 50/page |
| get_player_stats | Leer métricas seleccionadas | jugadores: leer + estadísticas: leer | 60/min; 5 players; 250 cells |
| get_fbplot_capabilities | Leer coberturas y límites | players:read | 60/min |
| list_metrics | Descubra ID de métricas válidas | stats:read | 60/min; 50/page |
| list_chart_presets | Descubra ajustes preestablecidos de gráficos/estilos | charts:read | 60/min; 50/page |
| list_chart_styles | Explorar ajustes preestablecidos de estilo gráfico de UI | charts:read | 60/min; 50/page |
| get_chart_style | Leer un estilo gráfico completo | charts:read | 60/min |
| get_chart_style_options | Inspeccionar opciones de estilo y fuentes. | charts:read | 60/min |
| create_chart_style | Guardar un estilo gráfico reutilizable | presets:write | 10/min |
| update_chart_style | Editar o cambiar el nombre de un estilo gráfico | presets:write | 20/min |
| delete_chart_style | Eliminar un estilo gráfico | presets:write | 10/min |
| create_chart | Cree un PNG privado con paridad de sitio web en línea | jugadores: leer + estadísticas: leer + gráficos: crear | 5 renders/min |
| get_chart | Recuperar metadatos de gráficos privados/PNG en línea | charts:read | 60/min |
Disponibilidad: Cada herramienta requiere una suscripción activa a FBPlot Pro o una cuenta de administrador, además de los alcances enumerados anteriormente. El derecho se verifica nuevamente en el momento de la ejecución.
resolve_players
Ver ejemplos- cuando usar
- Use first when the user gives a name and you need a stable FBPlot player_id.
- Entradas
- name; optional season, competition_id, team_id, and limit (1-10).
- Salida
- Candidatos acotados con identificaciones estables y contexto de identidad. Inspeccione los candidatos ambiguos antes de continuar.
- Errores
- PLAYER_NOT_FOUND, AMBIGUOUS_PLAYER, INVALID_INPUT.
Entrada de ejemplo
{ "name": "Lamine Yamal", "season": "2025/2026", "limit": 5 }search_players
Ver ejemplos- cuando usar
- Úselo para descubrimiento, filtrado o clasificación limitados dentro de una temporada.
- Entradas
- temporada más consulta opcional, equipos, competiciones, posiciones detalladas, valor de mercado, fin de contrato, nacionalidad, edad, minutos y condiciones métricas.
- Salida
- Un conjunto de resultados paginado y los filtros aplicados. No expone el conjunto de datos completo del jugador.
- Errores
- QUERY_TOO_COMPLEX, METRIC_NOT_AVAILABLE, SEASON_NOT_AVAILABLE, COMPETITION_NOT_AVAILABLE.
Entrada de ejemplo
{ "season": "2025/2026", "position_categories": ["Forwards"], "minutes_min": 900, "page_size": 10 }get_player_stats
Ver ejemplos- cuando usar
- Úselo después de que se confirmen las identificaciones de los jugadores y se conozcan las métricas solicitadas.
- Entradas
- 1-5 player_ids, up to 3 seasons, up to 3 competitions, aggregation, 1-16 metric_ids, normalization, and percentile preference.
- Salida
- Solo las estadísticas, definiciones, cobertura y campos de percentiles opcionales solicitados.
- Errores
- PLAYER_NOT_FOUND, METRIC_NOT_AVAILABLE, INVALID_COMPARISON, QUERY_TOO_COMPLEX.
Entrada de ejemplo
{ "player_ids": ["PLAYER_ID"], "seasons": ["2025/2026"], "aggregation": "season_total", "metric_ids": ["goals"], "normalization": "per90" }get_fbplot_capabilities
Ver ejemplos- cuando usar
- Úselo al comienzo de un nuevo flujo de trabajo para descubrir la cobertura, los límites del gráfico y los modos admitidos.
- Entradas
- Sin argumentos.
- Salida
- Versión del protocolo, regla de derechos, actualización de los datos, tipos de gráficos admitidos, límites y política de privacidad.
- Errores
- TEMPORARY_DATA_SERVICE_FAILURE.
Entrada de ejemplo
{}list_metrics
Ver ejemplos- cuando usar
- Úselo antes de adivinar un ID de métrica o crear una búsqueda, una solicitud de estadísticas o un gráfico.
- Entradas
- Optional search, category, chart_type, page, and page_size (1-50).
- Salida
- ID de métricas, etiquetas, unidades, categorías, definiciones y modos de normalización/gráficos admitidos.
- Errores
- METRIC_NOT_AVAILABLE, QUERY_TOO_COMPLEX.
Entrada de ejemplo
{ "search": "progressive", "chart_type": "radar", "page_size": 20 }list_chart_presets
Ver ejemplos- cuando usar
- Use to discover supported radar, bar, pizza, scatterplot, swarm, bubble, and visual-style preset IDs before create_chart.
- Entradas
- Optional chart_type, search, page, and page_size (1-50).
- Salida
- Metadatos preestablecidos compactos y las métricas/estilos que admite cada ajuste preestablecido.
- Errores
- INVALID_COMPARISON, QUERY_TOO_COMPLEX.
Entrada de ejemplo
{ "chart_type": "radar" }list_chart_styles
Ver ejemplos- cuando usar
- Explore los mismos ajustes preestablecidos gráficos propios, públicos, predeterminados e integrados que la interfaz de usuario. Estos están separados de los ajustes preestablecidos métricos.
- Entradas
- Optional chart_type, search, page and page_size (1-50).
- Salida
- Style IDs and compact metadata; use get_chart_style for the payload.
- Errores
- INSUFFICIENT_SCOPE.
Entrada de ejemplo
{ "chart_type": "radar" }get_chart_style
Ver ejemplos- cuando usar
- Inspeccione un ajuste preestablecido visible antes de aplicarlo o copiar su configuración.
- Entradas
- style_preset_id from list_chart_styles.
- Salida
- Carga útil completa de camelCase de interfaz de usuario nativa.
- Errores
- INVALID_COMPARISON, INSUFFICIENT_SCOPE.
Entrada de ejemplo
{ "style_preset_id": "builtin:clean-comparison" }get_chart_style_options
Ver ejemplos- cuando usar
- Descubra los controles disponibles y los valores de fuente certificados antes de diseñar un estilo.
- Entradas
- chart_type.
- Salida
- Campos nativos admitidos, esquema JSON de personalización, fuentes y reglas de precedencia.
- Errores
- INSUFFICIENT_SCOPE.
Entrada de ejemplo
{ "chart_type": "bar" }create_chart_style
Ver ejemplos- cuando usar
- Guarde un estilo gráfico reutilizable después de la aprobación del usuario. Requiere los ajustes preestablecidos: alcance de escritura; vuelva a conectar una subvención anterior para aprobarla.
- Entradas
- name, chart_type, payload in native UI camelCase. Public/default flags are Admin only.
- Salida
- ID preestablecido y carga útil guardados, disponibles en la interfaz de usuario de inmediato.
- Errores
- INVALID_COMPARISON, INSUFFICIENT_SCOPE, RATE_LIMITED.
Entrada de ejemplo
{ "name": "My editorial style", "chart_type": "bar", "payload": { "backgroundColor": "#ffffff", "labelFontSize": 14 } }update_chart_style
Ver ejemplos- cuando usar
- Cambie el nombre o reemplace un ajuste preestablecido de propiedad después de la aprobación del usuario. Lea primero su carga útil actual; La carga útil reemplaza todas las configuraciones.
- Entradas
- style_preset_id and at least one field to change.
- Salida
- Preestablecido actualizado. Los PNG de gráficos existentes permanecen sin cambios.
- Errores
- INVALID_COMPARISON, INSUFFICIENT_SCOPE, RATE_LIMITED.
Entrada de ejemplo
{ "style_preset_id": "123", "name": "Renamed style" }delete_chart_style
Ver ejemplos- cuando usar
- Elimine un ajuste preestablecido de propiedad después de la aprobación explícita del usuario.
- Entradas
- style_preset_id.
- Salida
- Confirmación de eliminación. Los gráficos existentes siguen estando disponibles.
- Errores
- INVALID_COMPARISON, INSUFFICIENT_SCOPE, RATE_LIMITED.
Entrada de ejemplo
{ "style_preset_id": "123" }create_chart
Ver ejemplos- cuando usar
- Úselo después de que se hayan confirmado las identidades y métricas y el usuario desee explícitamente una visualización guardada.
- Entradas
- 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.
- Salida
- 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.
- Errores
- INVALID_COMPARISON, PLAYER_NOT_FOUND, METRIC_NOT_AVAILABLE, CHART_RENDER_FAILED, RATE_LIMITED.
Entrada de ejemplo
{ "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
Ver ejemplos- cuando usar
- Úselo para recuperar un gráfico creado previamente y su imagen en línea mientras el activo almacenado está activo.
- Entradas
- chart_id returned by create_chart.
- Salida
- Metadatos del gráfico con ámbito de propietario y el PNG almacenado como un bloque de imagen MCP en línea cuando no ha caducado.
- Errores
- CHART_NOT_FOUND, INSUFFICIENT_SCOPE.
Entrada de ejemplo
{ "chart_id": 123 }Anotaciones y contrato de gráfico.
Las herramientas de lectura están marcadas como de solo lectura e idempotentes. create_chart cambia de estado y no está marcado intencionalmente como de solo lectura; crea un gráfico privado guardado y consume una cuota de renderizado.
create_chart apoya radar (serie de 2-3 jugadores por temporada, 3-16 métricas), bar (serie de un jugador por temporada, métricas 1-20), pizza (serie de un jugador por temporada, 3-16 métricas), scatterplot (Serie de temporada de 2 a 50 jugadores, exactamente dos métricas de eje, más una métrica de radio opcional), swarm (serie de temporada de 1 a 50 jugadores, hasta 20 métricas), y bubble (Serie de temporada de 2 a 50 jugadores, exactamente dos métricas de eje, más una métrica de radio opcional). Las métricas, temporadas y competiciones se validan con el catálogo de FBPlot y la cobertura de datos.
Paridad de personalización de gráficos
uso customization.<chart_type> para controlar la misma configuración visual que representa el editor FBPlot. El MCP y el sitio web utilizan la misma vista previa del gráfico y la misma raíz de exportación, por lo que el PNG mantiene el diseño, los colores, la tipografía y la marca seleccionados.
{
"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"
}
}
}| Gráfico | Controles disponibles a través de MCP |
|---|---|
| radares | Cohorte de comparación y filtros; series enfocadas; modo de superposición/diferencia; orden métrico, etiquetas de valores, precisión, formato percentil, escala radial y dirección; lienzo, cuadrícula, ejes, tipografía de etiquetas métricas, leyenda, encabezado, fotografías, insignias, banderas y estilos de relleno/trazo/marcador por serie. |
| barra | Cohorte de comparación y filtros; orden métrico; evolución del jugador; paleta; colores de fondo y categoría; tipografía de jugador, club, contexto y etiqueta de eje. |
| pizza | Cohorte de comparación y filtros; orden métrico; evolución del jugador; colores de fondo y categoría; tipografía de jugador, club y contexto; trazo circular, espacio de grupo y tipografía de etiqueta circular. |
| diagrama de dispersión | Cohorte de comparación y filtros; etiquetas de ejes y densidad de ticks; fondo, cuadrícula y líneas medias; tipografía de título/subtítulo/crédito; tamaño de burbuja, opacidad, trazo, modo de visualización, modo de color, liga/posición/métrica/colores destacados, evolución y ubicación/compensaciones de etiquetas. |
| enjambre | Cohorte de comparación y filtros; antecedentes y crédito; altura de fila, márgenes, radio del círculo, fluctuación, relleno/trazo/opacidad, modo de logotipo, colores de resaltado, ejes de fila/columna, etiquetas métricas y etiquetas de reproductor resaltado. |
| burbuja | Cohorte de comparación y filtros; alternadores de cuadrícula, enlaces, tendencias y medianas; Etiquetas X/Y y ejes numéricos/porcentuales/personalizados; radio, logotipos, etiquetas, fondos de etiquetas, regiones, cuadrantes, relleno, dimensiones, tipografía de temas, enlaces y colores de liga. |
Límites del contrato: los campos son estrictos y delimitados; los colores deben ser hexadecimales; las fuentes deben ser fuentes de gráficos FBPlot certificadas; Se rechazan CSS, HTML, imágenes externas y opciones de renderizado arbitrarios. Los datos del gráfico MCP son actualmente series explícitas de temporadas de jugadores. Los modos de período exclusivos del sitio web, como los últimos 365 días y las fechas personalizadas, no se simulan silenciosamente.