@mapbox/mcp-server 0.2.4 → 0.4.1

package/dist/commonjs/tools/directions-tool/cleanResponseData.js

@@ -0,0 +1,178 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cleanResponseData = cleanResponseData;
+/**
+ * Cleans up the API response to reduce token count while preserving useful data.
+ *
+ * @param input The original input parameters used for the request
+ * @param data The raw response data from the Mapbox Directions API
+ * @returns Cleaned data with reduced token count
+ */
+function cleanResponseData(input, data) {
+    // Remove unnecessary keys to reduce token count
+    if ('uuid' in data) {
+        delete data.uuid;
+    }
+    if ('code' in data) {
+        delete data.code;
+    }
+    if ('waypoints' in data) {
+        // rename each waypoint's location to `snap_location` and distance to `snap_distance`
+        // this is not really necessary, but hopefully agents will find this more obvious that we have snapping
+        data.waypoints = data.waypoints.map((waypoint) => {
+            const updatedWaypoint = { ...waypoint };
+            if ('location' in updatedWaypoint) {
+                updatedWaypoint.snap_location = updatedWaypoint.location;
+                delete updatedWaypoint.location;
+            }
+            if ('distance' in updatedWaypoint) {
+                updatedWaypoint.snap_distance = Math.round(updatedWaypoint.distance);
+                delete updatedWaypoint.distance;
+            }
+            return updatedWaypoint;
+        });
+    }
+    if (!('routes' in data)) {
+        // lets return early because there is nothing more we could do here
+        return data;
+    }
+    data.routes.forEach((route) => {
+        // Round duration and distance to integers if they exist
+        if (route.duration !== undefined) {
+            route.duration = Math.round(route.duration);
+        }
+        if (route.distance !== undefined) {
+            route.distance = Math.round(route.distance);
+        }
+        delete route.weight_name;
+        delete route.weight;
+        // Handle the case where geometry is not included (when geometries='none')
+        if (input.geometries === 'none' && route.geometry) {
+            delete route.geometry;
+        }
+        route.leg_summaries = route.legs.map((leg) => leg.summary);
+        // Collect all unique admins across all legs of this route
+        const routeUniqueIsoCodes = new Set();
+        // Collect all unique notification messages across all legs of this route
+        const routeUniqueNotificationMessages = new Set();
+        // Collect all incidents across all legs of this route
+        const routeIncidents = [];
+        // Collect voice instruction announcements from all steps
+        const routeAnnouncements = [];
+        let totalDistanceWeightedSpeed = 0; // Sum of (speed × distance) for each segment
+        let sumDistanceMeters = 0;
+        // Object to track distance by congestion type
+        const congestionTypeToDistance = {
+            severe: 0,
+            heavy: 0,
+            moderate: 0,
+            low: 0
+        };
+        route.legs.forEach((leg) => {
+            if (leg.annotation && leg.annotation.speed && leg.annotation.distance) {
+                leg.annotation.speed.forEach((speed, index) => {
+                    const speedValue = parseFloat(String(speed));
+                    const distance = parseFloat(String(leg.annotation.distance[index]));
+                    // Calculate the weighted speed (speed * distance)
+                    totalDistanceWeightedSpeed += speedValue * distance;
+                    sumDistanceMeters += distance;
+                });
+            }
+            if (leg.annotation &&
+                leg.annotation.congestion &&
+                leg.annotation.distance) {
+                // iterate every congestion string in leg.annotation.congestion
+                // each string is one of `severe, heavy, moderate, low, unknown`
+                // keep track of total distance by type of congestion
+                leg.annotation.congestion.forEach((congestion, index) => {
+                    const distance = parseFloat(String(leg.annotation.distance[index]));
+                    if (congestion === 'severe' ||
+                        congestion === 'heavy' ||
+                        congestion === 'moderate' ||
+                        congestion === 'low') {
+                        congestionTypeToDistance[congestion] += distance;
+                    }
+                    // Skip 'unknown' congestion type
+                });
+            }
+            if (leg.admins && Array.isArray(leg.admins)) {
+                // Extract unique ISO codes from this leg
+                leg.admins.forEach((admin) => {
+                    if (admin.iso_3166_1_alpha3) {
+                        routeUniqueIsoCodes.add(admin.iso_3166_1_alpha3);
+                    }
+                });
+            }
+            // Process notifications if they exist
+            if (leg.notifications && Array.isArray(leg.notifications)) {
+                // Extract unique notification messages from this leg
+                leg.notifications.forEach((notification) => {
+                    if (notification.details && notification.details.message) {
+                        routeUniqueNotificationMessages.add(notification.details.message);
+                    }
+                });
+            }
+            // Process incidents if they exist
+            if (leg.incidents && Array.isArray(leg.incidents)) {
+                leg.incidents.forEach((incident) => {
+                    // Extract only the specified fields for each incident
+                    routeIncidents.push({
+                        type: incident.type,
+                        end_time: incident.end_time,
+                        long_description: incident.long_description,
+                        impact: incident.impact,
+                        affected_road_names: incident.affected_road_names,
+                        length: incident.length
+                    });
+                });
+            }
+            // Process steps if they exist to collect voice instructions
+            if (leg.steps && Array.isArray(leg.steps)) {
+                leg.steps.forEach((step) => {
+                    if (step.voiceInstructions && Array.isArray(step.voiceInstructions)) {
+                        step.voiceInstructions.forEach((instruction) => {
+                            if (instruction.announcement) {
+                                routeAnnouncements.push(instruction.announcement);
+                            }
+                        });
+                    }
+                });
+            }
+        }); // Add all unique admins as a new property on the route
+        route.intersecting_admins = Array.from(routeUniqueIsoCodes);
+        // Add all unique notification messages as a new property on the route
+        route.notifications_summary = Array.from(routeUniqueNotificationMessages);
+        // Add all incidents with the specified fields as a new property on the route
+        route.incidents_summary = routeIncidents;
+        // Add voice instruction announcements only if there are 1 to 10 of them
+        // If there are more than 10, it's just too many, and if there is 0 then we don't have them.
+        if (routeAnnouncements.length >= 1 && routeAnnouncements.length <= 10) {
+            route.instructions = routeAnnouncements;
+        }
+        route.num_legs = route.legs.length;
+        // Add congestion distance information to route
+        route.congestion_information = {
+            length_low: Math.round(congestionTypeToDistance.low),
+            length_moderate: Math.round(congestionTypeToDistance.moderate),
+            length_heavy: Math.round(congestionTypeToDistance.heavy),
+            length_severe: Math.round(congestionTypeToDistance.severe)
+        };
+        // Calculate and add average speed in km/h
+        if (sumDistanceMeters > 0 && totalDistanceWeightedSpeed > 0) {
+            // Calculate distance-weighted average speed
+            const averageMetersPerSecond = totalDistanceWeightedSpeed / sumDistanceMeters;
+            // Convert m/s to km/h (multiply by 3.6) and round to integer
+            route.average_speed_kph = Math.round(averageMetersPerSecond * 3.6);
+        }
+        if (route.duration_typical) {
+            route.duration_under_typical_traffic_conditions = Math.round(route.duration_typical);
+            delete route.duration_typical;
+        }
+        if (route.weight_typical) {
+            delete route.weight_typical;
+        }
+        delete route.legs;
+    });
+    return data;
+}
+//# sourceMappingURL=cleanResponseData.js.map

package/dist/commonjs/tools/directions-tool/cleanResponseData.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanResponseData.js","sourceRoot":"","sources":["../../../../src/tools/directions-tool/cleanResponseData.ts"],"names":[],"mappings":";;AAUA,8CA+MC;AAtND;;;;;;GAMG;AACH,SAAgB,iBAAiB,CAC/B,KAA4C,EAC5C,IAAS;IAET,gDAAgD;IAChD,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;QACnB,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;QACnB,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED,IAAI,WAAW,IAAI,IAAI,EAAE,CAAC;QACxB,qFAAqF;QACrF,uGAAuG;QACvG,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAa,EAAE,EAAE;YACpD,MAAM,eAAe,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;YACxC,IAAI,UAAU,IAAI,eAAe,EAAE,CAAC;gBAClC,eAAe,CAAC,aAAa,GAAG,eAAe,CAAC,QAAQ,CAAC;gBACzD,OAAO,eAAe,CAAC,QAAQ,CAAC;YAClC,CAAC;YACD,IAAI,UAAU,IAAI,eAAe,EAAE,CAAC;gBAClC,eAAe,CAAC,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;gBACrE,OAAO,eAAe,CAAC,QAAQ,CAAC;YAClC,CAAC;YACD,OAAO,eAAe,CAAC;QACzB,CAAC,CAAC,CAAC;IACL,CAAC;IAED,IAAI,CAAC,CAAC,QAAQ,IAAI,IAAI,CAAC,EAAE,CAAC;QACxB,mEAAmE;QACnE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,KAAU,EAAE,EAAE;QACjC,wDAAwD;QACxD,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YACjC,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC9C,CAAC;QACD,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YACjC,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC9C,CAAC;QAED,OAAO,KAAK,CAAC,WAAW,CAAC;QACzB,OAAO,KAAK,CAAC,MAAM,CAAC;QAEpB,0EAA0E;QAC1E,IAAI,KAAK,CAAC,UAAU,KAAK,MAAM,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YAClD,OAAO,KAAK,CAAC,QAAQ,CAAC;QACxB,CAAC;QAED,KAAK,CAAC,aAAa,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAQ,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAEhE,0DAA0D;QAC1D,MAAM,mBAAmB,GAAG,IAAI,GAAG,EAAU,CAAC;QAE9C,yEAAyE;QACzE,MAAM,+BAA+B,GAAG,IAAI,GAAG,EAAU,CAAC;QAE1D,sDAAsD;QACtD,MAAM,cAAc,GAAU,EAAE,CAAC;QAEjC,yDAAyD;QACzD,MAAM,kBAAkB,GAAa,EAAE,CAAC;QAExC,IAAI,0BAA0B,GAAG,CAAC,CAAC,CAAC,6CAA6C;QACjF,IAAI,iBAAiB,GAAG,CAAC,CAAC;QAE1B,8CAA8C;QAC9C,MAAM,wBAAwB,GAAG;YAC/B,MAAM,EAAE,CAAC;YACT,KAAK,EAAE,CAAC;YACR,QAAQ,EAAE,CAAC;YACX,GAAG,EAAE,CAAC;SACP,CAAC;QAEF,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,GAAQ,EAAE,EAAE;YAC9B,IAAI,GAAG,CAAC,UAAU,IAAI,GAAG,CAAC,UAAU,CAAC,KAAK,IAAI,GAAG,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC;gBACtE,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,KAAa,EAAE,KAAa,EAAE,EAAE;oBAC5D,MAAM,UAAU,GAAG,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;oBAC7C,MAAM,QAAQ,GAAG,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;oBACpE,kDAAkD;oBAClD,0BAA0B,IAAI,UAAU,GAAG,QAAQ,CAAC;oBACpD,iBAAiB,IAAI,QAAQ,CAAC;gBAChC,CAAC,CAAC,CAAC;YACL,CAAC;YAED,IACE,GAAG,CAAC,UAAU;gBACd,GAAG,CAAC,UAAU,CAAC,UAAU;gBACzB,GAAG,CAAC,UAAU,CAAC,QAAQ,EACvB,CAAC;gBACD,+DAA+D;gBAC/D,gEAAgE;gBAChE,qDAAqD;gBACrD,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,OAAO,CAC/B,CAAC,UAAkB,EAAE,KAAa,EAAE,EAAE;oBACpC,MAAM,QAAQ,GAAG,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;oBACpE,IACE,UAAU,KAAK,QAAQ;wBACvB,UAAU,KAAK,OAAO;wBACtB,UAAU,KAAK,UAAU;wBACzB,UAAU,KAAK,KAAK,EACpB,CAAC;wBACD,wBAAwB,CAAC,UAAU,CAAC,IAAI,QAAQ,CAAC;oBACnD,CAAC;oBACD,iCAAiC;gBACnC,CAAC,CACF,CAAC;YACJ,CAAC;YAED,IAAI,GAAG,CAAC,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC5C,yCAAyC;gBACzC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,KAAU,EAAE,EAAE;oBAChC,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;wBAC5B,mBAAmB,CAAC,GAAG,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;oBACnD,CAAC;gBACH,CAAC,CAAC,CAAC;YACL,CAAC;YAED,sCAAsC;YACtC,IAAI,GAAG,CAAC,aAAa,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,CAAC;gBAC1D,qDAAqD;gBACrD,GAAG,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,YAAiB,EAAE,EAAE;oBAC9C,IAAI,YAAY,CAAC,OAAO,IAAI,YAAY,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;wBACzD,+BAA+B,CAAC,GAAG,CAAC,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;oBACpE,CAAC;gBACH,CAAC,CAAC,CAAC;YACL,CAAC;YAED,kCAAkC;YAClC,IAAI,GAAG,CAAC,SAAS,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;gBAClD,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,QAAa,EAAE,EAAE;oBACtC,sDAAsD;oBACtD,cAAc,CAAC,IAAI,CAAC;wBAClB,IAAI,EAAE,QAAQ,CAAC,IAAI;wBACnB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;wBAC3B,gBAAgB,EAAE,QAAQ,CAAC,gBAAgB;wBAC3C,MAAM,EAAE,QAAQ,CAAC,MAAM;wBACvB,mBAAmB,EAAE,QAAQ,CAAC,mBAAmB;wBACjD,MAAM,EAAE,QAAQ,CAAC,MAAM;qBACxB,CAAC,CAAC;gBACL,CAAC,CAAC,CAAC;YACL,CAAC;YAED,4DAA4D;YAC5D,IAAI,GAAG,CAAC,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC1C,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAS,EAAE,EAAE;oBAC9B,IAAI,IAAI,CAAC,iBAAiB,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,iBAAiB,CAAC,EAAE,CAAC;wBACpE,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,WAAgB,EAAE,EAAE;4BAClD,IAAI,WAAW,CAAC,YAAY,EAAE,CAAC;gCAC7B,kBAAkB,CAAC,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;4BACpD,CAAC;wBACH,CAAC,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC,CAAC,CAAC;YACL,CAAC;QACH,CAAC,CAAC,CAAC,CAAC,uDAAuD;QAC3D,KAAK,CAAC,mBAAmB,GAAG,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QAE5D,sEAAsE;QACtE,KAAK,CAAC,qBAAqB,GAAG,KAAK,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;QAE1E,6EAA6E;QAC7E,KAAK,CAAC,iBAAiB,GAAG,cAAc,CAAC;QAEzC,wEAAwE;QACxE,4FAA4F;QAC5F,IAAI,kBAAkB,CAAC,MAAM,IAAI,CAAC,IAAI,kBAAkB,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;YACtE,KAAK,CAAC,YAAY,GAAG,kBAAkB,CAAC;QAC1C,CAAC;QAED,KAAK,CAAC,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC;QAEnC,+CAA+C;QAC/C,KAAK,CAAC,sBAAsB,GAAG;YAC7B,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,wBAAwB,CAAC,GAAG,CAAC;YACpD,eAAe,EAAE,IAAI,CAAC,KAAK,CAAC,wBAAwB,CAAC,QAAQ,CAAC;YAC9D,YAAY,EAAE,IAAI,CAAC,KAAK,CAAC,wBAAwB,CAAC,KAAK,CAAC;YACxD,aAAa,EAAE,IAAI,CAAC,KAAK,CAAC,wBAAwB,CAAC,MAAM,CAAC;SAC3D,CAAC;QAEF,0CAA0C;QAC1C,IAAI,iBAAiB,GAAG,CAAC,IAAI,0BAA0B,GAAG,CAAC,EAAE,CAAC;YAC5D,4CAA4C;YAC5C,MAAM,sBAAsB,GAC1B,0BAA0B,GAAG,iBAAiB,CAAC;YACjD,6DAA6D;YAC7D,KAAK,CAAC,iBAAiB,GAAG,IAAI,CAAC,KAAK,CAAC,sBAAsB,GAAG,GAAG,CAAC,CAAC;QACrE,CAAC;QAED,IAAI,KAAK,CAAC,gBAAgB,EAAE,CAAC;YAC3B,KAAK,CAAC,yCAAyC,GAAG,IAAI,CAAC,KAAK,CAC1D,KAAK,CAAC,gBAAgB,CACvB,CAAC;YACF,OAAO,KAAK,CAAC,gBAAgB,CAAC;QAChC,CAAC;QAED,IAAI,KAAK,CAAC,cAAc,EAAE,CAAC;YACzB,OAAO,KAAK,CAAC,cAAc,CAAC;QAC9B,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC;IACpB,CAAC,CAAC,CAAC;IAEH,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/commonjs/tools/directions-tool/formatIsoDateTime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatIsoDateTime.d.ts","sourceRoot":"","sources":["../../../../src/tools/directions-tool/formatIsoDateTime.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAAI,UAAU,MAAM,KAAG,MAWpD,CAAC"}

package/dist/commonjs/tools/directions-tool/formatIsoDateTime.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatIsoDateTime = void 0;
+/**
+ * Helper function to format ISO datetime strings according to Mapbox API requirements.
+ * It converts the format YYYY-MM-DDThh:mm:ss (with seconds but no timezone) to
+ * YYYY-MM-DDThh:mm (no seconds, no timezone) by removing the seconds part.
+ * Other valid formats are left unchanged.
+ */
+const formatIsoDateTime = (dateTime) => {
+    // Regex for matching YYYY-MM-DDThh:mm:ss format (with seconds but no timezone)
+    const dateWithSecondsNoTz = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}$/;
+    if (dateWithSecondsNoTz.test(dateTime)) {
+        // Extract up to the minutes part only, dropping the seconds
+        return dateTime.substring(0, dateTime.lastIndexOf(':'));
+    }
+    // Return unchanged if it's already in a valid format
+    return dateTime;
+};
+exports.formatIsoDateTime = formatIsoDateTime;
+//# sourceMappingURL=formatIsoDateTime.js.map

package/dist/commonjs/tools/directions-tool/formatIsoDateTime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatIsoDateTime.js","sourceRoot":"","sources":["../../../../src/tools/directions-tool/formatIsoDateTime.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACI,MAAM,iBAAiB,GAAG,CAAC,QAAgB,EAAU,EAAE;IAC5D,+EAA+E;IAC/E,MAAM,mBAAmB,GAAG,uCAAuC,CAAC;IAEpE,IAAI,mBAAmB,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QACvC,4DAA4D;QAC5D,OAAO,QAAQ,CAAC,SAAS,CAAC,CAAC,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1D,CAAC;IAED,qDAAqD;IACrD,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC;AAXW,QAAA,iBAAiB,qBAW5B"}

package/dist/{tools → commonjs/tools}/forward-geocode-tool/ForwardGeocodeTool.d.ts

@@ -46,7 +46,6 @@ declare const ForwardGeocodeInputSchema: z.ZodObject<{
     permanent: boolean;
     autocomplete: boolean;
     worldview: "us" | "cn" | "jp" | "in";
-    country?: string[] | undefined;
     language?: string | undefined;
     proximity?: "ip" | {
         longitude: number;
@@ -61,10 +60,10 @@ declare const ForwardGeocodeInputSchema: z.ZodObject<{
         maxLongitude: number;
         maxLatitude: number;
     } | undefined;
+    country?: string[] | undefined;
     types?: ("country" | "region" | "postcode" | "district" | "place" | "locality" | "neighborhood" | "address")[] | undefined;
 }, {
     q: string;
-    country?: string[] | undefined;
     language?: string | undefined;
     limit?: number | undefined;
     proximity?: string | {
@@ -77,6 +76,7 @@ declare const ForwardGeocodeInputSchema: z.ZodObject<{
         maxLongitude: number;
         maxLatitude: number;
     } | undefined;
+    country?: string[] | undefined;
     format?: "json_string" | "formatted_text" | undefined;
     permanent?: boolean | undefined;
     autocomplete?: boolean | undefined;
@@ -84,11 +84,12 @@ declare const ForwardGeocodeInputSchema: z.ZodObject<{
     worldview?: "us" | "cn" | "jp" | "in" | undefined;
 }>;
 export declare class ForwardGeocodeTool extends MapboxApiBasedTool<typeof ForwardGeocodeInputSchema> {
+    private fetch;
     name: string;
     description: string;
-    constructor();
+    constructor(fetch?: typeof globalThis.fetch);
     private formatGeoJsonToText;
-    protected execute(input: z.infer<typeof ForwardGeocodeInputSchema>): Promise<{
+    protected execute(input: z.infer<typeof ForwardGeocodeInputSchema>, accessToken: string): Promise<{
         type: 'text';
         text: string;
     }>;

package/dist/commonjs/tools/forward-geocode-tool/ForwardGeocodeTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ForwardGeocodeTool.d.ts","sourceRoot":"","sources":["../../../../src/tools/forward-geocode-tool/ForwardGeocodeTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAG9D,QAAA,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiI7B,CAAC;AAEH,qBAAa,kBAAmB,SAAQ,kBAAkB,CACxD,OAAO,yBAAyB,CACjC;IAKa,OAAO,CAAC,KAAK;IAJzB,IAAI,SAA0B;IAC9B,WAAW,SAC4Z;gBAEnZ,KAAK,GAAE,OAAO,UAAU,CAAC,KAAmB;IAIhE,OAAO,CAAC,mBAAmB;cA+CX,OAAO,CACrB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,EAChD,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CAmE3C"}

package/dist/commonjs/tools/forward-geocode-tool/ForwardGeocodeTool.js

@@ -0,0 +1,212 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ForwardGeocodeTool = void 0;
+const zod_1 = require("zod");
+const MapboxApiBasedTool_js_1 = require("../MapboxApiBasedTool.js");
+const fetchRequest_js_1 = require("../../utils/fetchRequest.js");
+const ForwardGeocodeInputSchema = zod_1.z.object({
+    q: zod_1.z
+        .string()
+        .max(256)
+        .refine((val) => !val.includes(';'), 'Search text cannot contain semicolons')
+        .refine((val) => val.split(/\s+/).length <= 20, 'Search text cannot exceed 20 words')
+        .describe('Search text to geocode. Max 256 characters, 20 words, no semicolons.'),
+    permanent: zod_1.z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe('Whether results can be stored permanently'),
+    autocomplete: zod_1.z
+        .boolean()
+        .optional()
+        .default(true)
+        .describe('Return partial/suggested results for partial queries'),
+    bbox: zod_1.z
+        .object({
+        minLongitude: zod_1.z.number().min(-180).max(180),
+        minLatitude: zod_1.z.number().min(-90).max(90),
+        maxLongitude: zod_1.z.number().min(-180).max(180),
+        maxLatitude: zod_1.z.number().min(-90).max(90)
+    })
+        .optional()
+        .describe('Bounding box to limit results within specified bounds'),
+    country: zod_1.z
+        .array(zod_1.z.string().length(2))
+        .optional()
+        .describe('Array of ISO 3166 alpha 2 country codes to limit results'),
+    format: zod_1.z
+        .enum(['json_string', 'formatted_text'])
+        .optional()
+        .default('formatted_text')
+        .describe('Output format: "json_string" returns raw GeoJSON data as a JSON string that can be parsed; "formatted_text" returns human-readable text with place names, addresses, and coordinates. Both return as text content but json_string contains parseable JSON data while formatted_text is for display.'),
+    language: zod_1.z
+        .string()
+        .optional()
+        .describe('IETF language tag for the response (e.g., "en", "es", "fr", "de", "ja")'),
+    limit: zod_1.z
+        .number()
+        .min(1)
+        .max(10)
+        .optional()
+        .default(5)
+        .describe('Maximum number of results to return (1-10)'),
+    proximity: zod_1.z
+        .union([
+        zod_1.z.object({
+            longitude: zod_1.z.number().min(-180).max(180),
+            latitude: zod_1.z.number().min(-90).max(90)
+        }),
+        zod_1.z.string().transform((val) => {
+            // Handle special case of 'ip'
+            if (val === 'ip') {
+                return 'ip';
+            }
+            // Handle JSON-stringified object: "{\"longitude\": -82.458107, \"latitude\": 27.937259}"
+            if (val.startsWith('{') && val.endsWith('}')) {
+                try {
+                    const parsed = JSON.parse(val);
+                    if (typeof parsed === 'object' &&
+                        parsed !== null &&
+                        typeof parsed.longitude === 'number' &&
+                        typeof parsed.latitude === 'number') {
+                        return { longitude: parsed.longitude, latitude: parsed.latitude };
+                    }
+                }
+                catch {
+                    // Fall back to other formats
+                }
+            }
+            // Handle string that looks like an array: "[-82.451668, 27.942964]"
+            if (val.startsWith('[') && val.endsWith(']')) {
+                const coords = val
+                    .slice(1, -1)
+                    .split(',')
+                    .map((s) => Number(s.trim()));
+                if (coords.length === 2 && !isNaN(coords[0]) && !isNaN(coords[1])) {
+                    return { longitude: coords[0], latitude: coords[1] };
+                }
+            }
+            // Handle comma-separated string: "-82.451668,27.942964"
+            const parts = val.split(',').map((s) => Number(s.trim()));
+            if (parts.length === 2 && !isNaN(parts[0]) && !isNaN(parts[1])) {
+                return { longitude: parts[0], latitude: parts[1] };
+            }
+            throw new Error('Invalid proximity format. Expected {longitude, latitude}, "longitude,latitude", or "ip"');
+        })
+    ])
+        .optional()
+        .describe('Location to bias results towards. Either [longitude, latitude] coordinates or "ip" for IP-based location. Can help get more relevant results when searching in a specific area.'),
+    types: zod_1.z
+        .array(zod_1.z.enum([
+        'country',
+        'region',
+        'postcode',
+        'district',
+        'place',
+        'locality',
+        'neighborhood',
+        'address'
+    ]))
+        .optional()
+        .describe('Array of feature types to filter results'),
+    worldview: zod_1.z
+        .enum(['us', 'cn', 'jp', 'in'])
+        .optional()
+        .default('us')
+        .describe('Returns features from a specific regional perspective')
+});
+class ForwardGeocodeTool extends MapboxApiBasedTool_js_1.MapboxApiBasedTool {
+    fetch;
+    name = 'forward_geocode_tool';
+    description = 'This tool converts addresses, cities, towns, neighborhoods, districts, postcodes, regions, and countries into geographic coordinates using Mapbox Geocoding API v6. Setting a proximity point helps to bias results towards a specific area for more relevant results. Do not use this tool for geocoding points of interest like businesses, landmarks, historic sites, museums, etc. Supports both JSON and text output formats.';
+    constructor(fetch = fetchRequest_js_1.fetchClient) {
+        super({ inputSchema: ForwardGeocodeInputSchema });
+        this.fetch = fetch;
+    }
+    formatGeoJsonToText(geoJsonResponse) {
+        if (!geoJsonResponse ||
+            !geoJsonResponse.features ||
+            geoJsonResponse.features.length === 0) {
+            return 'No results found.';
+        }
+        const results = geoJsonResponse.features.map((feature, index) => {
+            const props = feature.properties || {};
+            const geom = feature.geometry || {};
+            let result = `${index + 1}. `;
+            // Place name
+            result += `${props.name}`;
+            if (props.name_preferred) {
+                result += ` (${props.name_preferred})`;
+            }
+            // Full address
+            if (props.full_address) {
+                result += `\n   Address: ${props.full_address}`;
+            }
+            else if (props.place_formatted) {
+                result += `\n   Address: ${props.place_formatted}`;
+            }
+            // Geographic coordinates
+            if (geom.coordinates && Array.isArray(geom.coordinates)) {
+                const [lng, lat] = geom.coordinates;
+                result += `\n   Coordinates: ${lat}, ${lng}`;
+            }
+            // Feature type
+            if (props.feature_type) {
+                result += `\n   Type: ${props.feature_type}`;
+            }
+            return result;
+        });
+        return results.join('\n\n');
+    }
+    async execute(input, accessToken) {
+        const url = new URL(`${MapboxApiBasedTool_js_1.MapboxApiBasedTool.mapboxApiEndpoint}search/geocode/v6/forward`);
+        // Required parameters
+        url.searchParams.append('q', input.q);
+        url.searchParams.append('access_token', accessToken);
+        // Optional parameters
+        url.searchParams.append('permanent', input.permanent.toString());
+        url.searchParams.append('autocomplete', input.autocomplete.toString());
+        url.searchParams.append('format', 'geojson');
+        url.searchParams.append('limit', input.limit.toString());
+        url.searchParams.append('worldview', input.worldview);
+        if (input.bbox) {
+            const { minLongitude, minLatitude, maxLongitude, maxLatitude } = input.bbox;
+            url.searchParams.append('bbox', `${minLongitude},${minLatitude},${maxLongitude},${maxLatitude}`);
+        }
+        if (input.country && input.country.length > 0) {
+            url.searchParams.append('country', input.country.join(','));
+        }
+        if (input.language) {
+            url.searchParams.append('language', input.language);
+        }
+        if (input.proximity) {
+            if (input.proximity === 'ip') {
+                url.searchParams.append('proximity', 'ip');
+            }
+            else {
+                const { longitude, latitude } = input.proximity;
+                url.searchParams.append('proximity', `${longitude},${latitude}`);
+            }
+        }
+        if (input.types && input.types.length > 0) {
+            url.searchParams.append('types', input.types.join(','));
+        }
+        const response = await this.fetch(url.toString());
+        if (!response.ok) {
+            throw new Error(`Failed to geocode: ${response.status} ${response.statusText}`);
+        }
+        const data = (await response.json());
+        // Check if the response has features
+        if (!data || !data.features || data.features.length === 0) {
+            return { type: 'text', text: 'No results found.' };
+        }
+        if (input.format === 'json_string') {
+            return { type: 'text', text: JSON.stringify(data, null, 2) };
+        }
+        else {
+            return { type: 'text', text: this.formatGeoJsonToText(data) };
+        }
+    }
+}
+exports.ForwardGeocodeTool = ForwardGeocodeTool;
+//# sourceMappingURL=ForwardGeocodeTool.js.map

package/dist/commonjs/tools/forward-geocode-tool/ForwardGeocodeTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ForwardGeocodeTool.js","sourceRoot":"","sources":["../../../../src/tools/forward-geocode-tool/ForwardGeocodeTool.ts"],"names":[],"mappings":"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"}

package/dist/{tools → commonjs/tools}/isochrone-tool/IsochroneTool.d.ts

@@ -52,8 +52,9 @@ declare const IsochroneInputSchema: z.ZodObject<{
 export declare class IsochroneTool extends MapboxApiBasedTool<typeof IsochroneInputSchema> {
     name: string;
     description: string;
-    constructor();
-    protected execute(input: z.infer<typeof IsochroneInputSchema>): Promise<any>;
+    private fetch;
+    constructor(fetch?: typeof globalThis.fetch);
+    protected execute(input: z.infer<typeof IsochroneInputSchema>, accessToken: string): Promise<any>;
 }
 export {};
 //# sourceMappingURL=IsochroneTool.d.ts.map

package/dist/commonjs/tools/isochrone-tool/IsochroneTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IsochroneTool.d.ts","sourceRoot":"","sources":["../../../../src/tools/isochrone-tool/IsochroneTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAG9D,QAAA,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgFxB,CAAC;AAEH,qBAAa,aAAc,SAAQ,kBAAkB,CACnD,OAAO,oBAAoB,CAC5B;IACC,IAAI,SAAoB;IACxB,WAAW,SAIuD;IAElE,OAAO,CAAC,KAAK,CAA0B;gBAE3B,KAAK,GAAE,OAAO,UAAU,CAAC,KAAmB;cAKxC,OAAO,CACrB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,EAC3C,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,GAAG,CAAC;CA0DhB"}

package/dist/commonjs/tools/isochrone-tool/IsochroneTool.js

@@ -0,0 +1,118 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IsochroneTool = void 0;
+const zod_1 = require("zod");
+const MapboxApiBasedTool_js_1 = require("../MapboxApiBasedTool.js");
+const fetchRequest_js_1 = require("../../utils/fetchRequest.js");
+const IsochroneInputSchema = zod_1.z.object({
+    profile: zod_1.z
+        .enum([
+        'mapbox/driving-traffic',
+        'mapbox/driving',
+        'mapbox/cycling',
+        'mapbox/walking'
+    ])
+        .default('mapbox/driving-traffic')
+        .describe('Mode of travel.'),
+    coordinates: zod_1.z
+        .object({
+        longitude: zod_1.z.number().min(-180).max(180),
+        latitude: zod_1.z.number().min(-90).max(90)
+    })
+        .describe('A coordinate object with longitude and latitude properties around which to center the isochrone lines. Longitude: -180 to 180, Latitude: -85.0511 to 85.0511'),
+    contours_minutes: zod_1.z
+        .array(zod_1.z.number().int().min(1).max(60))
+        .max(4)
+        .optional()
+        .describe('Contour times in minutes. Times must be in increasing order. Must be specified either contours_minutes or contours_meters.'),
+    contours_meters: zod_1.z
+        .array(zod_1.z.number().int().min(1).max(100000))
+        .max(4)
+        .optional()
+        .describe('Distances in meters. Distances must be in increasing order. Must be specified either contours_minutes or contours_meters.'),
+    contours_colors: zod_1.z
+        .array(zod_1.z.string().regex(/^[0-9a-fA-F]{6}$/))
+        .max(4)
+        .optional()
+        .describe('Contour colors as hex strings without starting # (for example ff0000 for red. must match contours_minutes or contours_meters length if provided).'),
+    polygons: zod_1.z
+        .boolean()
+        .default(false)
+        .optional()
+        .describe('Whether to return Polygons (true) or LineStrings (false).'),
+    denoise: zod_1.z
+        .number()
+        .min(0)
+        .max(1)
+        .default(1)
+        .optional()
+        .describe('A floating point value that can be used to remove smaller contours. A value of 1.0 will only return the largest contour for a given value.'),
+    generalize: zod_1.z
+        .number()
+        .min(0)
+        .describe(`Positive number in meters that is used to simplify geometries.
+        - Walking: use 0-500. Prefer 50-200 for short contours (minutes < 10 or meters < 5000), 300-500 as they grow.
+        - Driving: use 1000-5000. Start at 2000, use 3000 if minutes > 10 or meters > 20000. Use 4000-5000 if near 60 minutes or 100000 meters.
+      `.trim()),
+    exclude: zod_1.z
+        .array(zod_1.z.enum(['motorway', 'toll', 'ferry', 'unpaved', 'cash_only_tolls']))
+        .optional()
+        .describe('Exclude certain road types and custom locations from routing.'),
+    depart_at: zod_1.z
+        .string()
+        .optional()
+        .describe('An ISO 8601 date-time string representing the time to depart (format string: YYYY-MM-DDThh:mmss±hh:mm).')
+});
+class IsochroneTool extends MapboxApiBasedTool_js_1.MapboxApiBasedTool {
+    name = 'isochrone_tool';
+    description = `Computes areas that are reachable within a specified amount of time from a location, and returns the reachable regions as contours of Polygons or LineStrings in GeoJSON format that you can display on a map.
+  Common use cases:
+    - Show a user how far they can travel in X minutes from their current location
+    - Determine whether a destination is within a certain travel time threshold
+    - Compare travel ranges for different modes of transportation'`;
+    fetch;
+    constructor(fetch = fetchRequest_js_1.fetchClient) {
+        super({ inputSchema: IsochroneInputSchema });
+        this.fetch = fetch;
+    }
+    async execute(input, accessToken) {
+        const url = new URL(`${MapboxApiBasedTool_js_1.MapboxApiBasedTool.mapboxApiEndpoint}isochrone/v1/${input.profile}/${input.coordinates.longitude}%2C${input.coordinates.latitude}`);
+        url.searchParams.append('access_token', accessToken);
+        if ((!input.contours_minutes || input.contours_minutes.length === 0) &&
+            (!input.contours_meters || input.contours_meters.length === 0)) {
+            throw new Error("At least one of 'contours_minutes' or 'contours_meters' must be provided");
+        }
+        if (input.contours_minutes && input.contours_minutes.length > 0) {
+            url.searchParams.append('contours_minutes', input.contours_minutes.join(','));
+        }
+        if (input.contours_meters && input.contours_meters.length > 0) {
+            url.searchParams.append('contours_meters', input.contours_meters?.join(','));
+        }
+        if (input.contours_colors && input.contours_colors.length > 0) {
+            url.searchParams.append('contours_colors', input.contours_colors.join(','));
+        }
+        if (input.polygons) {
+            url.searchParams.append('polygons', String(input.polygons));
+        }
+        if (input.denoise) {
+            url.searchParams.append('denoise', String(input.denoise));
+        }
+        if (input.generalize) {
+            url.searchParams.append('generalize', String(input.generalize));
+        }
+        if (input.exclude && input.exclude.length > 0) {
+            url.searchParams.append('exclude', input.exclude.join(','));
+        }
+        if (input.depart_at) {
+            url.searchParams.append('depart_at', input.depart_at);
+        }
+        const response = await this.fetch(url);
+        if (!response.ok) {
+            throw new Error(`Failed to calculate isochrones: ${response.status} ${response.statusText}`);
+        }
+        const data = await response.json();
+        return data;
+    }
+}
+exports.IsochroneTool = IsochroneTool;
+//# sourceMappingURL=IsochroneTool.js.map

package/dist/commonjs/tools/isochrone-tool/IsochroneTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IsochroneTool.js","sourceRoot":"","sources":["../../../../src/tools/isochrone-tool/IsochroneTool.ts"],"names":[],"mappings":"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"}