FirstCycling MCP Server

FirstCycling provides rich access to professional cycling data from the FirstCycling website. It allows you to retrieve detailed information about professional cyclists, race results, historical data, and team information. With this integration, you can analyze rider performance, explore race histories, compare cyclists' careers, and access comprehensive statistics about the world of professional cycling. The tools cover everything from Grand Tours and Monument classics to rider career progression and team histories.

Overview

FirstCycling is a comprehensive data source for professional cycling information. This integration allows Claude to access and analyze data from FirstCycling, providing insights about riders, races, teams, and historical cycling data.

Installation

Prerequisites

Python 3.10 or higher
uv package manager (recommended)

Setup Instructions

Clone the repository:

git clone https://github.com/r-huijts/firstcycling-mcp.git
cd firstcycling-mcp

Create and activate a virtual environment:

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

Install dependencies:

uv pip install -e .

Integration with Claude

To integrate this server with Claude for Desktop, edit your Claude for Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Add the following to your configuration:

"mcpServers": {
  "firstcycling": {
    "command": "uv",
    "args": [
      "--directory",
      "PATH_TO_FIRSTCYCLING_DIRECTORY",
      "run",
      "mcp",
      "dev",
      "firstcycling.py"
    ]
  }
}

Replace PATH_TO_FIRSTCYCLING_DIRECTORY with the actual path to where you cloned the repository.

Usage Examples

Rider Analysis

"How has Tadej Pogačar performed in the Tour de France over the years?"
"Show me the team history and career progression of Wout van Aert."
"What are Mathieu van der Poel's results in Monument classics?"
"List all WorldTour victories for Jonas Vingegaard."

Race Research

"Show me the results of the 2023 Paris-Roubaix."
"Who are the youngest and oldest winners of the Tour of Flanders?"
"Get the startlist for the 2023 Tour de France with detailed team information."
"Show me the victory table for Liège-Bastogne-Liège. Who has won it the most times?"

Sports Journalism

"Create a detailed profile of Remco Evenepoel for a cycling magazine article."
"Write a preview for the upcoming Tour de France based on the recent results of top contenders."
"Analyze the evolution of Tom Pidcock's career based on his race results and team history."

Development Mode

For testing the server with MCP Inspector, run:

uv run mcp dev firstcycling.py

This will start the server and open the MCP Inspector in your browser, allowing you to test the available tools.

FirstCycling MCP Server

get_rider_info

get_rider_best_results

get_rider_grand_tour_results

get_rider_monument_results

get_rider_team_and_ranking

get_rider_race_history

get_rider_one_day_races

get_rider_stage_races

get_rider_teams

get_rider_victories

get_race_results

get_race_overview

get_race_stage_profiles

get_race_startlist

get_race_victory_table

get_race_year_by_year

get_race_youngest_oldest_winners

get_race_stage_victories

search_rider

search_race