FirstCycling MCP Server
Professional cycling data API for conversational AI via MCP.
Key Features
Use Cases
README
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
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
uvpackage manager (recommended)- Dependencies as listed in
pyproject.toml, including:- mcp
- beautifulsoup4
- lxml
- pandas
- slumber
- and other packages for web scraping and data processing
Setup
- Clone this repository
- 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 .
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:
-
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
- macOS:
-
Add the server to your configuration:
json{ "mcpServers": { "firstcycling": { "command": "uv", "args": ["--directory", "/path/to/server/directory", "run", "firstcycling.py"] } } } -
Restart Claude for Desktop
License
MIT
Star History
Repository Owner
User
Repository Details
Programming Languages
Join Our Newsletter
Stay updated with the latest AI tools, news, and offers by subscribing to our weekly newsletter.
Related MCPs
Discover similar Model Context Protocol servers
Strava MCP Server
Bridge Strava data and tools to LLMs via the Model Context Protocol.
Strava MCP Server provides a standardized MCP interface to access and manage Strava data, exposing activities, profiles, segments, routes, and statistics as AI-consumable tools. Implemented in TypeScript, it enables large language models to interact with Strava's extensive API through natural language prompts and structured MCP endpoints. The server supports fetching, viewing, and exporting data including activities, heart rate, power, and routes, making advanced context-driven integrations possible for AI applications.
- ⭐ 180
- MCP
- r-huijts/strava-mcp
Campertunity MCP Server
Model Context Protocol server for AI-driven camping and outdoor recreation data
Implements the Model Context Protocol (MCP) to provide AI models with structured access to camping and outdoor recreation data. Offers tools for searching, filtering, and booking campgrounds and sites based on a wide range of criteria. Enhances data accuracy with AI and aggregates information from multiple sources, enabling dynamic, real-time queries and bookings. Ideal for integrating intelligent camping experiences into AI-driven applications.
- ⭐ 11
- MCP
- campertunity/mcp-server
Climatiq MCP Server
MCP server providing AI assistants with real-time carbon emissions calculations via Climatiq API.
Climatiq MCP Server implements the Model Context Protocol to bridge AI assistants with the Climatiq API for precise carbon emissions calculations. It exposes a set of tools for various emissions scenarios, including electricity use, travel, freight, and more. The server generates resource URIs for detailed emission reports and provides natural language explanations on climate impact. Configuration is streamlined via environment variables, CLI tools, or files, supporting easy integration with platforms like Claude Desktop.
- ⭐ 6
- MCP
- jagan-shanmugam/climatiq-mcp-server
AllTrails MCP Server
MCP server for seamless AllTrails data access and integration
AllTrails MCP Server provides Model Context Protocol (MCP) compliant access to AllTrails hiking trail data, enabling AI tools to search for trails and retrieve detailed trail information. It supports searching by national park and fetching comprehensive details such as difficulty, length, elevation, ratings, and route types. The server communicates via standard input/output and is designed for easy integration with MCP-compatible clients like Claude Desktop. Installation is flexible, supporting both virtual environments and system Python setups.
- ⭐ 6
- MCP
- srinath1510/alltrails-mcp-server
Aviationstack MCP Server
MCP server offering comprehensive endpoints for aviation and flight data.
Aviationstack MCP Server provides an MCP-compliant API that exposes tools to access real-time and scheduled flight data, aircraft details, random aircraft types, countries, and city information from the AviationStack API. It offers ready-to-use endpoints for airline-specific flight queries, airport schedules, and in-depth vehicle, country, and city data. The solution applies the Model Context Protocol by defining MCP tools as Python functions with standardized interfaces, designed for seamless integration into MCP-compatible environments. The server is built using Python, incorporates the FastMCP library, and is intended for easy deployment and use in application development.
- ⭐ 11
- MCP
- Pradumnasaraf/aviationstack-mcp
National Parks MCP Server
Real-time access to U.S. National Parks data via the Model Context Protocol.
Provides an MCP-compliant API server for real-time information on U.S. National Parks. Offers endpoints to query park details, alerts, activities, visitor centers, campgrounds, and events. Designed for easy integration with AI agents and tools that utilize the Model Context Protocol for context management.
- ⭐ 35
- MCP
- KyrieTangSheng/mcp-server-nationalparks
Didn't find tool you were looking for?