FFBB

Provides real-time FFBB data access for AI assistants via MCP, including calendars, live scores, results, and standings.

python

0

GitHub Stars

python

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "nickdesi-ffbb-mcp-server": {
      "command": "python",
      "args": [
        "-m",
        "ffbb_mcp"
      ]
    }
  }
}

You harness the FFBB MCP Server to give your AI agents direct, real-time access to the French Basketball Federation data, including calendars, live scores, standings, and results, enabling natural interactions and up-to-date information for decision making and planning.

How to use

To use the FFBB MCP Server, connect your MCP client to the local or remote MCP endpoint and start querying the available semantic tools. You can search clubs, arenas, and competitions, fetch calendars and match results for any team, and retrieve live scores for real-time decision making. Rely on the server’s intelligent filtering to refine results before you request specific data like a team’s poule or a competition standing.

How to install

Prerequisites: Python 3.8+ and a Python virtual environment tool (venv is included with Python). Ensure you have network access to install dependencies.

1. Clone the repository and prepare the environment

# 1. Clone the repo
git clone https://github.com/nickdesi/FFBB-MCP-Server.git
cd FFBB-MCP-Server

# 2. Setup a virtual environment
python -m venv .venv
source .venv/bin/activate

# 3. Install the package in editable mode
pip install -e "."

2. Run the MCP server locally

Start the server so your MCP clients can connect and issue data requests.

python -m ffbb_mcp

3. Test the MCP connection (optional)

You can quickly verify the setup by invoking the MCP inspector tool to run the server module in test mode.

# In a separate shell, or via npx inspector if available
npx @modelcontextprotocol/inspector python -m ffbb_mcp

Available tools

ffbb_get_lives

Fetch real-time live scores for ongoing matches.

ffbb_multi_search

Perform a global search across clubs, arenas, and competitions to locate relevant entities.

ffbb_get_organisme

List teams within an organization and retrieve associated data.

ffbb_get_poule

Retrieve league poules and groupings for a selected competition or organism.