Mi Basket

Lists the clubs, teams and players that the signed-in Mi Basket user follows, with their ids and links; read-only. ALWAYS call this tool when the user asks what or whom they follow, who their teams or players are, or anything about "my" teams or players: the list lives in their Mi Basket account and is NOT in the conversation, so never answer that question from chat memory. Los clubes, equipos y jugadores que la persona que pregunta sigue en Mi Basket, con sus ids y links. Use when el usuario dice "mi hijo", "mi equipo", "los míos", "a quién sigo" o pide algo de sus favoritos sin nombrarlos: PRIMERO esta tool, y después las demás con los ids que devuelve. Do NOT use para buscar a alguien que no sigue (usá search_player) ni para cambiar sus favoritos: esto no escribe nada. Read-only. Sin parámetros.

my_follows

Searches people in the FUBB archive by name and returns matching candidates with their opaque person id, their teams and identity confidence; read-only. Busca personas del archivo por nombre y devuelve candidatos con su confianza de identidad, equipo actual y personId. Use when el usuario nombra a un jugador y querés ubicarlo o desambiguar homónimos antes de pedir su historia o stats. Do NOT use para rankings de una categoría (usá leaders), para la ficha de un jugador (player_stats) ni para el acta de un partido (match_report). Cada fila trae `ficha=<url>` (su página), `equipo=` y `foto=` cuando hay. Read-only. Máx. 100 resultados (default 25). Pasá el personId devuelto a player_history o match_report.

search_player

Lists fixtures and results of Uruguayan (FUBB) basketball from the Mi Basket archive for a date range, preset, team, club or category; read-only. Calendario/fixture: qué partidos hay en un rango de fechas, con hora local de Uruguay, categoría, cancha, estado y marcador si ya se jugaron. Use when el usuario pregunta qué se juega hoy, mañana, el fin de semana o una fecha; a qué hora y dónde juega un equipo; o qué partidos hubo en unos días. El rango se pide por `preset` (today, tomorrow, weekend, this_week, next_7_days, yesterday, last_7_days, this_month, last_30_days) o por `from`/`to` en YYYY-MM-DD — NO calcules las fechas por tu cuenta, el server las resuelve en la zona de Uruguay y devuelve cuáles usó. Si la pregunta es relativa ("hoy", "mañana", "el finde", "esta semana", "la semana que viene", "los últimos días", "este mes") usá SIEMPRE el preset; `from`/`to` son solo para fechas explícitas. El rango llega hasta 92 días (tres meses) por consulta: para una temporada entera, pedí un trimestre por vez. Do NOT pedir un año entero de una: responde INVALID_INPUT diciendo cuántos días pediste. CADA partido trae `localDay` y `localTime` ya resueltos. Filtrá con `category` ("U14", por nombre, no hace falta el id) o `team` ("Aguada"), y elegí el eje con `groupBy`: category, date o venue. Con muchos partidos usá `summary: true` para traer solo los conteos por grupo y después pedir el detalle de uno; y si vas a reagrupar por un eje que este tool no ofrece, volvé a llamarlo con `limit` chico en vez de reprocesar cientos de filas. Cada partido trae su `matchId` (para match_report), su `phaseId` (para acotar `leaders` y `player_stats` a esa fase del torneo) y su `url` en Mi Basket: citá esa url como link cuando lo nombres, y NO inventes ninguna. UNA llamada con el rango (y la categoría o el equipo) devuelve TODOS los partidos del rango, cada uno con su matchId: no la repitas por equipo ni por fecha para "completar" la lista, ya está completa. Si el usuario quiere el acta de uno de esos partidos, el siguiente paso es match_report con ese matchId, no otra llamada a schedule. Do NOT use para el detalle de un partido (usá match_report con el matchId que devuelve este tool) ni para la tabla (standings). Read-only.

schedule

Lists the categories and seasons in the Mi Basket archive of Uruguayan (FUBB) basketball with their ids, and which statistics exist and which do not; read-only. Lista las categorías y temporadas del archivo con sus IDs, y QUÉ ESTADÍSTICAS existen y cuáles no. Use when necesitás un categoryId para leaders o standings, cuando el usuario pregunta qué categorías/temporadas hay, o antes de prometer una estadística. Llamalo PRIMERO cuando vas a pedir rankings, fichas o tablas y no tenés el categoryId. Do NOT use para buscar jugadores (usá search_player). Read-only. Sin parámetros.

list_catalog

Reports that this Mi Basket MCP server is up and which version it runs, not the status of the FUBB source; read-only. Estado y versión del servidor MCP del archivo (NO de FUBB). Use when el usuario pregunta si el servicio anda, qué versión corre, o para verificar la conexión del connector. Do NOT use para datos de básquet (usá los demás tools). Read-only. Sin parámetros.

service_status

Returns archived FUBB statistics for one or more players, as totals, per-game averages and best game, broken down by category and competition; read-only. Ficha estadística de uno o varios jugadores: totales, promedios por partido y mejor marca, abiertos por categoría y competencia. Estadísticas disponibles: points (puntos), minutes (minutos), valuation (valoración), plus_minus (diferencia (+/-)), twos (dobles convertidos), threes (triples convertidos), free_throws (libres convertidos), free_throws_att (libres intentados), fouls (faltas cometidas). Default: puntos, minutos, valoración y +/-. Use when el usuario pregunta cómo viene un jugador, cuánto promedia, cuántos minutos juega, su mejor partido, o quiere COMPARAR jugadores (pasá varios personId y salen todos en una consulta). Los personId salen de search_player o de leaders. Acotá con `categoryId`, `seasonId` o un rango `from`/`to` para responder "cómo viene en las últimas fechas". Cada número viene con los partidos que tenían el dato: si dice "sobre 12 de 14 PJ", el promedio es sobre esos 12 y hay que decirlo así. Cada jugador trae la url de su ficha. Do NOT use para rankings de una categoría (usá leaders) ni para el acta de un partido (match_report). Read-only.

player_stats

Returns a FUBB team profile: its roster with per-player averages, its record by tournament phase and its scoring; read-only. Ficha de un equipo: su plantilla con los promedios de cada jugador, su récord por fase del torneo y su anotación. Use when el usuario pregunta quiénes juegan en un equipo, el plantel, el plantel de un club, cómo le va a un equipo, o en qué categorías juega un club. Buscá por `name` (parte del nombre alcanza). Si el nombre matchea VARIOS equipos, vienen todos listados con su categoría y su teamId: así se ve un club completo ("Aguada" son doce equipos, uno por categoría) y se elige el que interesa. Con un solo match, viene la ficha directo. La plantilla trae el personId de cada jugador: pasalo a player_stats o player_history. El teamId sirve para volver a llamar acá sin ambigüedad. El récord y la posición salen de la tabla OFICIAL, y vienen con UNA FILA POR FASE (primera fase, segunda, playoff): sumar sus PJ da los partidos del equipo en la categoría. Los puntos a favor y en contra por partido se calculan de los MARCADORES, porque la tabla de la fuente no trae esas columnas. Do NOT use para el calendario del equipo (usá schedule con `team`), para la tabla completa de su grupo (standings) ni para rankings de jugadores (leaders). Read-only.

team

Returns a player's career across archived FUBB seasons: teams, categories, games played and scoring averages, with identity confidence; read-only. Trayectoria de una persona a través de las temporadas archivadas: equipos, categorías, partidos jugados y promedios, con la confianza de identidad. Use when el usuario quiere saber cómo le fue a un jugador, su carrera, en qué equipos jugó, o su evolución. Do NOT use para buscar/desambiguar (usá search_player primero para obtener el personId) ni para el acta de UN partido (usá match_report). Trae la url de su ficha, la de sus VIDEOS (`video=`, los clips de sus jugadas) y la de cada equipo y cada partido. Read-only. El archivo es prospectivo desde 2026 (no retroactivo): la historia crece hacia adelante. Requiere el personId que devuelve search_player o leaders. Para promedios y minutos, usá player_stats.

player_history

Returns the archived FUBB games between two teams or clubs, with the win-loss balance and each game's score; read-only. Enfrentamientos archivados entre dos equipos (por nombre): balance de victorias + lista de partidos con sus marcadores y matchId. Acepta el nombre del equipo o el de su club: un club puede tener equipos con otro nombre (Biguá juega como Biguá y también como Biarritz) y vienen todos. Use when el usuario pregunta cómo le fue un equipo contra otro, el historial/antecedentes entre dos clubes, o quiere el matchId de un partido entre ellos. Do NOT use para la tabla general (usá standings) ni para el acta de un partido (usá match_report). Si ya tenés el matchId (de schedule o de player_history) andá derecho a match_report: esta tool recorre todo el historial entre los dos equipos. Cada partido trae su `localDay`, su CATEGORÍA y su url. OJO con el balance: dos clubes se cruzan en VARIAS categorías a la vez (Peñarol y Aguada, cinco, de U14 a mayores). Si `categories` trae más de una, el balance suma torneos distintos y hay que decirlo, o volver a llamar con `categoryId`. Read-only. Máx. 200 partidos (default 50). El archivo es prospectivo desde 2026. Pasá un matchId de la lista a match_report.

head_to_head

Ranks players by any archived FUBB statistic as totals or per-game averages, or teams by their scoring per game, over an optional category, phase, group, team or date window; read-only. Ranking de jugadores por cualquier estadística del archivo, en total o promedio por partido, con el ámbito y la ventana de fechas que pidas. Estadísticas disponibles: points (puntos), minutes (minutos), valuation (valoración), plus_minus (diferencia (+/-)), twos (dobles convertidos), threes (triples convertidos), free_throws (libres convertidos), free_throws_att (libres intentados), fouls (faltas cometidas). Use when el usuario pide los mejores/top/líderes de algo: goleadores, quién promedia más puntos o más minutos, el mejor +/-, los triplistas. Pedí VARIAS estadísticas de una en `stats` (salen en la misma consulta, sin costo extra) y ordená por una con `sortBy`: así armás una ficha tipo "18.1 puntos y 32.9 minutos por partido" en una sola llamada. Con `by: "team"` rankea EQUIPOS por anotación en vez de jugadores: puntos a favor, en contra o diferencia, por partido. Ese número se calcula de los marcadores, no de la tabla oficial (que no trae esas columnas). Con `aggregation: "per_game"` los números son promedios y se aplica un mínimo de partidos; subilo con `minGames` si querés ser más estricto. Con `withContext: true` viene además la media del ámbito, que es lo que permite decir si un número es alto (cuesta una segunda pasada sobre el ámbito). El ámbito es OPCIONAL: sin categoryId, phaseId, groupId, team ni fechas rankea la temporada entera, que sale de un resumen recalculado cada noche en vez de leerse del acta. Lo único que no se puede es una ventana de más de 31 días sin categoría: leería cada línea de acta que existe. Vale igual con by: "team". Para "los goleadores de ayer", "del fin de semana", "de este mes" o "de la temporada" hacé UNA sola llamada, con el preset que corresponda (o from/to, o sin fechas para la temporada) y SIN categoría: trae el ranking de todas las categorías juntas y sale mucho más barato que una llamada por categoría. La respuesta mezcla categorías, así que decilo al contarla. Si el usuario nombró una categoría, o la pregunta es de un torneo puntual, pasá su categoryId (list_catalog lo lista): los rankings y las tablas son por categoría y no se comparan entre sí. Si no nombró ninguna, no se la preguntes ni la adivines: contestá con la llamada sin categoryId y aclará la mezcla. No reutilices un categoryId de otra pregunta sin confirmarlo. Do NOT use para la ficha de UN jugador (usá player_stats) ni para la tabla de posiciones (standings). Read-only.

leaders