TomTom MCP Server

Implementation Reference

• src/handlers/routingHandler.ts:51-72 (handler)

  Factory function that returns the asynchronous handler for executing the tomtom-waypoint-routing tool. It processes input parameters, calls the routing service getMultiWaypointRoute, logs progress and errors, and returns formatted JSON results or error responses.

  export function createWaypointRoutingHandler() {
    return async (params: any) => {
      logger.info(`🗺️ Multi-waypoint route: ${params.waypoints.length} waypoints`);
      try {
        const result = await getMultiWaypointRoute(params.waypoints, params);
        logger.info(`✅ Multi-waypoint route calculated`);
        return {
          content: [
            {
              text: JSON.stringify(result, null, 2),
              type: "text" as const,
            },
          ],
        };
      } catch (error: any) {
        logger.error(`❌ Multi-waypoint routing failed: ${error.message}`);
        return {
          content: [{ type: "text" as const, text: JSON.stringify({ error: error.message }) }],
          isError: true,
        };
      }
    };

• src/schemas/routing/routingSchema.ts:34-46 (schema)

  Zod input schema for the tomtom-waypoint-routing tool, defining waypoints (array of coordinates, min 2), routing options, vehicle specs, and section types.

  export const tomtomWaypointRoutingSchema = {
    waypoints: z
      .array(coordinateSchema)
      .min(2)
      .describe(
        "Ordered array of waypoint coordinates (minimum 2). Route calculated in exact sequence provided. Use geocoding for accurate coordinates."
      ),
    ...routingOptionsSchema,
    ...vehicleSchema,
    sectionType: sectionTypeSchema.describe(
      "Road section types to highlight for route analysis. Options: toll (toll roads), motorway (highways), tunnel, urban (city areas), country (rural areas), pedestrian (walking paths), traffic (traffic incidents), toll_road, ferry, travel_mode, important_road_stretch. Accepts array of string(s)."
    ),
  };

• src/tools/routingTools.ts:42-50 (registration)

  MCP server registration of the tomtom-waypoint-routing tool, specifying title, description, input schema, and handler factory.

  server.registerTool(
    "tomtom-waypoint-routing",
    {
      title: "TomTom Waypoint Routing",
      description: "Multi-stop route planning Routing API",
      inputSchema: schemas.tomtomWaypointRoutingSchema,
    },
    createWaypointRoutingHandler()
  );

• src/tools/routingOrbisTools.ts:42-50 (registration)

  Alternative MCP server registration for Orbis variant of the tomtom-waypoint-routing tool.

  server.registerTool(
    "tomtom-waypoint-routing",
    {
      title: "TomTom Waypoint Routing",
      description: "Multi-stop route planning Routing API",
      inputSchema: schemas.tomtomWaypointRoutingSchema,
    },
    createWaypointRoutingHandler()
  );