FirstCycling

You run a FirstCycling MCP Server to access professional cycling data via an MCP client. This server exposes rider, race, and historical data through a set of tools you can call from your MCP client, enabling practical data-driven analyses and journalism workflows.

How to use

Start the server in development mode to test with the MCP Inspector. From your project directory, run uv run mcp dev firstcycling.py to launch the server and open the MCP Inspector in your browser. Use the available tools to fetch rider profiles, race results, and stage data, then combine them in your queries for insights like rider performance trends, team histories, and Monument results.

How to install

Prerequisites you need before installing:

• Python 3.10 or higher
• uv package manager (recommended)
• Internet access to install dependencies Then follow these concrete steps to set up the MCP server locally:

uv venv
source .venv/bin/activate  # On macOS/Linux
# or
.venv\Scripts\activate  # On Windows

uv pip install -e .

Additional setup notes

If you want to test integration with Claude for Desktop, you can configure the MCP server entry in your Claude settings to point to the local server. Use the development start command shown above to ensure the server is running, then verify the connection from Claude using the provided configuration snippet that includes the uv command and appropriate arguments.

Tools overview

The server provides a comprehensive set of tools to access rider and race data. You can query rider biographies, best results, grand tour results, Monument results, team histories, and race-specific details such as startlists, stage profiles, and victory tables. These tools are designed to support rider analysis, race research, sports journalism, and cycling education.

Available tools

get_rider_info

Get basic biographical information about a rider including nationality, birthdate, weight, height, and current team

get_rider_best_results

Retrieve a rider's best career results, sorted by importance

get_rider_grand_tour_results

Get a rider's results in Grand Tours (Tour de France, Giro d'Italia, Vuelta a España)

get_rider_monument_results

Retrieve a rider's results in cycling's Monument classics

get_rider_team_and_ranking

Get a rider's team history and UCI ranking evolution over time

get_rider_race_history

Retrieve a rider's complete race participation history, optionally filtered by year

get_rider_one_day_races

Get a rider's results in one-day races, optionally filtered by year

get_rider_stage_races

Get a rider's results in multi-day stage races, optionally filtered by year

get_rider_teams

Retrieve the complete team history of a rider throughout their career

get_rider_victories

Get a list of a rider's career victories, with optional filters for WorldTour or UCI races

get_race_results

Retrieve results for a specific race edition by race ID and year

get_race_overview

Get general information about a race including history, records, and past winners

get_race_stage_profiles

Retrieve stage profiles and details for multi-stage races

get_race_startlist

Get the startlist for a specific race edition with detailed or basic team information

get_race_victory_table

Retrieve the all-time victory table for a race showing riders with most wins

get_race_year_by_year

Get year-by-year results for a race with optional classification filter

get_race_youngest_oldest_winners

Retrieve information about the youngest and oldest winners of a race

get_race_stage_victories

Get information about stage victories in multi-stage races