Skip to main content
Glama
FirstCycling MCP Server

FirstCycling MCP Server

by r-huijts

FirstCycling MCP Server

This is a Model Context Protocol (MCP) server that provides professional cycling data from FirstCycling. It allows you to retrieve comprehensive information about professional cyclists, race results, race details, and historical cycling data.

Features

This MCP server offers rich access to professional cycling data, providing tools for:

  • Finding information about professional cyclists

  • Retrieving race results and details

  • Exploring historical race data

  • Analyzing rider performance and career progression

  • Accessing information about cycling teams and competitions

Related MCP server: Pitstop

Real-World Use Cases

With this MCP server, you can use Claude to:

Rider Analysis

  • Performance Tracking: "How has Tadej Pogačar performed in the Tour de France over the years?"

  • Career Progression: "Show me the team history and career progression of Wout van Aert."

  • Specialization Analysis: "What are Mathieu van der Poel's results in Monument classics?"

  • Victory Analysis: "List all WorldTour victories for Jonas Vingegaard."

  • Historical Comparison: "Compare the Grand Tour results of Primož Roglič and Jonas Vingegaard."

Race Research

  • Recent Results: "Show me the results of the 2023 Paris-Roubaix."

  • Historical Context: "Who are the youngest and oldest winners of the Tour of Flanders?"

  • Team Analysis: "Get the startlist for the 2023 Tour de France with detailed team information."

  • Race Statistics: "Show me the victory table for Liège-Bastogne-Liège. Who has won it the most times?"

  • Stage Information: "Can you show me the stage profiles for the 2023 Giro d'Italia?"

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 like Tadej Pogačar and Jonas Vingegaard."

  • "Analyze the evolution of Tom Pidcock's career based on his race results and team history."

Cycling Education

  • "Explain what makes the Monument classics special using data about their history and winners."

  • "Create an educational summary about Grand Tours and their significance in professional cycling."

  • "Describe the typical career progression of a professional cyclist using examples from the data."

Requirements

  • Python 3.10 or higher

  • uv package manager (recommended)

  • Dependencies as listed in pyproject.toml, including:

    • mcp

    • beautifulsoup4

    • lxml

    • pandas

    • slumber

    • and other packages for web scraping and data processing

Setup

  1. Clone this repository

  2. Create and activate a virtual environment:

    uv venv
    source .venv/bin/activate  # On macOS/Linux
    # or
    .venv\Scripts\activate  # On Windows
  3. Install dependencies:

    uv pip install -e .

FirstCycling API

This server uses the FirstCycling API, which has been integrated directly into the project. The API provides methods to fetch data from the FirstCycling website through web scraping.

MCP Tools

The server exposes the following tools through the Model Context Protocol:

Rider Information

Tool

Description

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

Race Information

Tool

Description

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

Search Tools

Tool

Description

search_rider

Search for riders by name, returning their IDs and basic information

search_race

Search for races by name, returning their IDs and basic information

Usage

Development Mode

You can test the server with MCP Inspector by running:

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.

Integration with Claude for Desktop

To integrate this server with Claude for Desktop:

  1. Edit the Claude for Desktop config file, located at:

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

    • Windows: %APPDATA%\Claude\claude_desktop_config.json

  2. Add the server to your configuration:

    {
      "mcpServers": {
        "firstcycling": {
          "command": "uv",
          "args": ["--directory", "/path/to/server/directory", "run", "firstcycling.py"]
        }
      }
    }
  3. Restart Claude for Desktop

License

MIT

Available Tools

18 tools
get_race_detailsA

Get comprehensive details about a cycling race. This tool provides detailed information about a specific race, including its history, key statistics, route details, and other relevant information. The data can be filtered by specific classification.

Note: If you don't know the race's ID, use the search_race tool first to find it by name.

Example usage:
- Get details for Tour de France (ID: 17)
- Get details for Paris-Roubaix (ID: 30)

Returns a formatted string with:
- Race name, country, and category
- Historical information and key statistics
- Course details and characteristics
- Optional classification details

Inputs: race_id (required), classification_num.

get_race_edition_resultsA

Get detailed results for a specific edition of a cycling race. This tool provides comprehensive results for a particular edition of a race, including rankings, time gaps, and other relevant statistics. Results can be filtered by classification or stage.

Note: If you don't know the race's ID, use the search_race tool first to find it by name.

Example usage:
- Get 2023 Tour de France general classification results (Race ID: 17, Year: 2023)
- Get 2022 Paris-Roubaix results (Race ID: 30, Year: 2022)
- Get results for stage 5 of 2023 Tour de France (Race ID: 17, Year: 2023, Stage: 5)

Returns a formatted string with:
- Race name, year, and category
- Complete result list with rankings and time gaps
- Rider names and teams
- Classification or stage specific information

Inputs: race_id (required), year (required), classification_num, stage_num.

get_race_victory_tableA

Get the all-time victory table for a cycling race. This tool provides a historical summary of the most successful riders in a specific race, showing the number of victories for each rider throughout the race's history.

Note: If you don't know the race's ID, use the search_race tool first to find it by name.

Example usage:
- Get victory table for Tour de France (ID: 17)
- Get victory table for Paris-Roubaix (ID: 30)

Returns a formatted string with:
- Race name
- List of riders with the most victories
- Number of victories for each rider
- Years of victories where available

Inputs: race_id (required).

get_rider_best_resultsA

Retrieve the best career results of a professional cyclist, including their top finishes in various races. This tool provides a comprehensive overview of a rider's most significant achievements throughout their career, including their highest positions in major races, stage wins, and overall classifications. Results are sorted by importance and include detailed information about each race.

Note: If you don't know the rider's ID, use the search_rider tool first to find it by name.

Example usage:
- Get top 10 best results for Tadej Pogačar (ID: 16973)
- Get top 5 best results for Jonas Vingegaard (ID: 16974)

Returns a formatted string with:
- Rider's name and career highlights
- Top results sorted by importance
- Race details including category and country
- Date and position for each result

Inputs: rider_id (required), limit.

get_rider_grand_tour_resultsA

Get comprehensive results for a rider in Grand Tours (Tour de France, Giro d'Italia, and Vuelta a España). This tool provides detailed information about a rider's performance in cycling's most prestigious three-week races, including their overall classification positions, stage wins, and special classification results. The data is organized chronologically and includes all relevant race details.

Note: If you don't know the rider's ID, use the search_rider tool first to find it by name.

Example usage:
- Get Grand Tour results for Tadej Pogačar (ID: 16973)
- Get Grand Tour results for Jonas Vingegaard (ID: 16974)

Returns a formatted string with:
- Results for each Grand Tour (Tour de France, Giro, Vuelta)
- Overall classification positions
- Stage wins and special classification results
- Time gaps and race details

Inputs: rider_id (required).

get_rider_infoA

Get comprehensive information about a professional cyclist including their current team, nationality, date of birth, and recent race results. This tool provides a detailed overview of a rider's current status and recent performance in professional cycling races. The information includes their current team affiliation, nationality, age, and their most recent race results with positions and times.

Note: If you don't know the rider's ID, use the search_rider tool first to find it by name.

Example usage:
- Get basic info for Tadej Pogačar (ID: 16973)
- Get basic info for Jonas Vingegaard (ID: 16974)

Returns a formatted string with:
- Full name and current team
- Nationality and date of birth
- UCI ID and social media handles
- Last 5 race results with positions and times
- Total number of UCI victories

Inputs: rider_id (required).

get_rider_monument_resultsA

Retrieve detailed results for a rider in cycling's five Monument races (Milan-San Remo, Tour of Flanders, Paris-Roubaix, Liège-Bastogne-Liège, and Il Lombardia). These are the most prestigious one-day races in professional cycling. The tool provides comprehensive information about a rider's performance in these historic races, including their positions, times, and any special achievements.

Note: If you don't know the rider's ID, use the search_rider tool first to find it by name.

Example usage:
- Get Monument results for Tadej Pogačar (ID: 16973)
- Get Monument results for Mathieu van der Poel (ID: 16975)

Returns a formatted string with:
- Results for each Monument race
- Position and time for each participation
- Race details and special achievements
- Chronological organization by year

Inputs: rider_id (required).

get_rider_one_day_racesA

Get a rider's results in one-day races, optionally filtered by year. This tool retrieves detailed information about a rider's performance in one-day races (classics and one-day events). It provides comprehensive data about positions, times, and race categories. Results can be filtered by a specific year.

Note: If you don't know the rider's ID, use the search_rider tool first to find it by name.

Example usage:
- Get one-day race results for Mathieu van der Poel (ID: 16672)
- Get 2023 one-day race results for Wout van Aert (ID: 16948)

Returns a formatted string with:
- Results in one-day races organized by year
- Position and time for each race
- Race category and details
- Chronological organization

Inputs: rider_id (required), year.

get_rider_race_historyA

Get the complete race history of a professional cyclist, optionally filtered by year. This tool retrieves a comprehensive list of all races the rider has participated in, including their positions, times, and race categories. It provides a detailed overview of their racing career.

Note: If you don't know the rider's ID, use the search_rider tool first to find it by name.

Example usage:
- Get complete race history for Tadej Pogačar (ID: 16973)
- Get 2023 race history for Jonas Vingegaard (ID: 16974)

Returns a formatted string with:
- All races organized by year
- Position and time for each race
- Race category and details
- Chronological organization

Inputs: rider_id (required), year.

get_rider_stage_racesA

Get a rider's results in stage races, optionally filtered by year. This tool retrieves detailed information about a rider's performance in stage races (multi-day races like Tour de France, Giro d'Italia, etc.). It provides comprehensive data about positions, times, and race categories. Results can be filtered by a specific year.

Note: If you don't know the rider's ID, use the search_rider tool first to find it by name.

Example usage:
- Get stage race results for Tadej Pogačar (ID: 16973)
- Get 2023 stage race results for Jonas Vingegaard (ID: 16974)

Returns a formatted string with:
- Results in stage races organized by year
- Position and time for each race
- Race category and details
- Chronological organization

Inputs: rider_id (required), year.

get_rider_team_and_rankingA

Get information about a professional cyclist's team affiliations and UCI rankings throughout their career. This tool retrieves the rider's team history and their UCI ranking points over time. It provides a comprehensive overview of their professional career progression through different teams and their performance in the UCI rankings.

Note: If you don't know the rider's ID, use the search_rider tool first to find it by name.

Example usage:
- Get team and ranking history for Tadej Pogačar (ID: 16973)
- Get team and ranking history for Jonas Vingegaard (ID: 16974)

Returns a formatted string with:
- Complete team history with years
- UCI ranking positions and points
- Career progression timeline
- Current team and ranking status

Inputs: rider_id (required).

get_rider_teamsA

Get a detailed history of a professional cyclist's team affiliations throughout their career. This tool provides a chronological list of all teams the rider has been part of, including years and team details.

Note: If you don't know the rider's ID, use the search_rider tool first to find it by name.

Example usage:
- Get team history for Peter Sagan (ID: 12345)
- Get career team changes for Chris Froome (ID: 67890)

Returns a formatted string with:
- Complete team history
- Years with each team
- Team names and details
- Chronological organization

Inputs: rider_id (required).

get_rider_victoriesA

Get a comprehensive list of a rider's UCI victories. This tool retrieves detailed information about all UCI-registered race victories achieved by the cyclist throughout their career. Victories can be filtered to show only WorldTour wins if desired.

Note: If you don't know the rider's ID, use the search_rider tool first to find it by name.

Example usage:
- Get all UCI victories for Tadej Pogačar (ID: 16973)
- Get WorldTour victories for Jonas Vingegaard (ID: 16974)

Returns a formatted string with:
- Complete list of victories
- Race details including category
- Date and year of each victory
- Option to filter by WorldTour races only

Inputs: rider_id (required), world_tour_only.

get_rider_year_resultsA

Retrieve detailed results for a professional cyclist for a specific year. This tool provides comprehensive information about a rider's performance in all races during a given calendar year. It includes positions achieved, race categories, dates, and additional details.

Note: If you don't know the rider's ID, use the search_rider tool first to find it by name.

Example usage:
- Get 2023 results for Tadej Pogačar (ID: 16973)
- Get 2022 results for Jonas Vingegaard (ID: 16974)

Returns a formatted string with:
- Complete results for the specified year
- Position and time for each race
- Race category and details
- Chronological organization by date

Inputs: rider_id (required), year (required).

get_start_listA

Get the start list for a specific edition of a cycling race. The start list includes rider numbers, names, and teams.

Note: If you don't know the race's ID, use the search_race tool first to find it by name.
If no year is specified, the current year will be used.

Example usage:
- Get start list for current year's Tour de France (Race ID: 17)
- Get start list for 2023 Paris-Roubaix (Race ID: 30, Year: 2023)

Returns a formatted string with:
- Race name and year
- List of participating teams
- Riders for each team with their race numbers

Inputs: race_id (required), year.

get_uci_rankingsB

Get UCI rankings for riders, teams, or nations. This tool provides access to the UCI ranking data for professional cyclists, teams, or nations. Results can be filtered by ranking type, year, and category.

Example usage:
- Get World UCI rider rankings for 2023
- Get Europe Tour UCI team rankings for 2022
- Get UCI nation rankings for 2023 in the World category

Returns a formatted string with:
- Ranking list with positions and points
- Filtered by specified categories
- Organized in a readable format
- Option to filter by country

Inputs: category, country_code, page_num, rank_type, +1 more.

search_raceA

Search for cycling races by name. This tool helps find races by their name, returning a list of matching races with their IDs and countries. This is useful when you know a race's name but need its ID for other operations.

Example usage:
- Search for "tour" to find Tour de France and other tours
- Search for "giro" to find Giro d'Italia

Returns a formatted string with:
- List of matching races
- Each race's ID, name, and country
- Number of matches found

Inputs: query (required).

search_riderA

Search for professional cyclists by name. This tool helps find riders by their name, returning a list of matching riders with their IDs and basic information. This is useful when you need a rider's ID for other operations but only know their name.

Example usage:
- Search for "Tadej Pogacar" to find Tadej Pogačar's ID
- Search for "Van Aert" to find Wout van Aert's ID

Returns a formatted string with:
- List of matching riders
- Each rider's ID, name, nationality, and current team
- Number of matches found

Inputs: query (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.8/5.0

    Scored across 18 tools

    Disambiguation3/5

    The tools have clear distinctions between race-focused and rider-focused operations, but there is significant overlap within rider tools. For example, get_rider_best_results, get_rider_grand_tour_results, get_rider_monument_results, get_rider_one_day_races, get_rider_race_history, get_rider_stage_races, and get_rider_year_results all retrieve subsets of race results, which could confuse an agent about which to use for specific queries. The descriptions help differentiate, but the boundaries are fuzzy.

    Naming Consistency5/5

    All tool names follow a consistent snake_case pattern with a verb_noun structure (e.g., get_race_details, search_rider). The naming is predictable and readable throughout, with no deviations in style or convention, making it easy for an agent to parse and understand the tool purposes.

    Tool Count3/5

    With 18 tools, the count is on the higher side for a cycling data server, bordering on heavy. While the domain of professional cycling is broad, the tool set includes many overlapping rider result tools that could potentially be consolidated, making it feel slightly bloated but still within a reasonable scope.

    Completeness4/5

    The tool surface covers the cycling domain well with race details, results, rider information, and search functionalities. However, there are minor gaps, such as no tools for team details beyond rider affiliations, race calendars, or live race data, which agents might need for comprehensive coverage. The core operations are well-represented, allowing agents to work around these omissions.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Provides comprehensive Formula 1 data access including race schedules, session results, lap times, telemetry data, driver/constructor standings, and circuit information. Enables users to retrieve and analyze F1 racing data through natural language queries using the FastF1 Python package.
      5
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Provides access to Formula 1 data including driver and constructor championship standings with support for current and historical seasons. Enables users to query F1 championship information through natural language with plans for expanded race data and telemetry.
      22
      11 PyPI
      1
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Provides professional cycling data from ProCyclingStats, enabling race discovery, stage results, rider profiles, startlists, and free-text search through MCP tools.
      6
      3
      -
    • F
      license
      Not graded
      quality
      D
      maintenance
      MCP server exposing ProCyclingStats teams, riders, and races data by scraping site pages, enabling custom rankings and historical result analysis.
      -