Informations de version et configuration runtime du serveur FFBB MCP.

Retourne une structure compacte et strictement typée, pratique pour les agents et les outils de supervision.

Recherche FFBB — clubs, compétitions, matchs, salles, tournois, etc.

type='all' → recherche globale (meilleur point d'entrée). type='organismes' → clubs uniquement. type='competitions' → compétitions uniquement. Résultats contiennent un 'id' à utiliser avec ffbb_get ou ffbb_club.

Bilan complet d'une équipe toutes phases confondues en UN seul appel.

⚡ C'est l'outil à utiliser en priorité pour toute question de type "quel est le bilan de X cette saison ?" ou "résultats de U11M1".

Encapsule en interne : recherche club → équipes → classements de toutes les phases en parallèle → agrégation V/D/N et paniers marqués/encaissés.

Retourne :

• bilan_total : total V/D/N, paniers marqués/encaissés, différence

• phases : détail par compétition/phase (position, V/D/N, paniers)

Recupere une ressource FFBB par identifiant.

• type="competition" equivaut a get_competition.

• type="poule" charge la poule (classements + rencontres).

• type="organisme" charge les details d'un club.

⚠️ Attention: type="poule" peut être tronqué si la poule est grande. Pour un calendrier exhaustif, préférez ffbb_club(action="calendrier").

Avertissement: ne pas utiliser pour obtenir un score ou un prochain match. Utiliser ffbb_last_result et ffbb_next_match a la place.

Outils agreges autour d'un club (calendrier, equipes, classement).

✅ Outil de référence pour toute demande au pluriel : "matchs restants", "derniers matchs à jouer", "prochaines journées", "calendrier de fin de saison".

⚡ action="calendrier" est l'outil le plus fiable pour obtenir TOUTES les rencontres passées et futures d'une équipe/catégorie, sans les limitations de ffbb_get(poule).

Avertissement: ne pas utiliser pour obtenir un score ou un prochain match d'une equipe specifique. Utiliser ffbb_last_result et ffbb_next_match a la place.

Matchs en cours (scores live, cache 30s). Retourne [] si aucun match.

Liste des saisons FFBB. active_only=True pour la saison en cours uniquement.

Identifie une equipe unique (Pivot central).

DOIT etre utilise avant ffbb_next_match ou ffbb_last_result si l'agent ne connait pas le numero d'equipe exact ou si la categorie est ambiguë (ex: 'U11M').

Résumé complet et agent-friendly pour une équipe.

Combine en UN seul appel :

• bilan global (toutes phases)

• phase courante et son classement

• dernier match joué

• prochain match à venir

Recommandé pour une vue rapide d'une équipe précise. Si la catégorie est ambiguë ou sans numéro d'équipe, l'outil tente une résolution via ffbb_resolve_team. Pour une liste de matchs restants, utiliser plutôt ffbb_club(action="calendrier").

Dernier résultat d'une équipe précise.

SINGULIER UNIQUEMENT: retourne le dernier match joué d'une seule équipe. Recommendation LLM : Si la categorie est imprécise ou sans numéro (ex: 'U11M'), appeler d'abord ffbb_resolve_team pour obtenir le numero_equipe reel.

Prochain match à jouer pour une équipe précise.

⚠️ SINGULIER UNIQUEMENT. Si la demande est au pluriel ("matchs restants", "derniers matchs à jouer", "calendrier"), utiliser ffbb_club(action="calendrier") à la place.

⚠️ ATTENTION LLM : Cet outil retourne STRICTEMENT LE PROCHAIN MATCH UNIQUE. Ne l'utilise JAMAIS si l'utilisateur demande "les prochains matchs" au pluriel. Pour toute requête au pluriel, utilise OBLIGATOIREMENT ffbb_club(action="calendrier") et filtre les résultats toi-même.

Recommendation LLM : Si la categorie est imprécise ou sans numéro (ex: 'U11M'), appeler d'abord ffbb_resolve_team pour obtenir le numero_equipe reel.

Bilan détaillé de la saison pour une équipe précise (toutes phases).

Cet outil est optimisé pour les questions du type "Quel est le bilan de la saison des U11M1 ?".

Il agrège toutes les phases (toutes poules) de la saison FFBB pour l'équipe identifiée par (organisme_id, categorie, numero_equipe).

Pour chaque phase, il retourne :

• competition

• poule_id

• position

• match_joues, gagnes, perdus, nuls

• paniers_marques, paniers_encaissés, difference

Et fournit également un champ bilan_total qui cumule toutes les phases.