mcp-travelcode 1.0.2 → 1.0.3

package/build/client/api-client.d.ts

@@ -36,6 +36,10 @@ export declare class TravelCodeApiClient {
      * GET with accessToken as query parameter (used by hotel location endpoints).
      */
     getWithTokenParam<T>(path: string, params?: Record<string, string | number | boolean | undefined>): Promise<T>;
+    /**
+     * POST with accessToken in body (used by hotel offers endpoint).
+     */
+    postWithTokenParam<T>(path: string, body: Record<string, unknown>): Promise<T>;
     private headers;
     private handleResponse;
 }

package/build/client/api-client.js

@@ -197,6 +197,23 @@ export class TravelCodeApiClient {
         });
         return this.handleResponse(response);
     }
+    /**
+     * POST with accessToken in body (used by hotel offers endpoint).
+     */
+    async postWithTokenParam(path, body) {
+        await this.ensureValidToken();
+        const bodyWithToken = { ...body, accessToken: this.token };
+        const response = await fetch(`${this.baseUrl}${path}`, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                "X-Source": "mcp-server",
+                Accept: "application/json",
+            },
+            body: JSON.stringify(bodyWithToken),
+        });
+        return this.handleResponse(response);
+    }
     headers() {
         return {
             Authorization: `Bearer ${this.token}`,

package/build/client/types.d.ts

@@ -412,6 +412,71 @@ export interface HotelSSECompleted {
     hotels: HotelOffer[];
     cacheKey: string;
 }
+export interface HotelOfferPrice {
+    currency: string;
+    net: number;
+    gross: number;
+    total: number;
+    markup: number;
+    nights: number;
+    rooms: number;
+    nightly: number;
+    extra?: number;
+    totalWithExtra?: number;
+    deposit?: number | null;
+}
+export interface HotelOfferCancelPolicy {
+    refundable: boolean;
+    title: string;
+    description?: string;
+    fullyRefundable: boolean;
+}
+export interface HotelOfferRoom {
+    occupancyRefId: number;
+    code: string;
+    description: string;
+}
+export interface HotelOfferRate {
+    partnerId: number;
+    boardName: string;
+    price: HotelOfferPrice;
+    cancelPolicy: HotelOfferCancelPolicy;
+    rooms: HotelOfferRoom[];
+    externalId: string;
+    quoteKey: string;
+}
+export interface HotelOfferRoomGroup {
+    content: {
+        area?: string | null;
+        views?: string | null;
+        photos?: string[];
+    };
+    rates: HotelOfferRate[];
+}
+export interface HotelPropertyDescription {
+    title: string;
+    text: string;
+}
+export interface HotelProperty {
+    id?: string;
+    gId?: number;
+    name: string;
+    starRating?: number;
+    address?: string;
+    heroImage?: string;
+    images?: Array<{
+        url: string;
+    }>;
+    description?: HotelPropertyDescription[];
+    latitude?: number;
+    longitude?: number;
+}
+export interface HotelOffersResponse {
+    offersKey: string;
+    property: HotelProperty;
+    offers: Record<string, HotelOfferRoomGroup>;
+    bronevikId?: number;
+}
 export interface ApiErrorResponse {
     code: number;
     message?: string;

package/build/formatters/hotel-formatter.d.ts

@@ -1,4 +1,5 @@
-import { HotelLocationSearchResponse, HotelOffer } from "../client/types.js";
+import { HotelLocationSearchResponse, HotelOffer, HotelOffersResponse } from "../client/types.js";
 export declare function formatHotelLocations(data: HotelLocationSearchResponse): string;
 export declare function formatHotelResults(hotels: HotelOffer[], totalCount: number): string;
+export declare function formatHotelOffers(data: HotelOffersResponse): string;
 //# sourceMappingURL=hotel-formatter.d.ts.map

package/build/formatters/hotel-formatter.js

@@ -52,4 +52,50 @@ export function formatHotelResults(hotels, totalCount) {
     }
     return lines.join("\n");
 }
+export function formatHotelOffers(data) {
+    const prop = data.property;
+    const stars = prop.starRating ? "★".repeat(prop.starRating) : "";
+    const lines = [
+        `${stars} ${prop.name}`,
+        prop.address ? `Address: ${prop.address}` : "",
+    ].filter(Boolean);
+    // Descriptions
+    if (prop.description && prop.description.length > 0) {
+        for (const desc of prop.description.slice(0, 2)) {
+            const text = desc.text.length > 200 ? desc.text.slice(0, 200) + "..." : desc.text;
+            lines.push(`${desc.title}: ${text}`);
+        }
+    }
+    const roomGroups = Object.entries(data.offers);
+    let totalRates = 0;
+    for (const [, group] of roomGroups) {
+        totalRates += group.rates.length;
+    }
+    lines.push("");
+    lines.push(`${roomGroups.length} room types, ${totalRates} rates total:`);
+    lines.push("");
+    for (const [roomName, group] of roomGroups) {
+        const cheapest = group.rates.reduce((min, r) => (r.price.nightly < min.price.nightly ? r : min), group.rates[0]);
+        if (!cheapest)
+            continue;
+        const refundable = group.rates.some((r) => r.cancelPolicy.refundable);
+        const boards = [...new Set(group.rates.map((r) => r.boardName))].join(", ");
+        lines.push(`--- ${roomName} (${group.rates.length} offers) ---`);
+        lines.push(`  From: ${cheapest.price.nightly} ${cheapest.price.currency}/night (total: ${cheapest.price.total} for ${cheapest.price.nights} night(s))`);
+        lines.push(`  Meal options: ${boards}`);
+        lines.push(`  ${refundable ? "Refundable options available" : "Non-refundable"}`);
+        // Show top 3 rates
+        const sorted = [...group.rates].sort((a, b) => a.price.nightly - b.price.nightly);
+        for (const rate of sorted.slice(0, 3)) {
+            const cancel = rate.cancelPolicy.refundable ? "Refundable" : "Non-refundable";
+            lines.push(`    ${rate.price.nightly} ${rate.price.currency}/night | ${rate.boardName} | ${cancel}`);
+        }
+        if (sorted.length > 3) {
+            lines.push(`    ... and ${sorted.length - 3} more offers`);
+        }
+        lines.push("");
+    }
+    lines.push(`offersKey: ${data.offersKey}`);
+    return lines.join("\n");
+}
 //# sourceMappingURL=hotel-formatter.js.map

package/build/server.js

@@ -19,6 +19,7 @@ import { registerModifyOrder } from "./tools/modify-order.js";
 import { registerSearchHotelLocations } from "./tools/search-hotel-locations.js";
 import { registerGetHotelLocation } from "./tools/get-hotel-location.js";
 import { registerSearchHotels } from "./tools/search-hotels.js";
+import { registerGetHotelOffers } from "./tools/get-hotel-offers.js";
 export function createServer(config) {
     const server = new McpServer({
         name: "TravelCode",
@@ -49,6 +50,7 @@ export function createServer(config) {
     registerSearchHotelLocations(server, client);
     registerGetHotelLocation(server, client);
     registerSearchHotels(server, client);
+    registerGetHotelOffers(server, client);
     return server;
 }
 //# sourceMappingURL=server.js.map

package/build/tools/get-hotel-offers.d.ts

@@ -0,0 +1,25 @@
+import { z } from "zod";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { TravelCodeApiClient } from "../client/api-client.js";
+export declare const getHotelOffersSchema: {
+    id: 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">;
+    location: z.ZodOptional<z.ZodNumber>;
+};
+export declare function registerGetHotelOffers(server: McpServer, client: TravelCodeApiClient): void;
+//# sourceMappingURL=get-hotel-offers.d.ts.map

package/build/tools/get-hotel-offers.js

@@ -0,0 +1,49 @@
+import { z } from "zod";
+import { formatHotelOffers } 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"),
+});
+export const getHotelOffersSchema = {
+    id: z.number().int().describe("Hotel giataId (from search_hotels results)"),
+    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"),
+    location: z
+        .number()
+        .int()
+        .optional()
+        .describe("Location ID from prior search — enables cache reuse for faster results"),
+};
+export function registerGetHotelOffers(server, client) {
+    server.tool("get_hotel_offers", "Get all available rooms and rates for a specific hotel from all suppliers. Returns room types, prices, meal plans, and cancellation policies. The hotel giataId comes from search_hotels results — do not explain this to the user, just chain the calls silently.", getHotelOffersSchema, async ({ id, checkin, checkout, country_code, guests, location }) => {
+        try {
+            const body = {
+                id,
+                checkin,
+                checkout,
+                countryCode: country_code,
+                guests,
+            };
+            if (location !== undefined) {
+                body.location = location;
+            }
+            const data = await client.postWithTokenParam("/search/hotels/offers", body);
+            return {
+                content: [{ type: "text", text: formatHotelOffers(data) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error getting hotel offers: ${error.message}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=get-hotel-offers.js.map

package/build/tools/search-hotels.js

@@ -39,7 +39,7 @@ export const searchHotelsSchema = {
     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 }) => {
+    server.tool("search_hotels", "Search hotels by location, dates, and guests. Requires a location ID from search_hotel_locations — chain the calls silently without explaining intermediate steps to the user. 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,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-travelcode",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "MCP server for TravelCode — flights, hotels, orders. Search flights & hotels, manage bookings via AI assistants.",
   "type": "module",
   "main": "./build/index.js",