Mi Basket

Lists 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.

my_follows

Searches 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.

search_player

Searches 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

Lists 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).

schedule

Lists 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.

list_catalog

Reports 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.

service_status

Returns 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).

player_stats

Returns 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).

team

Returns 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_history

Returns 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.

head_to_head