reunion_get_road_classification
Retrieve functional classification of Réunion national-road segments by route code and class. Returns category, class, segment length (m), and PR markers for maintenance planning.
Instructions
Functional classification of Réunion national-road segments: each segment between PR markers is assigned a category and class (used for maintenance planning, design standards, signposting). Returns route code, category, class, description, segment length (m), PR start/end. Source: DEAL Réunion. Combine with reunion_get_road_traffic and reunion_get_speed_limits for full road-segment analysis.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| route | No | Exact national-road code, e.g. "RN1", "RN2" | |
| classe | No | Functional class filter (typically a single letter or code, e.g. "A", "B", "C") | |
| limit | No | Max segments to return (1-500, default 50) |
Implementation Reference
- src/modules/transport.ts:62-96 (handler)Handler function for 'reunion_get_road_classification' tool. Queries the 'rn-classement-fonctionnel-lareunion' OpenDataSoft dataset, filtering by route and/or functional class, and returns segment data including route, category, class, description, length, and PR markers.
server.tool( 'reunion_get_road_classification', 'Functional classification of Réunion national-road segments: each segment between PR markers is assigned a category and class (used for maintenance planning, design standards, signposting). Returns route code, category, class, description, segment length (m), PR start/end. Source: DEAL Réunion. Combine with reunion_get_road_traffic and reunion_get_speed_limits for full road-segment analysis.', { route: z.string().optional().describe('Exact national-road code, e.g. "RN1", "RN2"'), classe: z.string().optional().describe('Functional class filter (typically a single letter or code, e.g. "A", "B", "C")'), limit: z.number().int().min(1).max(500).default(50).describe('Max segments to return (1-500, default 50)'), }, async ({ route, classe, limit }) => { try { const data = await client.getRecords<RecordObject>(DATASET_ROAD_CLASS, { where: buildWhere([ route ? `route = ${quote(route)}` : undefined, classe ? `classe = ${quote(classe)}` : undefined, ]), limit, }); return jsonResult({ total_segments: data.total_count, segments: data.results.map((row) => ({ route: pickString(row, ['route']), category: pickString(row, ['categorie']), class: pickString(row, ['classe']), description: pickString(row, ['descript']), length_m: pickNumber(row, ['longueur']), pr_start: pickString(row, ['plod']), pr_end: pickString(row, ['plof']), })), }); } catch (error) { return errorResult(error instanceof Error ? error.message : 'Failed to fetch road classification'); } } ); - src/modules/transport.ts:65-69 (schema)Input schema using Zod for the 'reunion_get_road_classification' tool, defining optional route, classe, and limit parameters.
{ route: z.string().optional().describe('Exact national-road code, e.g. "RN1", "RN2"'), classe: z.string().optional().describe('Functional class filter (typically a single letter or code, e.g. "A", "B", "C")'), limit: z.number().int().min(1).max(500).default(50).describe('Max segments to return (1-500, default 50)'), }, - src/modules/transport.ts:19-353 (registration)Registration function that registers all transport tools (including 'reunion_get_road_classification') with the MCP server via server.tool() calls.
export function registerTransportTools(server: McpServer): void { server.tool( 'reunion_get_road_traffic', 'Trafic Moyen Journalier Annuel (TMJA, average daily traffic) counts on Réunion national-road segments. Each row is a counted segment between two PR markers (points de repère) for a given year. Returns: route code, year, TMJA in vehicles/day, heavy-vehicle count and percentage, PR start/end, location name, commune, count type (manual vs automatic). Sorted by year then traffic descending. Source: DEAL Réunion via data.regionreunion.com.', { route: z.string().optional().describe('Exact national-road code, e.g. "RN1", "RN1A", "RN2", "RN3"'), year: z.number().int().optional().describe('Reference year of the count (4 digits, e.g. 2022)'), commune: z.string().optional().describe('Commune name prefix match'), limit: z.number().int().min(1).max(500).default(50).describe('Max segments to return (1-500, default 50)'), }, async ({ route, year, commune, limit }) => { try { const data = await client.getRecords<RecordObject>(DATASET_TRAFFIC, { where: buildWhere([ route ? `route = ${quote(route)}` : undefined, year !== undefined ? `annee = ${year}` : undefined, commune ? `commune LIKE ${quote(`${commune}%`)}` : undefined, ]), order_by: 'annee DESC, tmja DESC', limit, }); return jsonResult({ total_segments: data.total_count, segments: data.results.map((row) => ({ route: pickString(row, ['route']), year: pickNumber(row, ['annee']), tmja_vehicles_per_day: pickNumber(row, ['tmja']), heavy_vehicles_count: pickString(row, ['nb_pl']), heavy_vehicles_pct: pickString(row, ['pourcentag']), pr_start: pickString(row, ['plod']), pr_end: pickString(row, ['plof']), lieudit: pickString(row, ['lieudit']), commune: pickString(row, ['commune']), count_type: pickString(row, ['type_compt']), })), }); } catch (error) { return errorResult(error instanceof Error ? error.message : 'Failed to fetch road traffic'); } } ); server.tool( 'reunion_get_road_classification', 'Functional classification of Réunion national-road segments: each segment between PR markers is assigned a category and class (used for maintenance planning, design standards, signposting). Returns route code, category, class, description, segment length (m), PR start/end. Source: DEAL Réunion. Combine with reunion_get_road_traffic and reunion_get_speed_limits for full road-segment analysis.', { route: z.string().optional().describe('Exact national-road code, e.g. "RN1", "RN2"'), classe: z.string().optional().describe('Functional class filter (typically a single letter or code, e.g. "A", "B", "C")'), limit: z.number().int().min(1).max(500).default(50).describe('Max segments to return (1-500, default 50)'), }, async ({ route, classe, limit }) => { try { const data = await client.getRecords<RecordObject>(DATASET_ROAD_CLASS, { where: buildWhere([ route ? `route = ${quote(route)}` : undefined, classe ? `classe = ${quote(classe)}` : undefined, ]), limit, }); return jsonResult({ total_segments: data.total_count, segments: data.results.map((row) => ({ route: pickString(row, ['route']), category: pickString(row, ['categorie']), class: pickString(row, ['classe']), description: pickString(row, ['descript']), length_m: pickNumber(row, ['longueur']), pr_start: pickString(row, ['plod']), pr_end: pickString(row, ['plof']), })), }); } catch (error) { return errorResult(error instanceof Error ? error.message : 'Failed to fetch road classification'); } } ); server.tool( 'reunion_search_car_jaune_stops', 'Search bus stops of the Car Jaune network — La Réunion\'s interurban bus service operated by the Région — using GTFS data. Returns stop_id, stop_code, name, description, zone_id, location_type, parent_station, wheelchair-boarding flag, geographic coordinates. Use reunion_list_car_jaune_routes to list bus lines. Source: GTFS feed via data.regionreunion.com.', { query: z.string().optional().describe('Free-text search on stop name (e.g. "Saint-Denis", "Aéroport", "Gare")'), stop_code: z.string().optional().describe('Exact stop code as displayed at the stop'), wheelchair_accessible: z.boolean().optional().describe('If true, return only stops flagged wheelchair-accessible (GTFS wheelchair_boarding = "1")'), limit: z.number().int().min(1).max(500).default(50).describe('Max stops to return (1-500, default 50)'), }, async ({ query, stop_code, wheelchair_accessible, limit }) => { try { const data = await client.getRecords<RecordObject>(DATASET_GTFS, { where: buildWhere([ query ? `search(${quote(query)})` : undefined, stop_code ? `stop_code = ${quote(stop_code)}` : undefined, wheelchair_accessible ? `wheelchair_boarding = ${quote('1')}` : undefined, ]), limit, }); return jsonResult({ total_stops: data.total_count, stops: data.results.map((row) => ({ stop_id: pickString(row, ['stop_id']), stop_code: pickString(row, ['stop_code']), stop_name: pickString(row, ['stop_name']), stop_desc: pickString(row, ['stop_desc']), zone_id: pickString(row, ['zone_id']), location_type: pickString(row, ['location_type']), parent_station: pickString(row, ['parent_station']), wheelchair_boarding: pickString(row, ['wheelchair_boarding']), stop_coordinates: row.stop_coordinates, })), }); } catch (error) { return errorResult(error instanceof Error ? error.message : 'Failed to fetch Car Jaune stops'); } } ); server.tool( 'reunion_get_cycle_network', 'Voie Vélo Régionale (regional cycle network) segments in La Réunion. Each segment has an amenity type (bike lane / shared path / greenway / etc.), operator, status (in service / planned / under construction), commissioning year, length, micro-region. Useful for cycling-route planning, infrastructure analysis, mobility studies. Source: Région Réunion via data.regionreunion.com.', { type: z.string().optional().describe('Amenity type prefix match. Examples: "Piste cyclable", "Bande cyclable", "Voie verte", "Couloir mixte"'), commune: z.string().optional().describe('Micro-region prefix match (Réunion is divided into 4 micro-regions: "Nord", "Sud", "Est", "Ouest")'), limit: z.number().int().min(1).max(500).default(50).describe('Max segments to return (1-500, default 50)'), }, async ({ type, commune, limit }) => { try { const data = await client.getRecords<RecordObject>(DATASET_CYCLE, { where: buildWhere([ type ? `type_amen LIKE ${quote(`${type}%`)}` : undefined, commune ? `micro_reg LIKE ${quote(`${commune}%`)}` : undefined, ]), limit, }); return jsonResult({ total_segments: data.total_count, segments: data.results.map((row) => ({ type: pickString(row, ['type_amen']), identifier: pickString(row, ['identifian']), operator: pickString(row, ['exploitant']), status: pickString(row, ['etat_amen']), commissioning_year: pickNumber(row, ['annee_mis']), length_m: pickNumber(row, ['longueur']), micro_region: pickString(row, ['micro_reg']), })), }); } catch (error) { return errorResult(error instanceof Error ? error.message : 'Failed to fetch cycle network'); } } ); server.tool( 'reunion_list_car_jaune_routes', 'List all bus routes of the Car Jaune network (Réunion\'s regional interurban bus service) from the GTFS routes.txt feed. Returns route_id, short name (line code like "E1", "S1"), long name (origin → destination), GTFS route_type (3 = bus), brand color, official URL. Use reunion_search_car_jaune_stops to find stops on these routes.', {}, async () => { try { const data = await client.getRecords<RecordObject>(DATASET_GTFS_ROUTES, { limit: 50 }); return jsonResult({ total_routes: data.total_count, routes: data.results.map((row) => ({ route_id: pickString(row, ['route_id']), short_name: pickString(row, ['route_short_name']), long_name: pickString(row, ['route_long_name']), route_type: pickString(row, ['route_type']), color: pickString(row, ['route_color']), url: pickString(row, ['route_url']), })), }); } catch (error) { return errorResult(error instanceof Error ? error.message : 'Failed to list Car Jaune routes'); } } ); server.tool( 'reunion_search_road_accidents', 'Search records from the BAAC (Bulletin d\'Analyse des Accidents Corporels de la Circulation) for La Réunion, covering 2016-2019. Each row is one road accident with personal injury. Returns accident ID, datetime, commune, address, lat/lon, severity, weather (atm), luminosity (lum), collision type, road category (catr), max speed limit. Sorted most recent first. Source: ONISR via data.regionreunion.com.', { year: z.number().int().optional().describe('Year filter (4 digits, 2016-2019)'), severity: z.number().int().optional().describe('Severity code per BAAC schema: 1 = indemne (unharmed), 2 = tué (killed), 3 = blessé hospitalisé (hospitalized), 4 = blessé léger (light injury)'), commune: z.string().optional().describe('Commune name prefix match'), limit: z.number().int().min(1).max(200).default(50).describe('Max accidents to return (1-200, default 50)'), }, async ({ year, severity, commune, limit }) => { try { const data = await client.getRecords<RecordObject>(DATASET_ACCIDENTS, { where: buildWhere([ year !== undefined ? `an = ${year}` : undefined, severity !== undefined ? `grav = ${severity}` : undefined, commune ? `com_name LIKE ${quote(`${commune}%`)}` : undefined, ]), order_by: 'datetime DESC', limit, }); return jsonResult({ total_accidents: data.total_count, accidents: data.results.map((row) => ({ accident_id: pickString(row, ['num_acc']), datetime: pickString(row, ['datetime']), commune: pickString(row, ['com_name', 'nom_com']), address: pickString(row, ['adr']), lat: pickNumber(row, ['lat']), lon: pickNumber(row, ['long']), severity: pickNumber(row, ['grav']), weather: pickString(row, ['atm']), luminosity: pickString(row, ['lum']), collision_type: pickString(row, ['col']), road_category: pickString(row, ['catr']), max_speed: pickNumber(row, ['vma']), })), }); } catch (error) { return errorResult(error instanceof Error ? error.message : 'Failed to search accidents'); } } ); server.tool( 'reunion_search_vehicle_inspection_prices', 'Mandatory vehicle-inspection (contrôle technique) center prices in La Réunion. Centers must inspect every car >4 years old then every 2 years (different rules for utility, motorbike). Returns center SIRET, name, address, postal code, commune, phone, URL, vehicle category, energy type, base visit price (EUR), counter-visit price min/max, last update date, lat/lon. Useful for price comparison.', { commune: z.string().optional().describe('Center commune name prefix match'), vehicle_category: z.string().optional().describe('Vehicle category label prefix. Examples: "Voiture particulière", "Camionnette", "Moto", "Camion"'), limit: z.number().int().min(1).max(100).default(50).describe('Max rows to return (1-100, default 50)'), }, async ({ commune, vehicle_category, limit }) => { try { const data = await client.getRecords<RecordObject>(DATASET_INSPECTION_PRICES, { where: buildWhere([ commune ? `cct_commune LIKE ${quote(`${commune}%`)}` : undefined, vehicle_category ? `cat_vehicule_libelle LIKE ${quote(`${vehicle_category}%`)}` : undefined, ]), limit, }); return jsonResult({ total_rows: data.total_count, inspections: data.results.map((row) => ({ center_siret: pickString(row, ['cct_siret']), center_name: pickString(row, ['cct_denomination']), address: pickString(row, ['cct_adresse']), postal_code: pickString(row, ['cct_code_postal']), commune: pickString(row, ['cct_commune']), phone: pickString(row, ['cct_tel']), url: pickString(row, ['cct_url']), vehicle_category: pickString(row, ['cat_vehicule_libelle']), energy: pickString(row, ['cat_energie_libelle']), visit_price: pickNumber(row, ['prix_visite']), re_visit_price_min: pickNumber(row, ['prix_contre_visite_mini']), re_visit_price_max: pickNumber(row, ['prix_contre_visite_maxi']), updated: pickString(row, ['cct_update_date_time']), lat: pickNumber(row, ['latitude']), lon: pickNumber(row, ['longitude']), })), }); } catch (error) { return errorResult(error instanceof Error ? error.message : 'Failed to fetch inspection prices'); } } ); server.tool( 'reunion_get_road_daily_flow', 'Daily traffic-flow measurements at fixed automatic counting stations on Réunion\'s national roads (RN). Each row is one station × one day × one channel/measurement type. Returns station name and code, channel (direction/lane), measurement nature (vehicles/heavy trucks), date, value, day type (weekday/weekend), school-holiday flag. Sorted by date descending. Combine with reunion_get_road_traffic for annualized averages.', { station: z.string().optional().describe('Station code or name prefix match (e.g. "001", "RN1")'), limit: z.number().int().min(1).max(500).default(100).describe('Max measurements to return (1-500, default 100)'), }, async ({ station, limit }) => { try { const data = await client.getRecords<RecordObject>(DATASET_DAILY_FLOW, { where: buildWhere([ station ? `code_station LIKE ${quote(`${station}%`)} OR station LIKE ${quote(`${station}%`)}` : undefined, ]), order_by: 'jour DESC', limit, }); return jsonResult({ total_rows: data.total_count, measurements: data.results.map((row) => ({ station: pickString(row, ['station']), station_code: pickString(row, ['code_station']), channel: pickString(row, ['libelle_canal']), measure_type: pickString(row, ['nature_de_mesure']), day: pickString(row, ['jour']), value: pickNumber(row, ['mesure']), day_type: pickString(row, ['type_jour']), holiday: pickString(row, ['vacances']), })), }); } catch (error) { return errorResult(error instanceof Error ? error.message : 'Failed to fetch daily flow'); } } ); server.tool( 'reunion_get_speed_limits', 'Speed-limit segments on Réunion\'s national roads (RN). Each row is one homogeneous-speed segment between two PR markers, on one side of the road. Returns objectid, road number, axis (e.g. RN1), side (sens), speed limit in km/h, length (m), PR start/end, source, last update date. Useful for routing applications, speed-compliance analysis, road-safety studies.', { axe: z.string().optional().describe('Road axis prefix match. Examples: "RN1", "RN1A", "RN2", "RN3"'), limit: z.number().int().min(1).max(500).default(100).describe('Max segments to return (1-500, default 100)'), }, async ({ axe, limit }) => { try { const data = await client.getRecords<RecordObject>(DATASET_SPEED_LIMITS, { where: buildWhere([axe ? `axe LIKE ${quote(`${axe}%`)}` : undefined]), limit, }); return jsonResult({ total_segments: data.total_count, segments: data.results.map((row) => ({ objectid: pickNumber(row, ['objectid']), road_number: pickString(row, ['numero']), axe: pickString(row, ['axe']), side: pickString(row, ['cote']), speed_kmh: pickNumber(row, ['vitesse_m']), length_m: pickNumber(row, ['longueur']), start_pr: pickString(row, ['plod']), end_pr: pickString(row, ['plof']), source: pickString(row, ['source']), updated: pickString(row, ['date_modif']), })), }); } catch (error) { return errorResult(error instanceof Error ? error.message : 'Failed to fetch speed limits'); } } ); } - src/modules/index.ts:53-56 (registration)The 'registerTransportTools' function is called from the central 'registerAllTools' entry point, which is invoked from src/index.ts.
registerTransportTools(server); registerUrbanismTools(server); registerWeatherTools(server); } - src/modules/transport.ts:10-16 (helper)Dataset ID constant for the road classification data source used by the tool.
const DATASET_ROAD_CLASS = 'rn-classement-fonctionnel-lareunion'; const DATASET_CYCLE = 'voie-velo-regionale'; const DATASET_GTFS = 'donnees-gtfs-lareunion'; const DATASET_GTFS_ROUTES = 'gtfs-routes-cars-jaunes-lareunion'; const DATASET_ACCIDENTS = 'bases-de-donnees-annuelles-des-accidents-corporels-de-la-circulation-routiere'; const DATASET_INSPECTION_PRICES = 'prix-des-controles-techniques-a-la-reunion'; const DATASET_DAILY_FLOW = 'debit-journalier-rn-crlaeunion';