Donnez à vos assistants IA la connaissance du basket français.
Résultats, calendriers, classements de poules, fiches de clubs, scores en direct et règlements officiels FFBB (RSG, calculs de départage, textes fédéraux, régionaux et comités) : tout le basket français (5x5 classique et 3x3, du niveau départemental jusqu'à l'Élite) accessible en langage naturel depuis vos éditeurs et assistants IA (Cursor, Claude Desktop, VS Code Copilot, Google Antigravity).
« Quel est le bilan et le prochain match de l'équipe 1 de Pau ? »
ffbb_team_summary :• Équipe : Élan Béarnais Pau-Lacq-Orthez (NM1)
• Bilan actuel : 3e de la poule B (14 Victoires - 4 Défaites)
• Dernier résultat : Victoire 82 - 76 vs Dax Gamarde
• Prochain match : Samedi 20h00 à domicile vs Tours
17 Outils pour explorer tout le basket français & ses règlements
Votre assistant IA sélectionne automatiquement le meilleur outil pour vous répondre avec une précision totale.
ffbb_team_summary
Le résumé ultime en un seul appel : bilan complet de la saison, position au classement, forme récente, dernier résultat et prochain match.
ffbb_next_match
Détails complets de la prochaine rencontre programmée : date, horaire, adversaire et gymnase résolu avec adresse exacte.
ffbb_last_result
Feuille de match officielle et score précis du dernier match disputé par une équipe.
ffbb_lives
Scores en direct, quarts-temps et statut des matchs en cours le week-end sur l'ensemble des divisions françaises.
ffbb_bilan
Bilan exhaustif d'une équipe : victoires, défaites, points marqués, points encaissés et goal-average.
ffbb_bilan_saison
Synthèse approfondie des performances d'une équipe sur l'ensemble des phases d'une saison sportive.
ffbb_head_to_head
Face-à-face et historique des confrontations directes entre deux clubs ou équipes.
ffbb_club
Fiche administrative et sportive d'un club : coordonnées, gymnase principal, calendrier des matchs et équipes engagées.
ffbb_search
Recherche universelle rapide multi-index : clubs, compétitions, tournois 3x3, gymnases et arbitres.
ffbb_resolve_team
Désambiguïsation intelligente pour identifier une équipe unique et sa poule à partir d'un nom ou d'un club.
ffbb_get
Extraction brute et directe d'entités FFBB par identifiant (organismes, poules, rencontres, terrains 3x3).
ffbb_saisons
Consultation de la liste des saisons sportives disponibles et historiques de la FFBB.
ffbb_version
Informations sur la version active du serveur MCP, le transport et l'état de l'infrastructure.
ffbb_search_regulations
Recherche plein texte déterministe (FTS5) dans les règlements officiels FFBB (RSG), règlements particuliers, ligues et comités avec fallback fédéral.
ffbb_get_regulation_article
Récupération intégrale et exacte du texte d'un article spécifique (Art. 28, Art. 51, etc.) pour une citation réglementaire sans troncature.
ffbb_explain_tiebreak_rules
Calcul et explication des règles officielles de départage en cas d'égalité selon l'Article 28 du RSG FFBB (goal-average particulier et quotient).
ffbb_list_regulations
Catalogue exhaustif de tous les textes réglementaires fédéraux (RSG, NM1-NM3, LF2-NF3, U15/U18 Élite), ligues régionales et comités départementaux.
Connectez votre client IA préféré
Ajoutez l'URL Streamable HTTP officielle dans votre configuration et commencez immédiatement à poser vos questions.
// Dans .cursor/mcp.json ou Paramètres > Features > MCP
{
"mcpServers": {
"ffbb": {
"url": "https://ffbb.desimone.fr/mcp"
}
}
}Deux briques dédiées : Serveur MCP & API REST
Le serveur MCP (ffbb.desimone.fr) et l'API REST officielle (ffbb-api.desimone.fr) sont deux services distincts et complémentaires propulsés par le SDK Python ffbb-data-client.
FFBB MCP Server
Dédié exclusivement aux assistants IA & LLMs (Claude, Cursor, VS Code Copilot, Antigravity). Expose 17 outils standardisés avec agrégation intelligente et un moteur de recherche réglementaire SQLite FTS5.
- Protocole Streamable HTTP / SSE standard
- Scores live, calendriers, classements & bilans
- Règlements officiels FFBB, régionaux et comités
FFBB Data Client (API & SDK)
Dédié aux développeurs d'applications web, mobiles et scripts (ex. SCBA Bénévolat). Fournit une API REST FastAPI OpenAPI/Swagger et un package Python sur PyPI.
- Documentation interactive Swagger & OpenAPI
- Endpoints directs pour clubs, matchs et classements
- SDK Python asynchrone et typé Pydantic v2
# Installation via pip pour vos projets et scripts Python
pip install ffbb-data-client
# Utilisation rapide en Python (async ou synchrone)
from ffbb_data_client import FFBBDataClient
# Résolution automatique des accès et initialisation du client
client = FFBBDataClient.create()
# Recherche globale multi-index (clubs, compétitions, gymnases)
results = client.multi_search("Stade Clermontois")
# Récupération des scores live en direct le week-end
lives = client.get_lives()
for match in lives or []:
print(f"{match.equipe_domicile} vs {match.equipe_exterieur} : {match.score_domicile}-{match.score_exterieur}")Transparence & État du Service
Suivez les métriques de trafic, l'efficacité du cache et l'état des connexions en temps réel.
📊 Dashboard Visuel
Visualisez les requêtes par seconde, le hit ratio du cache et les outils les plus appelés.
📈 Métriques JSON
Endpoint automatisé au format JSON pour Prometheus, Grafana ou supervision externe.
❤️ État de Santé
Health check en direct validant la connectivité Directus et Meilisearch.
Questions fréquentes
Tout ce que vous devez savoir pour démarrer et comprendre l'écosystème FFBB MCP & API.
Il suffit d'ajouter l'URL https://ffbb.desimone.fr/mcp dans votre client MCP (Cursor, Claude Desktop, Copilot, Antigravity). Votre IA saura automatiquement utiliser les 17 outils spécialisés pour vous répondre.
Oui ! Le serveur intègre un moteur réglementaire FTS5 complet (saison 2026-2027) couvrant les Règlements Sportifs Généraux (RSG), les règlements particuliers (NM1-NM3, LF2-NF3, U15/U18 Élite), les ligues régionales (IDF, HDF, AURA) et les comités départementaux (75, 59, 69, 63, 03). L'outil ffbb_explain_tiebreak_rules applique rigoureusement l'Article 28 du RSG pour résoudre les égalités.
ffbb.desimone.fr est le serveur MCP conçu exclusivement pour les LLMs (Claude, Cursor, Copilot) avec des outils d'agrégation haut niveau. ffbb-api.desimone.fr est l'API REST dédiée aux développeurs et applications tierces (comme SCBA Bénévolat), disponible aussi sous forme de SDK Python via pip install ffbb-data-client.
Vous pouvez demander le classement d'une poule, le prochain match d'une équipe, le résumé complet de saison d'un club, les gymnases à proximité ou les scores des matchs en direct le week-end sur toutes les divisions (Départemental, Régional, National, Élite).
Non ! L'instance publique https://ffbb.desimone.fr/mcp est hébergée et prête à l'emploi en Streamable HTTP. L'installation Python n'est requise que si vous souhaitez développer votre propre code avec la bibliothèque ffbb-data-client.
Oui, toutes les données proviennent directement des flux officiels de la Fédération Française de BasketBall via le moteur ffbb-data-client avec une actualisation en direct pour les scores du week-end.