Tour de France MCP
Tools

Live race

Telemetry, on-course groups, checkpoints, commentary and withdrawals.

These tools reflect what is happening on the road right now. Most return [] until their stage is actually being raced (the upstream API answers 204, which the server normalises to an empty array).

Unless noted, each takes year (default 2026), stage (default 1) and limit / offset pagination.

tdf_rider_telemetry

Live per-rider telemetry (position, speed, gap). Note this endpoint is keyed by year only โ€” there is no stage parameter. Empty until a stage is racing.

Endpoint: GET /api/telemetryCompetitor-{year}

ParameterTypeDefaultDescription
yearinteger2026Four-digit edition year.
limit / offsetintegerโ€” / 0Pagination.
{ "name": "tdf_rider_telemetry", "arguments": { "year": 2026 } }

tdf_group_telemetry

Live telemetry for on-course groups (peloton, breakaway, chase). Empty until the stage is racing.

Endpoint: GET /api/telemetryPack-{year}-{stage}

{ "name": "tdf_group_telemetry", "arguments": { "year": 2026, "stage": 12 } }

tdf_race_groups

On-course groups (peloton, breakaway, chasers) with time gaps between them. Empty until the stage is racing.

Endpoint: GET /api/pack-{year}-{stage}

{ "name": "tdf_race_groups", "arguments": { "year": 2026, "stage": 12 } }

tdf_checkpoints

Ordered route checkpoints for a stage: coordinates plus estimated pass-time schedules. Available ahead of the stage as a route plan.

Endpoint: GET /api/checkpointList-{year}-{stage}

{ "name": "tdf_checkpoints", "arguments": { "year": 2026, "stage": 12 } }

tdf_active_checkpoint

The currently-active checkpoint for a stage โ€” a single live document (not a list, so it does not paginate).

Endpoint: GET /api/checkpoint-{year}-{stage} ยท Returns: single object

ParameterTypeDefaultDescription
yearinteger2026Four-digit edition year.
stageinteger1Stage number 1โ€“21.
{ "name": "tdf_active_checkpoint", "arguments": { "year": 2026, "stage": 12 } }

tdf_live_commentary

Live text commentary / flash-info feed for a stage. Empty until the stage is racing.

Endpoint: GET /api/flashInfoLive-{year}-{stage}

{ "name": "tdf_live_commentary", "arguments": { "year": 2026, "stage": 12 } }

tdf_convoy_vehicles

Race-convoy vehicle positions (caravan, medical, etc.) for a stage. Empty until the stage is racing.

Endpoint: GET /api/extraVehicle-{year}-{stage}

{ "name": "tdf_convoy_vehicles", "arguments": { "year": 2026, "stage": 12 } }

tdf_withdrawals

Abandons / withdrawals recorded during a stage.

Endpoint: GET /api/stageWithdrawals-{year}-{stage}

{ "name": "tdf_withdrawals", "arguments": { "year": 2026, "stage": 12 } }

On this page