mcp-travelcode 1.0.0

package/build/tools/search-flights.js

@@ -0,0 +1,82 @@
+import { z } from "zod";
+import { executeFlightSearch } from "../polling/flight-poller.js";
+import { formatFlightResults } from "../formatters/flight-formatter.js";
+function convertDate(isoDate) {
+    // YYYY-MM-DD → DD.MM.YYYY
+    const [year, month, day] = isoDate.split("-");
+    return `${day}.${month}.${year}`;
+}
+export const searchFlightsSchema = {
+    origin: z.string().describe("Departure airport or city IATA code (e.g. 'LHR', 'LON', 'JFK'). Use search_airports to find codes."),
+    destination: z.string().describe("Arrival airport or city IATA code (e.g. 'CDG', 'BCN', 'NYC'). Use search_airports to find codes."),
+    departure_date: z.string().describe("Departure date in YYYY-MM-DD format (e.g. '2026-03-15')"),
+    return_date: z.string().optional().describe("Return date in YYYY-MM-DD format for round-trip. Omit for one-way."),
+    cabin_class: z
+        .enum(["economy", "premium_economy", "business", "first"])
+        .default("economy")
+        .describe("Cabin class"),
+    adults: z.number().int().min(1).max(9).default(1).describe("Number of adult passengers"),
+    children: z.number().int().min(0).max(9).default(0).describe("Number of children (2-11 years)"),
+    infants: z.number().int().min(0).max(4).default(0).describe("Number of infants (under 2 years)"),
+    preferred_airlines: z
+        .array(z.string())
+        .optional()
+        .describe("Optional list of preferred airline IATA codes to filter results (e.g. ['BA', 'LH'])"),
+};
+export function registerSearchFlights(server, client, config) {
+    server.tool("search_flights", "Search for flights between two airports. Handles the full search process including waiting for results from multiple airline sources. May take 15-60 seconds. For round-trip, provide both departure and return dates. Returns top results sorted by price with a cache ID for follow-up filtering.", searchFlightsSchema, async ({ origin, destination, departure_date, return_date, cabin_class, adults, children, infants, preferred_airlines }, extra) => {
+        try {
+            const searchParams = {
+                locationFrom: origin.toUpperCase(),
+                locationTo: destination.toUpperCase(),
+                date: convertDate(departure_date),
+                dateEnd: return_date ? convertDate(return_date) : "",
+                cabinClass: cabin_class,
+                adults,
+                children,
+                infants,
+            };
+            if (preferred_airlines && preferred_airlines.length > 0) {
+                searchParams.airlines = preferred_airlines.map((a) => a.toUpperCase());
+            }
+            // Build progress callback using MCP progress notifications
+            const progressToken = extra._meta?.progressToken;
+            let onProgress;
+            if (progressToken !== undefined) {
+                onProgress = async (progress, total, message) => {
+                    await extra.sendNotification({
+                        method: "notifications/progress",
+                        params: { progressToken, progress, total, message },
+                    });
+                };
+            }
+            const result = await executeFlightSearch(client, searchParams, config, onProgress);
+            // Build passengers description
+            const parts = [];
+            if (adults > 0)
+                parts.push(`${adults} adult${adults > 1 ? "s" : ""}`);
+            if (children > 0)
+                parts.push(`${children} child${children > 1 ? "ren" : ""}`);
+            if (infants > 0)
+                parts.push(`${infants} infant${infants > 1 ? "s" : ""}`);
+            const text = formatFlightResults(result.response, result.cacheId, {
+                origin: origin.toUpperCase(),
+                destination: destination.toUpperCase(),
+                departureDate: departure_date,
+                returnDate: return_date,
+                cabinClass: cabin_class,
+                passengers: parts.join(", "),
+            }, result.completed);
+            return {
+                content: [{ type: "text", text }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error searching flights: ${error.message}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=search-flights.js.map

package/build/tools/search-hotel-locations.d.ts

@@ -0,0 +1,9 @@
+import { z } from "zod";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { TravelCodeApiClient } from "../client/api-client.js";
+export declare const searchHotelLocationsSchema: {
+    query: z.ZodString;
+    limit: z.ZodDefault<z.ZodNumber>;
+};
+export declare function registerSearchHotelLocations(server: McpServer, client: TravelCodeApiClient): void;
+//# sourceMappingURL=search-hotel-locations.d.ts.map

package/build/tools/search-hotel-locations.js

@@ -0,0 +1,23 @@
+import { z } from "zod";
+import { formatHotelLocations } from "../formatters/hotel-formatter.js";
+export const searchHotelLocationsSchema = {
+    query: z.string().describe("Search query — city, region, or hotel name (supports Cyrillic and Latin)"),
+    limit: z.number().int().min(1).max(50).default(15).describe("Max results to return"),
+};
+export function registerSearchHotelLocations(server, client) {
+    server.tool("search_hotel_locations", "Search for hotel locations (cities, regions, hotels) by name. Returns location IDs needed for hotel search.", searchHotelLocationsSchema, async ({ query, limit }) => {
+        try {
+            const data = await client.getWithTokenParam("/data/hotel-locations", { search: query, limit });
+            return {
+                content: [{ type: "text", text: formatHotelLocations(data) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error searching hotel locations: ${error.message}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=search-hotel-locations.js.map

package/build/tools/search-hotels.d.ts

@@ -0,0 +1,46 @@
+import { z } from "zod";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { TravelCodeApiClient } from "../client/api-client.js";
+export declare const searchHotelsSchema: {
+    location: z.ZodNumber;
+    checkin: z.ZodString;
+    checkout: z.ZodString;
+    country_code: z.ZodString;
+    guests: z.ZodArray<z.ZodObject<{
+        adults: z.ZodNumber;
+        children: z.ZodOptional<z.ZodNumber>;
+        childrenAges: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        adults: number;
+        children?: number | undefined;
+        childrenAges?: number[] | undefined;
+    }, {
+        adults: number;
+        children?: number | undefined;
+        childrenAges?: number[] | undefined;
+    }>, "many">;
+    sort: z.ZodDefault<z.ZodEnum<["recommend", "price"]>>;
+    offset: z.ZodDefault<z.ZodNumber>;
+    limit: z.ZodDefault<z.ZodNumber>;
+    filter: z.ZodOptional<z.ZodObject<{
+        minPrice: z.ZodOptional<z.ZodNumber>;
+        maxPrice: z.ZodOptional<z.ZodNumber>;
+        starRating: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+        boards: z.ZodOptional<z.ZodArray<z.ZodEnum<["RO", "BI", "LI", "DI", "HB", "FB", "AI"]>, "many">>;
+        payments: z.ZodOptional<z.ZodArray<z.ZodEnum<["full_refund"]>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        starRating?: number[] | undefined;
+        minPrice?: number | undefined;
+        maxPrice?: number | undefined;
+        boards?: ("RO" | "BI" | "LI" | "DI" | "HB" | "FB" | "AI")[] | undefined;
+        payments?: "full_refund"[] | undefined;
+    }, {
+        starRating?: number[] | undefined;
+        minPrice?: number | undefined;
+        maxPrice?: number | undefined;
+        boards?: ("RO" | "BI" | "LI" | "DI" | "HB" | "FB" | "AI")[] | undefined;
+        payments?: "full_refund"[] | undefined;
+    }>>;
+};
+export declare function registerSearchHotels(server: McpServer, client: TravelCodeApiClient): void;
+//# sourceMappingURL=search-hotels.d.ts.map

package/build/tools/search-hotels.js

@@ -0,0 +1,106 @@
+import { z } from "zod";
+import { formatHotelResults } from "../formatters/hotel-formatter.js";
+const guestSchema = z.object({
+    adults: z.number().int().min(1).max(4).describe("Number of adults (1-4)"),
+    children: z.number().int().min(0).max(3).optional().describe("Number of children (0-3)"),
+    childrenAges: z
+        .array(z.number().int().min(0).max(17))
+        .optional()
+        .describe("Array of child ages (0-17), required if children > 0"),
+});
+const filterSchema = z.object({
+    minPrice: z.number().int().optional().describe("Minimum price per night"),
+    maxPrice: z.number().int().optional().describe("Maximum price per night"),
+    starRating: z.array(z.number().int().min(1).max(5)).optional().describe("Hotel star ratings, e.g. [4, 5]"),
+    boards: z
+        .array(z.enum(["RO", "BI", "LI", "DI", "HB", "FB", "AI"]))
+        .optional()
+        .describe("Meal plan codes: RO=Room Only, BI=Breakfast, HB=Half Board, FB=Full Board, AI=All Inclusive"),
+    payments: z
+        .array(z.enum(["full_refund"]))
+        .optional()
+        .describe("Payment filters: full_refund = only fully refundable"),
+}).optional();
+export const searchHotelsSchema = {
+    location: z
+        .number()
+        .int()
+        .describe("Location ID from search_hotel_locations. Positive = city/region, negative = single hotel"),
+    checkin: z.string().describe("Check-in date (YYYY-MM-DD)"),
+    checkout: z.string().describe("Check-out date (YYYY-MM-DD)"),
+    country_code: z.string().describe("Guest nationality ISO code (e.g. BY, RU, US)"),
+    guests: z.array(guestSchema).min(1).describe("Array of rooms, each with adults count and optional children"),
+    sort: z
+        .enum(["recommend", "price"])
+        .default("recommend")
+        .describe("Sort mode: recommend (default) or price"),
+    offset: z.number().int().min(0).default(0).describe("Pagination offset"),
+    limit: z.number().int().min(1).max(50).default(20).describe("Hotels per page"),
+    filter: filterSchema,
+};
+export function registerSearchHotels(server, client) {
+    server.tool("search_hotels", "Search hotels by location, dates, and guests. First use search_hotel_locations to get a location ID. Returns hotel offers with prices, star ratings, and meal plans. Supports filtering by stars, price, meal plan, and refundability.", searchHotelsSchema, async ({ location, checkin, checkout, country_code, guests, sort, offset, limit, filter }) => {
+        try {
+            const body = {
+                location,
+                checkin,
+                checkout,
+                countryCode: country_code,
+                guests,
+                sort,
+                offset,
+                limit,
+            };
+            if (filter) {
+                body.filter = filter;
+            }
+            const events = await client.postSSE("/search/hotels/stream", body);
+            // Collect hotels from SSE events
+            const hotels = [];
+            let totalCount = 0;
+            for (const { event, data } of events) {
+                if (event === "hotels") {
+                    const batch = data;
+                    hotels.push(...batch.hotels);
+                }
+                else if (event === "sorted_hotels") {
+                    const batch = data;
+                    hotels.push(...batch.hotels);
+                    totalCount = batch.total;
+                }
+                else if (event === "completed") {
+                    const completed = data;
+                    totalCount = completed.count;
+                    // In price mode, completed contains the hotels
+                    if (completed.hotels && completed.hotels.length > 0) {
+                        hotels.length = 0; // clear intermediate results
+                        hotels.push(...completed.hotels);
+                    }
+                }
+                else if (event === "error") {
+                    const err = data;
+                    return {
+                        content: [{ type: "text", text: `Hotel search error: ${err.message}` }],
+                        isError: true,
+                    };
+                }
+                else if (event === "timeout") {
+                    return {
+                        content: [{ type: "text", text: `Hotel search timed out. Try narrowing your search (fewer dates, specific filters).` }],
+                        isError: true,
+                    };
+                }
+            }
+            return {
+                content: [{ type: "text", text: formatHotelResults(hotels, totalCount) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error searching hotels: ${error.message}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=search-hotels.js.map

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "mcp-travelcode",
+  "version": "1.0.0",
+  "description": "MCP server for TravelCode — flights, hotels, orders. Search flights & hotels, manage bookings via AI assistants.",
+  "type": "module",
+  "main": "./build/index.js",
+  "bin": {
+    "mcp-travelcode": "./build/index.js",
+    "mcp-travelcode-auth": "./build/auth/cli-auth.js"
+  },
+  "files": [
+    "build/**/*.js",
+    "build/**/*.d.ts",
+    "README.md"
+  ],
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "travel",
+    "flights",
+    "hotels",
+    "booking",
+    "claude",
+    "ai-tools"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/egorceo/mcp-travelcode"
+  },
+  "scripts": {
+    "prepublishOnly": "npm run build",
+    "build": "tsc",
+    "start": "node build/index.js",
+    "start:http": "node build/http-server.js",
+    "dev": "tsx src/index.ts",
+    "dev:http": "tsx src/http-server.ts",
+    "auth": "node build/auth/cli-auth.js auth",
+    "auth:status": "node build/auth/cli-auth.js status",
+    "auth:logout": "node build/auth/cli-auth.js logout",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "inspect": "npx @modelcontextprotocol/inspector node build/index.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "express": "^5.2.1",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.6",
+    "@types/node": "^22.0.0",
+    "tsx": "^4.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "license": "MIT"
+}