head_to_head
ChatGPTReturns the archived games between two Uruguayan teams or clubs, with the win-loss balance and each game's score; read-only. Use when el usuario pregunta cómo le fue a un equipo contra otro, o el historial, los antecedentes o el balance entre dos equipos o clubes. Acepta el nombre del equipo o el de su club: si un club juega con otro nombre en alguna categoría, vienen todos. Do NOT use para UN partido descripto con palabras (search), para la tabla (standings) ni para el acta de un partido (match_report): con el matchId, andá derecho a match_report. Cada partido trae su localDay, su CATEGORÍA, su matchId y su url. Dos clubes se cruzan en varias categorías: el texto abre con el balance de la principal (mayores) y da cada otra aparte, ya calculado. Usá el de la categoría preguntada; NO cuentes vos de la lista. Los balances son sobre TODOS los partidos del cruce aunque la lista venga recortada; un suspendido no cuenta. La racha vigente viene contada, con el partido que la corta: no hables de otra racha. Lista hasta 200 partidos (default 50), desde el primer año que el archivo tiene de esa liga.
leaders
ChatGPTRanks players by any archived statistic of Uruguayan basketball (totals, per-game averages or best single game, one season or all-time), or teams by record and scoring; read-only. Use when piden los mejores, top o líderes: goleadores, quién promedia más, el mejor +/-, triplistas. Default: temporada vigente. Cada liga publica sólo algunas estadísticas (list_catalog); pedir otra vuelve INVALID_INPUT. Varias en stats salen juntas; sortBy elige el orden. SIEMPRE UNA llamada: sin categoryId junta todas las categorías (decí que mezcla); con preset o from/to (hasta 31 días sin categoría) es "de ayer", "del finde", "del mes". No hagas una llamada por categoría, división ni año. Un año = categoryId + from/to (una temporada puede cruzar años). Si la ventana de una categoría viene vacía, la respuesta dice su último día jugado: pedí ese día, no recorras. Si nombraron una categoría pasá su categoryId (list_catalog; si el nombre se repite, la PRINCIPAL); si no nombraron ninguna, no preguntes. aggregation: total, per_game (promedio, con mínimo minGames) o best_game (la mejor marca en UN partido, con rival y día; con categoryId o una ventana). by: "team": equipos con ganados y perdidos (won, lost) y puntos a favor y en contra de TODOS los partidos del ámbito (no la tabla oficial). "¿Quién sigue invicto?" = teamOrder: "lost"; "en todas las divisiones" o "en el año" es UNA llamada sin categoryId, y cada fila dice sus categorías. allSeasons: true: ranking HISTÓRICO ("de todos los tiempos", "desde tal año"; "quién jugó más partidos" = sortBy: "games"), sumando temporadas y categorías; acotá con category, fromYear, toYear. lastRound: true: "el goleador de la última fecha"; el server resuelve la fecha de cada categoría (categoryId, categoryIds o todas las vigentes de leagues) y trae su último partido, aunque sea de hace meses. withContext: true suma la media del ámbito. Do NOT use para la ficha de UN jugador (player_stats) ni la tabla (standings).
list_catalog
ChatGPTLists the leagues, seasons and categories in the Mi Basket archive of Uruguayan basketball with their ids, and which statistics each league publishes; read-only. Use when necesitás un categoryId para leaders o standings, cuando preguntan qué categorías o temporadas hay, o antes de prometer una estadística. Llamalo PRIMERO si vas a pedir rankings, fichas o tablas y no tenés el categoryId. Un mismo nombre ("U16 Masculino") puede ser la categoría federal y las de ligas regionales: si el usuario no dijo cuál, usá la marcada PRINCIPAL sin preguntarle y aclaralo al responder. Si una categoría no aparece en la liga por defecto, la respuesta busca en las otras y dice en cuál está. Do NOT use para buscar jugadores (search_player). Las categorías son de la liga por defecto salvo leagues, y de la temporada vigente salvo seasonId. Con query, sólo las que matchean por nombre de categoría o competencia, y sólo lo que publican las ligas en alcance; sin query, además, la guía de cada liga.
match_report
ChatGPTReturns the full box score of one archived Uruguayan game, with quarter scores, both team lines and an optional play-by-play; read-only. Acta COMPLETA en UNA llamada: marcador, parciales por cuarto y las líneas de ambos equipos (puntos, libres, dobles, triples, faltas y valoración; rebotes, asistencias, tapones, robos, pérdidas e intentos de cancha sólo si la liga del partido los publica). Use when el usuario pide el resultado, el relato, el resumen o el detalle por cuarto de un partido, o "contame el último partido de X". Pasá matchId, O personId para tomar su ÚLTIMO partido y resaltar su línea sin encadenar dos llamadas. Los parciales son Q1..Q4 y TE (tiempo extra): NO hables de un "quinto cuarto". Con plays: true viene el relato JUGADA A JUGADA (quién anotó, el cuarto, el reloj y el marcador tras cada canasta): permite contar "el triple que dio vuelta el partido" sin inventarlo. Son unas 70 jugadas: pedilo para relatar, no para un resultado. El marcador de las jugadas ya está reconstruido desde 0-0: no lo recalcules. Si playsReconcile es false, el play-by-play está incompleto: decilo y no afirmes rachas ni momentos. Trae la url del partido, la de cada jugador del acta y el localDay. Para el historial entre dos equipos, head_to_head.
my_follows
ChatGPTLists the clubs, teams, players and whole leagues that the signed-in user follows in their Mi Basket account, with their ids and links; that list is not part of the conversation; read-only. Use when the user refers to "my team", "my son", "los míos", asks whom they follow, or asks about their favorites without naming them; then the other tools take the ids it returns. Una liga seguida trae el id que va en leagues. Do NOT use para buscar a alguien que no sigue (search_player) ni para cambiar sus favoritos: no escribe nada. Sin kind trae todo; con kind, solo clubes, equipos, jugadores o ligas.
player_history
ChatGPTReturns a player's career across archived seasons of Uruguayan basketball: teams, categories, games played and scoring averages, with identity confidence; read-only. 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 o desambiguar (search_player da el personId) ni para el acta de UN partido (match_report). Para promedios y minutos, player_stats. Trae la url de su ficha, de cada equipo y de cada partido. Responde sobre la liga del personId, desde el primer año que el archivo tiene de esa liga.
player_stats
ChatGPTReturns archived statistics of Uruguayan basketball for one or more players, as totals, per-game averages and best game, broken down by category and competition; read-only. Use when el usuario pregunta cómo viene un jugador, cuánto promedia, cuántos minutos juega, su mejor partido, o quiere COMPARAR jugadores (varios personId en una llamada). stats: las del enum; default puntos, minutos, valoración y +/-. Las que la liga del jugador no publica no vienen, y la respuesta lo avisa. Los personId salen de search_player o de leaders; responde sobre la liga de cada uno. Acotá con categoryId, seasonId o from/to ("cómo viene en las últimas fechas"). La ficha de un jugador va SIN year: cada categoría trae su temporada entera, con sus días. Pasá year solo si la pregunta nombra un año ("este año", "en 2025"): corta en el año calendario y una temporada puede cruzarlo. Cada número viene con los partidos que tenían el dato: "sobre 12 de 14 PJ" es un promedio sobre 12, y hay que decirlo así. Cada jugador trae la url de su ficha. Do NOT use para rankings de una categoría (leaders) ni para el acta de un partido (match_report).
schedule
ChatGPTLists fixtures and results of Uruguayan basketball from the Mi Basket archive for a date range, preset, team, club or category, with local time, venue, status and score; read-only. Use when preguntan qué se juega hoy, mañana, el finde o una fecha; a qué hora y dónde juega un equipo; qué partidos hubo; los últimos de un equipo. Fechas relativas ("hoy", "el finde", "la semana pasada", "este mes"): SIEMPRE preset, no calcules fechas (el server dice cuáles usó); from/to sólo para fechas explícitas. El listado llega a 92 días (un rango más largo se recorta y lo avisa). Para CONTAR partidos de una temporada o un año, UNA llamada con summary: true y el rango completo (hasta 400 días): separa los JUGADOS de los programados; no sumes a mano. UNA llamada con el rango trae TODOS sus partidos: no la repitas por equipo ni por fecha. Los últimos partidos de un equipo ("cómo viene X"): team + lastPlayed: 5, sin fechas. Un club mezcla sus equipos: sin category ni level el server usa su equipo principal de mayores y dice cuál; decilo vos también. Si el equipo no jugó en el rango ("anoche"), trae su último partido: decí que no jugó y contá ese. Cada partido trae matchId (para match_report), phaseId (para acotar leaders y player_stats) y su url. Do NOT use para el acta de un partido (match_report), la tabla (standings) ni UN partido descripto con palabras sin equipo ni fecha (search).
search
ChatGPTSearches matches of Uruguayan basketball in the Mi Basket archive by free text (teams, category, venue, a spoken day) and returns each match with its id, date and link; read-only. Use when el usuario describe UN partido con palabras y no tenés el equipo exacto ni la fecha: la cancha, un apodo, la categoría, "el del sábado". Tolera acentos y nombres mal escritos que suenan igual. Do NOT use para el historial o el balance entre dos equipos (head_to_head), para el calendario de una fecha o de un equipo (schedule), para personas (search_player) ni para la tabla (standings). Cada partido trae matchId (para match_report) y su url. Máx. 50 resultados (default 20), primero los que nombran lo buscado en el título y entre ellos los más cercanos a hoy.
search_player
ChatGPTSearches people in the Uruguayan basketball archive by name and returns matching candidates with their opaque person id, their teams and identity confidence; read-only. 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 (leaders), para la ficha de un jugador (player_stats) ni para el acta de un partido (match_report). Cada candidato trae la url de su ficha y la de su equipo. Máx. 100 resultados (default 25). Pasá el personId a player_history, player_stats o match_report.
service_status
ChatGPTReports that this Mi Basket MCP server is up and which version it runs, not the status of the upstream data sources; read-only. Use when el usuario pregunta si el servicio anda, qué versión corre, o para verificar la conexión. Do NOT use para datos de básquet.
standings
ChatGPTReturns the official league table of a Uruguayan category or group, with position, wins, losses, table points and win rate per team; read-only. Use when el usuario pregunta por la tabla, las posiciones, quién va primero o último, cómo está un equipo o EN QUÉ GRUPO juega. Es la tabla de UNA fase (la respuesta dice cuál, y en phases qué otras tuvo la temporada); otra se pide con phaseId. El récord de la temporada entera, o el de una fase sin tabla, sale de leaders con by:"team". Pasá team y viene DIRECTO su grupo con la tabla completa: es el camino corto para "cómo está" un equipo. Sin team ni groupId trae las tablas de la fase vigente (cada grupo aparte) y fecha las otras fases; si no entran, los grupos para elegir. El groupId acota también un ranking de jugadores (leaders.groupId). Cada equipo trae la url de su página. Con order: "win_rate" es el ranking de la categoría por porcentaje de victorias, sobre las fases con tabla. Quién anota más por partido: leaders con by: "team". Si no nombró la categoría, usá la competencia principal de la liga (la guía por liga de las instrucciones dice cuál) y decilo al responder. Do NOT use para rankings de jugadores (leaders) ni para el acta de un partido (match_report).
team
ChatGPTReturns a Uruguayan team profile: its roster with per-player averages, its record by tournament phase and its scoring; read-only. Use when el usuario pregunta quiénes juegan en un equipo, 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) y, si sabés la categoría, pasala en category: con un solo equipo viene la ficha directo. Si matchea VARIOS vienen todos con su categoría y su teamId (un club tiene un equipo por categoría). La plantilla trae el personId de cada jugador (para player_stats o player_history); el teamId sirve para volver a llamar sin ambigüedad. El récord y la posición salen de la tabla OFICIAL, UNA FILA POR FASE (primera, segunda, playoff): sumar sus PJ da los partidos en la categoría. Los puntos a favor y en contra por partido salen de los marcadores. Do NOT use para el calendario del equipo (schedule con team), la tabla de su grupo (standings) ni rankings de jugadores (leaders).
