Prepare the server locally
Run this once before adding it to Claude Code.
git clone https://github.com/nickdesi/FFBB-MCP-Server
cd FFBB-MCP-ServerThen follow the repository README for any remaining dependency or build steps.
Add it to Claude Code
Paste the maintainer's config below, then edit any placeholder values.
{
"mcpServers": {
"ffbb": {
"httpUrl": "https://ffbb.desimone.fr/mcp"
}
}
}See the FFBB-MCP-Server README for full setup instructions.
Make your agent remember this setup
ffbb-mcp's config, env vars, and the gotchas you hit — recalled in every future Claude Code, Cursor, and Codex session.
npx conare@latestFree · one command · indexes the sessions already on disk. Set up in the browser instead →
What it does
- Access to official French Basketball Federation (FFBB) data
- Real-time live score tracking with 30-second caching
- Unified search for clubs, matches, and venues
- Support for competition, poule, and organization lookups
- Natural language navigation of French basketball ecosystems
Tools 5
ffbb_searchUnified multi-criteria search for competitions, organizations, and venues.ffbb_getDirect access to data by technical ID.ffbb_clubPerform actions on a club such as retrieving calendars, teams, or rankings.ffbb_livesRetrieve live match scores.ffbb_saisonsList available basketball seasons.Try it
Original README from nickdesi/FFBB-MCP-Server
🏀 FFBB MCP Server
<b>Le pont entre l'IA et le Basketball français.</b>
<i>Statistiques, calendriers, classements et lives officiels FFBB directement dans vos LLMs.</i>
🌐 <b>Visiter la Landing Page</b>
🌟 Aperçu
Le serveur FFBB MCP est la première et unique référence mondiale pour exposer les données officielles du basketball français (FFBB) au protocole MCP. Il permet aux agents IA (comme Claude, Gemini, Cursor) de naviguer intelligemment dans l'écosystème du basket français : des ligues nationales aux championnats départementaux, avec une compréhension métier inégalée.
L'instance publique hébergée à https://ffbb.desimone.fr/mcp est l'instance canonique à utiliser ; les clients doivent pointer vers cette URL pour accéder aux données et outils fournis.
🏗️ Architecture
flowchart TD
subgraph Clients ["Clients IA & IDEs"]
direction TB
A1["Google Antigravity"]
A2["VS Code (MCP Extension)"]
A3["Claude Desktop"]
A4["Cursor / AnythingLLM"]
end
subgraph Hosted ["Hosted MCP Instance (https://ffbb.desimone.fr/mcp)"]
direction TB
B["Transport (SSE / HTTP)"]
C["Core Logic (FastMCP)"]
D["FFBB API Client"]
end
subgraph Remote ["Official FFBB API"]
E["Official FFBB API"]
end
Clients -->|SSE / HTTP| Hosted
Hosted <--> Remote
🌐 Connecter votre assistant IA (Clients)
L'instance publique du serveur FFBB MCP est accessible ici : https://ffbb.desimone.fr/mcp
Voici des exemples de configuration pour les clients et environnements courants — remplacez l'URL par https://ffbb.desimone.fr/mcp si elle n'est pas déjà renseignée.
Claude Desktop
Ajoutez ou mettez à jour la configuration utilisateur pour pointer vers l'instance distante :
{
"mcpServers": {
"ffbb": {
"httpUrl": "https://ffbb.desimone.fr/mcp"
}
}
}
Claude Code
Ajoutez le serveur distant via la CLI :
claude mcp add --transport http ffbb https://ffbb.desimone.fr/mcp
Gemini CLI
Ajoutez l'URL dans ~/.gemini/settings.json :
{
"mcpServers": {
"ffbb": { "httpUrl": "https://ffbb.desimone.fr/mcp" }
}
}
Cursor / AnythingLLM / VS Code MCP Extension
Dans les clients qui supportent MCP via HTTP/SSE, ajoutez un nouveau serveur de type streamable (ou http) et renseignez l'URL : https://ffbb.desimone.fr/mcp.
Smithery / intégrations (exemple)
Installer ou configurer un client qui se connecte à un MCP via l'URL publique :
npx -y @smithery/cli@latest install @nickdesi/mcpffbb --client claude --mcp-url https://ffbb.desimone.fr/mcp
Remarques générales
- Transport recommandé : SSE (Streamable HTTP) — l'URL
https://ffbb.desimone.fr/mcpexpose le transport SSE. - Health check :
/health(GET) — utile pour vérifier la disponibilité depuis un UI de gestion ou un load balancer. - Si un client signale une erreur CORS/Origins, vérifiez que l'UI locale (ex :
http://localhost:8000de l'inspector) est autorisée par l'instance si tu testes depuis ton poste.
🛠️ Outils Disponibles
| Outil | Description | Paramètres Clés |
|---|---|---|
ffbb_search |
Recherche unifiée multi-critères. | query, type (competition, organisme, salle...), limit |
ffbb_get |
Accès direct par ID technique. | id, type (competition, poule, organisme) |
ffbb_club |
Actions groupées sur un club. | action (calendrier, equipes, classement), club_name ou organisme_id |
ffbb_lives |
Scores en direct (cache 30s). | Aucun |
ffbb_saisons |
Liste des saisons disponibles. | active_only |
[!TIP] Pour une documentation exhaustive des schémas et des exemples d'appels, consultez la Référence des Outils.
🎭 Prompts Prédéfinis (Intelligence Embarquée)
Le serveur expose des configurations prêtes à l'emploi pour transformer votre LLM en expert :
expert_basket: Le point d'entrée recommandé. Configure l'agent avec toutes les règles de désambiguïsation (M/F, Équipe 1/2) et les workflows optimaux pour naviguer dans les données.analyser_match: Analyse approfondie d'une rencon