onebusaway-mcp-server 0.1.1

package/dist/mcp-server/resources/definitions/stop.resource.js

@@ -0,0 +1,33 @@
+/**
+ * @fileoverview OneBusAway stop metadata resource.
+ * @module mcp-server/resources/definitions/stop.resource
+ */
+import { resource, z } from '@cyanheads/mcp-ts-core';
+import { getOneBusAwayService } from '../../../services/onebusaway/onebusaway-service.js';
+export const stopResource = resource('onebusaway://stop/{stopId}', {
+    name: 'onebusaway-stop',
+    title: 'OneBusAway Stop',
+    description: 'Stop metadata — name, coordinates, served routes, and wheelchair accessibility. Stop IDs use agency-prefixed format: {agencyId}_{localId} (e.g. "1_75403").',
+    mimeType: 'application/json',
+    params: z.object({
+        stopId: z
+            .string()
+            .describe('Agency-prefixed stop ID (e.g. "1_75403" for Metro Transit stop 75403).'),
+    }),
+    async handler(params, ctx) {
+        ctx.log.debug('stopResource handler', { stopId: params.stopId });
+        const stop = await getOneBusAwayService().getStop(params.stopId, ctx);
+        return stop;
+    },
+    list: async () => ({
+        resources: [
+            {
+                uri: 'onebusaway://stop/1_75403',
+                name: 'Example: Metro Transit Stop 75403',
+                mimeType: 'application/json',
+                description: 'Stop metadata for Metro Transit stop 75403 (Puget Sound instance).',
+            },
+        ],
+    }),
+});
+//# sourceMappingURL=stop.resource.js.map

package/dist/mcp-server/resources/definitions/stop.resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop.resource.js","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/stop.resource.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,6CAA6C,CAAC;AAEnF,MAAM,CAAC,MAAM,YAAY,GAAG,QAAQ,CAAC,4BAA4B,EAAE;IACjE,IAAI,EAAE,iBAAiB;IACvB,KAAK,EAAE,iBAAiB;IACxB,WAAW,EACT,6JAA6J;IAC/J,QAAQ,EAAE,kBAAkB;IAC5B,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,MAAM,EAAE,CAAC;aACN,MAAM,EAAE;aACR,QAAQ,CAAC,wEAAwE,CAAC;KACtF,CAAC;IAEF,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG;QACvB,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,sBAAsB,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;QACjE,MAAM,IAAI,GAAG,MAAM,oBAAoB,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QACtE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;QACjB,SAAS,EAAE;YACT;gBACE,GAAG,EAAE,2BAA2B;gBAChC,IAAI,EAAE,mCAAmC;gBACzC,QAAQ,EAAE,kBAAkB;gBAC5B,WAAW,EAAE,oEAAoE;aAClF;SACF;KACF,CAAC;CACH,CAAC,CAAC"}

package/dist/mcp-server/tools/definitions/find-routes.tool.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @fileoverview Find transit routes near a geographic location.
+ * @module mcp-server/tools/definitions/find-routes.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+export declare const findRoutes: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    lat: z.ZodNumber;
+    lon: z.ZodNumber;
+    radius: z.ZodDefault<z.ZodNumber>;
+    query: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    routes: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        shortName: z.ZodString;
+        longName: z.ZodString;
+        description: z.ZodString;
+        agencyId: z.ZodString;
+        agencyName: z.ZodString;
+        type: z.ZodNumber;
+        color: z.ZodNullable<z.ZodString>;
+        url: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>, undefined>;
+//# sourceMappingURL=find-routes.tool.d.ts.map

package/dist/mcp-server/tools/definitions/find-routes.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-routes.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/find-routes.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAGjD,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;6BAuErB,CAAC"}

package/dist/mcp-server/tools/definitions/find-routes.tool.js

@@ -0,0 +1,72 @@
+/**
+ * @fileoverview Find transit routes near a geographic location.
+ * @module mcp-server/tools/definitions/find-routes.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { getOneBusAwayService } from '../../../services/onebusaway/onebusaway-service.js';
+export const findRoutes = tool('onebusaway_find_routes', {
+    title: 'Find Routes Near Location',
+    description: 'Find transit routes near a location, optionally filtered by name or number. Returns routes with IDs, short names, and descriptions. Use routeId values to fetch schedules, vehicles, or stop sequences.',
+    annotations: { readOnlyHint: true },
+    input: z.object({
+        lat: z.number().describe('Latitude of the search center.'),
+        lon: z.number().describe('Longitude of the search center.'),
+        radius: z.number().default(500).describe('Search radius in meters. Defaults to 500m.'),
+        query: z
+            .string()
+            .optional()
+            .describe('Filter by route name or number (e.g. "44" or "Link Light Rail").'),
+    }),
+    output: z.object({
+        routes: z
+            .array(z
+            .object({
+            id: z
+                .string()
+                .describe('Agency-prefixed route ID (e.g. "1_100259"). Use with onebusaway_get_schedule_for_route or onebusaway_get_vehicles.'),
+            shortName: z
+                .string()
+                .describe('The number or short name displayed on vehicles (e.g. "44").'),
+            longName: z.string().describe('Full route name.'),
+            description: z.string().describe('Route description.'),
+            agencyId: z.string().describe('Agency ID that operates this route.'),
+            agencyName: z.string().describe('Agency name that operates this route.'),
+            type: z
+                .number()
+                .describe('GTFS route type: 0=tram, 1=subway, 2=rail, 3=bus, 4=ferry, 5=cable_car.'),
+            color: z.string().nullable().describe('Route brand color hex (without #), or null.'),
+            url: z.string().nullable().describe('Agency schedule page URL, or null.'),
+        })
+            .describe('A transit route with agency and type information.'))
+            .describe('Routes found near the specified location.'),
+    }),
+    async handler(input, ctx) {
+        const routes = await getOneBusAwayService().findRoutes({
+            lat: input.lat,
+            lon: input.lon,
+            radius: input.radius,
+            ...(input.query && { query: input.query }),
+        }, ctx);
+        ctx.log.info('findRoutes completed', { count: routes.length });
+        return { routes };
+    },
+    format: (result) => {
+        if (result.routes.length === 0) {
+            return [{ type: 'text', text: 'No routes found near this location.' }];
+        }
+        const lines = [`**Routes found:** ${result.routes.length}`];
+        for (const r of result.routes) {
+            lines.push(`\n## ${r.shortName}${r.longName ? ` — ${r.longName}` : ''}`);
+            lines.push(`**ID:** ${r.id} | **Agency:** ${r.agencyName} (${r.agencyId})`);
+            if (r.description)
+                lines.push(`**Description:** ${r.description}`);
+            lines.push(`**Type:** ${r.type}`);
+            if (r.color)
+                lines.push(`**Color:** #${r.color}`);
+            if (r.url)
+                lines.push(`**Schedule URL:** ${r.url}`);
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=find-routes.tool.js.map

package/dist/mcp-server/tools/definitions/find-routes.tool.js.map

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

package/dist/mcp-server/tools/definitions/find-stops.tool.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @fileoverview Find bus stops near a geographic location.
+ * @module mcp-server/tools/definitions/find-stops.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+export declare const findStops: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    lat: z.ZodNumber;
+    lon: z.ZodNumber;
+    radius: z.ZodDefault<z.ZodNumber>;
+    query: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    stops: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        code: z.ZodString;
+        name: z.ZodString;
+        lat: z.ZodNumber;
+        lon: z.ZodNumber;
+        direction: z.ZodString;
+        routeIds: z.ZodArray<z.ZodString>;
+        wheelchairBoarding: z.ZodEnum<{
+            ACCESSIBLE: "ACCESSIBLE";
+            NOT_ACCESSIBLE: "NOT_ACCESSIBLE";
+            UNKNOWN: "UNKNOWN";
+        }>;
+    }, z.core.$strip>>;
+    limitExceeded: z.ZodBoolean;
+}, z.core.$strip>, undefined>;
+//# sourceMappingURL=find-stops.tool.d.ts.map

package/dist/mcp-server/tools/definitions/find-stops.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-stops.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/find-stops.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAGjD,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;6BAgFpB,CAAC"}

package/dist/mcp-server/tools/definitions/find-stops.tool.js

@@ -0,0 +1,76 @@
+/**
+ * @fileoverview Find bus stops near a geographic location.
+ * @module mcp-server/tools/definitions/find-stops.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { getOneBusAwayService } from '../../../services/onebusaway/onebusaway-service.js';
+export const findStops = tool('onebusaway_find_stops', {
+    title: 'Find Stops Near Location',
+    description: 'Find bus stops near a location. Returns stops within a radius, each with ID, name, direction, served routes, and wheelchair boarding status. Use stopId values from results to fetch real-time arrivals with onebusaway_get_arrivals. Optionally filter by stop code (the number printed on the stop sign, e.g. "75403").',
+    annotations: { readOnlyHint: true },
+    input: z.object({
+        lat: z.number().describe('Latitude of the search center.'),
+        lon: z.number().describe('Longitude of the search center.'),
+        radius: z
+            .number()
+            .default(300)
+            .describe('Search radius in meters. Defaults to 300m. Max ~1600m before results degrade.'),
+        query: z
+            .string()
+            .optional()
+            .describe('Optional stop code filter (the number printed on the stop sign, e.g. "75403"). When provided, returns only stops matching this code within the radius.'),
+    }),
+    output: z.object({
+        stops: z
+            .array(z
+            .object({
+            id: z
+                .string()
+                .describe('Agency-prefixed stop ID (e.g. "1_75403"). Use with onebusaway_get_arrivals.'),
+            code: z.string().describe('The stop code printed on the sign.'),
+            name: z.string().describe('Stop name.'),
+            lat: z.number().describe('Latitude of the stop.'),
+            lon: z.number().describe('Longitude of the stop.'),
+            direction: z.string().describe('Compass direction of travel at this stop (e.g. "NW").'),
+            routeIds: z.array(z.string()).describe('IDs of routes that serve this stop.'),
+            wheelchairBoarding: z
+                .enum(['ACCESSIBLE', 'NOT_ACCESSIBLE', 'UNKNOWN'])
+                .describe('Wheelchair boarding status.'),
+        })
+            .describe('A transit stop with location and route information.'))
+            .describe('Stops within the search radius.'),
+        limitExceeded: z
+            .boolean()
+            .describe('True if more stops exist beyond the returned set; narrow the radius to see all.'),
+    }),
+    async handler(input, ctx) {
+        const result = await getOneBusAwayService().findStops({
+            lat: input.lat,
+            lon: input.lon,
+            radius: input.radius,
+            ...(input.query && { query: input.query }),
+        }, ctx);
+        ctx.log.info('findStops completed', {
+            count: result.stops.length,
+            limitExceeded: result.limitExceeded,
+        });
+        return result;
+    },
+    format: (result) => {
+        const lines = [
+            `**Stops found:** ${result.stops.length} | **Limit exceeded:** ${result.limitExceeded}`,
+        ];
+        if (result.limitExceeded) {
+            lines.push('> Results truncated — narrow the radius to see all stops.');
+        }
+        for (const s of result.stops) {
+            lines.push(`\n## ${s.name}`);
+            lines.push(`**ID:** ${s.id} | **Code:** ${s.code} | **Direction:** ${s.direction}`);
+            lines.push(`**Coordinates:** ${s.lat.toFixed(6)}, ${s.lon.toFixed(6)}`);
+            lines.push(`**Routes:** ${s.routeIds.join(', ') || 'none'}`);
+            lines.push(`**Wheelchair:** ${s.wheelchairBoarding}`);
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=find-stops.tool.js.map

package/dist/mcp-server/tools/definitions/find-stops.tool.js.map

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

package/dist/mcp-server/tools/definitions/get-arrivals.tool.d.ts

@@ -0,0 +1,49 @@
+/**
+ * @fileoverview Real-time arrivals and departures at a stop.
+ * @module mcp-server/tools/definitions/get-arrivals.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const getArrivals: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    stopId: z.ZodString;
+    minutesBefore: z.ZodDefault<z.ZodNumber>;
+    minutesAfter: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    stopId: z.ZodString;
+    stopName: z.ZodString;
+    currentTime: z.ZodNumber;
+    arrivals: z.ZodArray<z.ZodObject<{
+        routeShortName: z.ZodString;
+        tripHeadsign: z.ZodString;
+        predicted: z.ZodBoolean;
+        predictedArrivalTime: z.ZodNullable<z.ZodNumber>;
+        scheduledArrivalTime: z.ZodNumber;
+        scheduleDeviation: z.ZodNumber;
+        vehicleId: z.ZodNullable<z.ZodString>;
+        vehiclePosition: z.ZodNullable<z.ZodObject<{
+            lat: z.ZodNumber;
+            lon: z.ZodNumber;
+        }, z.core.$strip>>;
+        stopsAway: z.ZodNullable<z.ZodNumber>;
+        tripId: z.ZodString;
+        routeId: z.ZodString;
+        situationIds: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>;
+    situations: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        summary: z.ZodString;
+        description: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>, readonly [{
+    readonly reason: "stop_not_found";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "Stop ID does not exist on this instance.";
+    readonly recovery: "Search for the stop with onebusaway_find_stops or onebusaway_search_stops to get a valid ID.";
+}, {
+    readonly reason: "rate_limited";
+    readonly code: JsonRpcErrorCode.RateLimited;
+    readonly retryable: true;
+    readonly when: "API returned a rate limit response.";
+    readonly recovery: "Wait a moment and retry; the Puget Sound instance enforces ~20 req/min per IP.";
+}]>;
+//# sourceMappingURL=get-arrivals.tool.d.ts.map

package/dist/mcp-server/tools/definitions/get-arrivals.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-arrivals.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-arrivals.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAmBjE,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4KtB,CAAC"}

package/dist/mcp-server/tools/definitions/get-arrivals.tool.js

@@ -0,0 +1,176 @@
+/**
+ * @fileoverview Real-time arrivals and departures at a stop.
+ * @module mcp-server/tools/definitions/get-arrivals.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { getOneBusAwayService } from '../../../services/onebusaway/onebusaway-service.js';
+/** Format Unix milliseconds as a human-readable HH:MM time string. */
+function fmtTime(ms) {
+    const d = new Date(ms);
+    const h = d.getHours().toString().padStart(2, '0');
+    const m = d.getMinutes().toString().padStart(2, '0');
+    return `${h}:${m}`;
+}
+/** Format schedule deviation (seconds) as a readable label. */
+function fmtDeviation(seconds) {
+    if (seconds === 0)
+        return 'on time';
+    const abs = Math.abs(seconds);
+    const mins = Math.round(abs / 60);
+    return seconds > 0 ? `${mins} min late` : `${mins} min early`;
+}
+export const getArrivals = tool('onebusaway_get_arrivals', {
+    title: 'Get Real-Time Arrivals',
+    description: 'Real-time arrivals and departures at a stop. Returns predicted arrival times, schedule deviation (how many seconds late/early), vehicle positions, and any active service alerts. The predicted boolean on each arrival indicates whether GPS tracking backs the estimate — predicted=false means schedule-only. Use tripId from results for follow-up onebusaway_get_trip calls. Stop IDs use agency-prefixed format: {agencyId}_{localId} (e.g. "1_75403").',
+    annotations: { readOnlyHint: true },
+    input: z.object({
+        stopId: z
+            .string()
+            .min(1)
+            .describe('Agency-prefixed stop ID (e.g. "1_75403" for Metro Transit stop 75403). Use onebusaway_find_stops or onebusaway_search_stops to discover IDs.'),
+        minutesBefore: z
+            .number()
+            .default(5)
+            .describe('Include arrivals that departed up to this many minutes ago. Defaults to 5.'),
+        minutesAfter: z
+            .number()
+            .default(35)
+            .describe('Include arrivals expected within the next N minutes. Defaults to 35.'),
+    }),
+    output: z.object({
+        stopId: z.string().describe('The queried stop ID.'),
+        stopName: z.string().describe('Stop name.'),
+        currentTime: z
+            .number()
+            .describe('Server time as Unix milliseconds, for computing countdown timers.'),
+        arrivals: z
+            .array(z
+            .object({
+            routeShortName: z.string().describe('Route short name (e.g. "44").'),
+            tripHeadsign: z.string().describe('Destination sign text (e.g. "Downtown Seattle").'),
+            predicted: z
+                .boolean()
+                .describe('True if GPS-tracked real-time data is available; false if schedule-only.'),
+            predictedArrivalTime: z
+                .number()
+                .nullable()
+                .describe('Predicted arrival time as Unix milliseconds. Null when predicted=false.'),
+            scheduledArrivalTime: z
+                .number()
+                .describe('Scheduled arrival time as Unix milliseconds.'),
+            scheduleDeviation: z
+                .number()
+                .describe('Seconds late (positive) or early (negative). Only meaningful when predicted=true.'),
+            vehicleId: z.string().nullable().describe('Vehicle ID if known, or null.'),
+            vehiclePosition: z
+                .object({
+                lat: z.number().describe('Vehicle latitude.'),
+                lon: z.number().describe('Vehicle longitude.'),
+            })
+                .nullable()
+                .describe('Current vehicle position if available, or null.'),
+            stopsAway: z
+                .number()
+                .nullable()
+                .describe('Number of stops until this stop, or null if unknown.'),
+            tripId: z.string().describe('Trip ID for follow-up onebusaway_get_trip calls.'),
+            routeId: z.string().describe('Route ID for follow-up route calls.'),
+            situationIds: z
+                .array(z.string())
+                .describe('IDs of active service alerts affecting this arrival.'),
+        })
+            .describe('A single arrival or departure at this stop.'))
+            .describe('Arrivals and departures at this stop within the requested time window.'),
+        situations: z
+            .array(z
+            .object({
+            id: z.string().describe('Situation ID.'),
+            summary: z.string().describe('Short summary of the service alert.'),
+            description: z
+                .string()
+                .nullable()
+                .describe('Longer description of the service alert, or null.'),
+        })
+            .describe('A single active service alert.'))
+            .describe('Active service alerts referenced by arrivals at this stop.'),
+    }),
+    errors: [
+        {
+            reason: 'stop_not_found',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'Stop ID does not exist on this instance.',
+            recovery: 'Search for the stop with onebusaway_find_stops or onebusaway_search_stops to get a valid ID.',
+        },
+        {
+            reason: 'rate_limited',
+            code: JsonRpcErrorCode.RateLimited,
+            retryable: true,
+            when: 'API returned a rate limit response.',
+            recovery: 'Wait a moment and retry; the Puget Sound instance enforces ~20 req/min per IP.',
+        },
+    ],
+    async handler(input, ctx) {
+        const result = await getOneBusAwayService().getArrivals({
+            stopId: input.stopId,
+            minutesBefore: input.minutesBefore,
+            minutesAfter: input.minutesAfter,
+        }, ctx);
+        ctx.log.info('getArrivals completed', {
+            stopId: input.stopId,
+            count: result.arrivals.length,
+            situations: result.situations.length,
+        });
+        return result;
+    },
+    format: (result) => {
+        const lines = [
+            `## Arrivals at ${result.stopName} (${result.stopId})`,
+            `**Current time:** ${fmtTime(result.currentTime)} (${result.currentTime})`,
+            `**Arrivals:** ${result.arrivals.length}`,
+        ];
+        if (result.arrivals.length === 0) {
+            lines.push('\n_No arrivals in the requested time window._');
+        }
+        else {
+            for (const a of result.arrivals) {
+                const arrivalTime = a.predictedArrivalTime ?? a.scheduledArrivalTime;
+                const timeStr = fmtTime(arrivalTime);
+                const devStr = a.predicted ? ` (${fmtDeviation(a.scheduleDeviation)})` : ' (scheduled)';
+                lines.push(`\n### Route ${a.routeShortName} → ${a.tripHeadsign}`);
+                lines.push(`**Arrives:** ${timeStr}${devStr}`);
+                lines.push(`**Scheduled:** ${fmtTime(a.scheduledArrivalTime)} (${a.scheduledArrivalTime})`);
+                if (a.predictedArrivalTime != null) {
+                    lines.push(`**Predicted:** ${fmtTime(a.predictedArrivalTime)} (${a.predictedArrivalTime})`);
+                }
+                lines.push(`**Trip ID:** ${a.tripId} | **Route ID:** ${a.routeId}`);
+                if (a.stopsAway != null && a.stopsAway >= 0) {
+                    lines.push(`**Stops away:** ${a.stopsAway === 0 ? 'At stop' : a.stopsAway}`);
+                }
+                else if (a.stopsAway != null && a.stopsAway < 0) {
+                    lines.push(`**Stops away:** Arrived`);
+                }
+                if (a.vehicleId)
+                    lines.push(`**Vehicle:** ${a.vehicleId}`);
+                if (a.vehiclePosition) {
+                    lines.push(`**Vehicle position:** ${a.vehiclePosition.lat.toFixed(5)}, ${a.vehiclePosition.lon.toFixed(5)}`);
+                }
+                if (a.situationIds.length > 0) {
+                    lines.push(`**Alerts:** ${a.situationIds.join(', ')}`);
+                }
+                lines.push(`**GPS-tracked:** ${a.predicted}`);
+                lines.push(`**Schedule deviation:** ${fmtDeviation(a.scheduleDeviation)} (${a.scheduleDeviation}s)`);
+            }
+        }
+        if (result.situations.length > 0) {
+            lines.push('\n## Service Alerts');
+            for (const s of result.situations) {
+                lines.push(`\n### ${s.summary} (${s.id})`);
+                if (s.description)
+                    lines.push(s.description);
+            }
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=get-arrivals.tool.js.map

package/dist/mcp-server/tools/definitions/get-arrivals.tool.js.map

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

package/dist/mcp-server/tools/definitions/get-route.tool.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @fileoverview Fetch details for a specific route by ID.
+ * @module mcp-server/tools/definitions/get-route.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const getRoute: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    routeId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    shortName: z.ZodString;
+    longName: z.ZodString;
+    description: z.ZodString;
+    agencyId: z.ZodString;
+    agencyName: z.ZodString;
+    type: z.ZodNumber;
+    color: z.ZodNullable<z.ZodString>;
+    url: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>, readonly [{
+    readonly reason: "route_not_found";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "Route ID does not exist on this instance.";
+    readonly recovery: "Search for the route with onebusaway_find_routes or onebusaway_search_routes to get a valid ID.";
+}]>;
+//# sourceMappingURL=get-route.tool.d.ts.map

package/dist/mcp-server/tools/definitions/get-route.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-route.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-route.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAGjE,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;GAsDnB,CAAC"}

package/dist/mcp-server/tools/definitions/get-route.tool.js

@@ -0,0 +1,60 @@
+/**
+ * @fileoverview Fetch details for a specific route by ID.
+ * @module mcp-server/tools/definitions/get-route.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { getOneBusAwayService } from '../../../services/onebusaway/onebusaway-service.js';
+export const getRoute = tool('onebusaway_get_route', {
+    title: 'Get Route Details',
+    description: 'Fetch details for a specific route by ID. Returns short name, description, agency, route type, and schedule URL. Route IDs use agency-prefixed format: {agencyId}_{localId} (e.g. "1_100259").',
+    annotations: { readOnlyHint: true },
+    input: z.object({
+        routeId: z
+            .string()
+            .min(1)
+            .describe('Agency-prefixed route ID (e.g. "1_100259"). Use onebusaway_find_routes or onebusaway_search_routes to discover IDs.'),
+    }),
+    output: z.object({
+        id: z.string().describe('Agency-prefixed route ID.'),
+        shortName: z.string().describe('The number or short name displayed on vehicles (e.g. "44").'),
+        longName: z.string().describe('Full route name.'),
+        description: z.string().describe('Route description.'),
+        agencyId: z.string().describe('Agency ID that operates this route.'),
+        agencyName: z.string().describe('Agency name that operates this route.'),
+        type: z
+            .number()
+            .describe('GTFS route type: 0=tram, 1=subway, 2=rail, 3=bus, 4=ferry, 5=cable_car.'),
+        color: z.string().nullable().describe('Route brand color hex (without #), or null.'),
+        url: z.string().nullable().describe('Agency schedule page URL, or null.'),
+    }),
+    errors: [
+        {
+            reason: 'route_not_found',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'Route ID does not exist on this instance.',
+            recovery: 'Search for the route with onebusaway_find_routes or onebusaway_search_routes to get a valid ID.',
+        },
+    ],
+    async handler(input, ctx) {
+        const route = await getOneBusAwayService().getRoute(input.routeId, ctx);
+        ctx.log.info('getRoute completed', { routeId: input.routeId });
+        return route;
+    },
+    format: (result) => {
+        const lines = [
+            `## ${result.shortName}${result.longName ? ` — ${result.longName}` : ''}`,
+            `**ID:** ${result.id}`,
+            `**Agency:** ${result.agencyName} (${result.agencyId})`,
+        ];
+        if (result.description)
+            lines.push(`**Description:** ${result.description}`);
+        lines.push(`**Type:** ${result.type}`);
+        if (result.color)
+            lines.push(`**Color:** #${result.color}`);
+        if (result.url)
+            lines.push(`**Schedule URL:** ${result.url}`);
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=get-route.tool.js.map

package/dist/mcp-server/tools/definitions/get-route.tool.js.map

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

package/dist/mcp-server/tools/definitions/get-schedule-for-route.tool.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @fileoverview Full-day schedule for a route — all trips and stop sequences.
+ * @module mcp-server/tools/definitions/get-schedule-for-route.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const getScheduleForRoute: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    routeId: z.ZodString;
+    date: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    routeId: z.ZodString;
+    routeShortName: z.ZodString;
+    serviceDateMs: z.ZodNumber;
+    trips: z.ZodArray<z.ZodObject<{
+        tripId: z.ZodString;
+        tripHeadsign: z.ZodString;
+        serviceId: z.ZodString;
+        stops: z.ZodArray<z.ZodObject<{
+            stopId: z.ZodString;
+            stopName: z.ZodString;
+            arrivalTime: z.ZodNumber;
+            departureTime: z.ZodNumber;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>, readonly [{
+    readonly reason: "route_not_found";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "Route ID does not exist on this instance.";
+    readonly recovery: "Search for the route with onebusaway_find_routes or onebusaway_search_routes to get a valid ID.";
+}]>;
+//# sourceMappingURL=get-schedule-for-route.tool.d.ts.map

package/dist/mcp-server/tools/definitions/get-schedule-for-route.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-schedule-for-route.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-schedule-for-route.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAejE,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;GAuG9B,CAAC"}