mcp-travelcode 1.0.1 → 1.0.3

package/README.md

@@ -1,16 +1,63 @@
-# MCP TravelCode
-
-MCP server for the [TravelCode](https://travel-code.com) corporate travel API. Enables AI assistants (Claude Desktop, Cursor, Claude Code) to search flights & hotels, manage bookings, and track flight status.
+<p align="center">
+  <h1 align="center">✈️ MCP TravelCode</h1>
+  <p align="center">
+    <strong>Model Context Protocol server for travel — flights, hotels, bookings</strong>
+  </p>
+  <p align="center">
+    Give your AI assistant the power to search flights, book hotels, manage orders, and track flight status — all through natural language.
+  </p>
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/mcp-travelcode"><img src="https://img.shields.io/npm/v/mcp-travelcode.svg" alt="npm version"></a>
+  <a href="https://github.com/egorceo/mcp-travelcode/blob/main/LICENSE"><img src="https://img.shields.io/npm/l/mcp-travelcode.svg" alt="MIT License"></a>
+  <a href="https://www.npmjs.com/package/mcp-travelcode"><img src="https://img.shields.io/npm/dm/mcp-travelcode.svg" alt="Downloads"></a>
+  <a href="https://nodejs.org/"><img src="https://img.shields.io/node/v/mcp-travelcode.svg" alt="Node.js"></a>
+  <a href="https://modelcontextprotocol.io"><img src="https://img.shields.io/badge/MCP-compatible-blue" alt="MCP Compatible"></a>
+</p>
+
+<p align="center">
+  <a href="#quick-start">Quick Start</a> •
+  <a href="#tools-19">Tools</a> •
+  <a href="#supported-clients">Clients</a> •
+  <a href="#example-conversations">Examples</a> •
+  <a href="#authentication">Auth</a> •
+  <a href="#development">Development</a>
+</p>
+
+---
+
+## What is this?
+
+**MCP TravelCode** is a [Model Context Protocol](https://modelcontextprotocol.io) (MCP) server that connects AI assistants to the [TravelCode](https://travel-code.com) corporate travel API. It lets AI agents search for flights and hotels, create and manage bookings, check real-time flight status, and access delay statistics — all via natural language conversations.
+
+Built for the MCP ecosystem — works with **Claude Desktop**, **Claude Code**, **Cursor**, **Windsurf**, **Cline**, **Continue**, **OpenClaw**, and any MCP-compatible client.
+
+### Key Features
+
+- 🔍 **Flight search** — multi-city, one-way, round-trip with cabin class and passenger filters
+- 🏨 **Hotel search** — star rating, meal plans, refundability, price filters with SSE streaming
+- 📊 **Flight status** — real-time tracking with delays, gates, terminals, and aircraft info
+- 📈 **Delay statistics** — historical delay and cancellation data for flights and airports
+- 📋 **Order management** — create, cancel, modify bookings; check cancellation conditions
+- 🔐 **OAuth 2.1 + PKCE** — secure browser-based authentication, auto-refreshing tokens
+- 🌍 **Airport & airline data** — search by name, city, IATA/ICAO code
+- ⚡ **Async polling** — automatic background polling for flight search results
+- 🔄 **Dual transport** — stdio (local) and HTTP/SSE (remote) support
 
 ## Quick Start
 
+### Install & Authenticate
+
 ```bash
-# 1. Authenticate (opens browser, one-time)
+# 1. Authenticate with your TravelCode account (opens browser, one-time)
 npx mcp-travelcode-auth auth
-
-# 2. Add to Claude Desktop (claude_desktop_config.json):
 ```
 
+### Claude Desktop
+
+Add to your `claude_desktop_config.json`:
+
 ```json
 {
   "mcpServers": {
@@ -22,9 +69,7 @@ npx mcp-travelcode-auth auth
 }
 ```
 
-```bash
-# 3. Restart Claude Desktop — done!
-```
+Restart Claude Desktop — done! Ask Claude to search flights, book hotels, or check flight status.
 
 ### Claude Code
 
@@ -32,102 +77,301 @@ npx mcp-travelcode-auth auth
 claude mcp add travelcode -- npx mcp-travelcode
 ```
 
+### ChatGPT Desktop
+
+Go to **Settings → Tools → Add MCP Server**, then add:
+
+```json
+{
+  "command": "npx",
+  "args": ["mcp-travelcode"]
+}
+```
+
+### Gemini / Google AI Studio
+
+Add to your MCP server configuration:
+
+```json
+{
+  "mcpServers": {
+    "travelcode": {
+      "command": "npx",
+      "args": ["mcp-travelcode"]
+    }
+  }
+}
+```
+
+### GitHub Copilot (VS Code)
+
+Add to your VS Code `settings.json`:
+
+```json
+{
+  "github.copilot.chat.mcpServers": {
+    "travelcode": {
+      "command": "npx",
+      "args": ["mcp-travelcode"]
+    }
+  }
+}
+```
+
+### Cursor
+
+Add to `.cursor/mcp.json` in your project:
+
+```json
+{
+  "mcpServers": {
+    "travelcode": {
+      "command": "npx",
+      "args": ["mcp-travelcode"]
+    }
+  }
+}
+```
+
+### Windsurf / Cline / Continue
+
+Add to your MCP configuration (typically `mcp_config.json` or settings):
+
+```json
+{
+  "mcpServers": {
+    "travelcode": {
+      "command": "npx",
+      "args": ["mcp-travelcode"]
+    }
+  }
+}
+```
+
+### Zed
+
+Add to your Zed `settings.json`:
+
+```json
+{
+  "context_servers": {
+    "travelcode": {
+      "command": {
+        "path": "npx",
+        "args": ["mcp-travelcode"]
+      }
+    }
+  }
+}
+```
+
+### JetBrains IDEs (IntelliJ, WebStorm, PyCharm)
+
+Go to **Settings → Tools → AI Assistant → MCP Servers → Add**, set command to `npx` with args `mcp-travelcode`.
+
+### OpenClaw
+
+```yaml
+mcp:
+  servers:
+    travelcode:
+      command: npx
+      args: ["mcp-travelcode"]
+```
+
+### HTTP Transport (Remote / Multi-client)
+
+```bash
+npx mcp-travelcode --http          # Start HTTP+SSE server
+# or
+npm run start:http                  # If installed locally
+```
+
+Connect any MCP client to `http://localhost:3000/mcp` via SSE transport.
+
+## Supported Clients
+
+Works with **any MCP-compatible client** — including all major AI assistants, IDEs, and coding tools:
+
+| Client | Transport | Status |
+|--------|-----------|--------|
+| [ChatGPT Desktop](https://openai.com/chatgpt/desktop/) | stdio | ✅ Compatible |
+| [Claude Desktop](https://claude.ai/download) | stdio | ✅ Tested |
+| [Claude Code](https://docs.anthropic.com/en/docs/claude-code) | stdio | ✅ Tested |
+| [Gemini](https://gemini.google.com) | stdio | ✅ Compatible |
+| [GitHub Copilot](https://github.com/features/copilot) | stdio | ✅ Compatible |
+| [Cursor](https://cursor.com) | stdio | ✅ Tested |
+| [Windsurf](https://codeium.com/windsurf) | stdio | ✅ Compatible |
+| [Cline](https://github.com/cline/cline) | stdio | ✅ Compatible |
+| [Continue](https://continue.dev) | stdio | ✅ Compatible |
+| [Zed](https://zed.dev) | stdio | ✅ Compatible |
+| [JetBrains IDEs](https://www.jetbrains.com/) | stdio | ✅ Compatible |
+| [VS Code](https://code.visualstudio.com/) | stdio | ✅ Compatible |
+| [OpenClaw](https://openclaw.ai) | stdio | ✅ Tested |
+| [MCP Inspector](https://github.com/modelcontextprotocol/inspector) | stdio | ✅ Tested |
+| Any MCP client | stdio / HTTP+SSE | ✅ Compatible |
+
 ## Tools (19)
 
-### Flight Search & Reference Data
+### ✈️ Flight Search & Reference Data
 
 | Tool | Description |
 |------|-------------|
-| `search_airports` | Find airports by name, city, or IATA code |
-| `get_airport` | Get details for a specific airport |
-| `search_airlines` | Find airlines by name or IATA code |
-| `search_flights` | Search for flights (handles async polling automatically) |
-| `get_flight_results` | Filter/sort/paginate existing search results |
+| `search_airports` | Find airports by name, city, or IATA/ICAO code |
+| `get_airport` | Get detailed airport information (location, timezone, terminals) |
+| `search_airlines` | Find airlines by name or IATA/ICAO code |
+| `search_flights` | Search flights — one-way, round-trip, multi-city. Handles async polling automatically |
+| `get_flight_results` | Filter, sort, and paginate existing search results |
 
-### Flight Statistics (AeroDataBox)
+### 📊 Flight Statistics
 
 | Tool | Description |
 |------|-------------|
-| `get_flight_status` | Real-time flight status (delays, gates, terminals, aircraft) |
-| `get_airport_flights` | Airport departure/arrival board for a time window |
-| `get_flight_delay_stats` | Historical delay statistics for a flight number |
-| `get_airport_delay_stats` | Airport delay and cancellation stats for a date |
+| `get_flight_status` | Real-time flight status — delays, gates, terminals, aircraft type |
+| `get_airport_flights` | Live airport departure/arrival board for a time window |
+| `get_flight_delay_stats` | Historical on-time performance and delay statistics for a flight number |
+| `get_airport_delay_stats` | Airport-wide delay and cancellation statistics for a date |
 
-### Hotel Search
+### 🏨 Hotel Search
 
 | Tool | Description |
 |------|-------------|
-| `search_hotel_locations` | Find cities, regions, or hotels by name (returns location IDs) |
+| `search_hotel_locations` | Find cities, regions, or specific hotels by name (returns location IDs for search) |
 | `get_hotel_location` | Get location details by ID |
-| `search_hotels` | Search hotels with filters (stars, price, meal plan, refundability) via SSE stream |
+| `search_hotels` | Search hotels with filters — star rating, price range, meal plan, refundability. Results stream via SSE |
 
-### Order Management
+### 📋 Order Management
 
 | Tool | Description |
 |------|-------------|
-| `list_orders` | List orders with filtering and pagination |
-| `get_order` | Get full order details |
-| `create_order` | Book a flight from search results |
-| `check_order_cancellation` | Check cancellation conditions and refund estimate |
-| `cancel_order` | Cancel an order |
-| `check_order_modification` | Check what modifications are allowed |
-| `modify_order` | Modify an order (contacts, passport, rebook, baggage) |
+| `list_orders` | List all orders with filtering (status, date range) and pagination |
+| `get_order` | Get full order details — passengers, segments, pricing, ticket numbers |
+| `create_order` | Book a flight from search results — add passengers, contacts, payment |
+| `check_order_cancellation` | Check cancellation conditions, penalties, and refund estimate before canceling |
+| `cancel_order` | Cancel an order with refund processing |
+| `check_order_modification` | Check what modifications are allowed (rebooking, baggage, contacts) |
+| `modify_order` | Modify an order — update contacts, passport info, rebook, add baggage |
+
+## Example Conversations
+
+### Search Flights
+
+> **You:** Find me flights from New York to London on April 15, economy class, 2 passengers
+>
+> **AI:** *Uses `search_airports` → `search_flights` → returns formatted flight options with prices, durations, and stops*
+
+### Book a Hotel
+
+> **You:** I need a 4-star hotel in Tokyo for May 1-5, 2 adults, with breakfast included
+>
+> **AI:** *Uses `search_hotel_locations` → `search_hotels` with star rating and meal plan filters → shows options*
+
+### Check Flight Status
+
+> **You:** Is my flight AA100 on time today?
+>
+> **AI:** *Uses `get_flight_status` → shows real-time departure/arrival times, gate, terminal, any delays*
+
+### Manage Bookings
+
+> **You:** Show my recent orders. Can I cancel order #12345?
+>
+> **AI:** *Uses `list_orders` → `check_order_cancellation` → shows cancellation conditions and refund estimate → `cancel_order` if confirmed*
+
+### Flight Delay Analysis
+
+> **You:** How often is BA115 delayed? What are the stats?
+>
+> **AI:** *Uses `get_flight_delay_stats` → shows historical on-time percentage, average delays, cancellation rate*
 
 ## Authentication
 
-MCP TravelCode uses OAuth 2.1 with PKCE. No API keys to manage — just sign in with your TravelCode account.
+MCP TravelCode uses **OAuth 2.1 with PKCE** — the modern standard for secure authentication. No API keys to manage or rotate.
 
 ```bash
-# Sign in (opens browser)
+# Sign in (opens browser for secure authentication)
 npx mcp-travelcode-auth auth
 
-# Check token status
+# Check token status and expiration
 npx mcp-travelcode-auth status
 
-# Sign out
+# Sign out and clear tokens
 npx mcp-travelcode-auth logout
 ```
 
-Tokens are stored in `~/.travelcode/tokens.json` and auto-refresh when expired.
+- Tokens are stored in `~/.travelcode/tokens.json`
+- Access tokens auto-refresh when expired — no manual intervention needed
+- Each user authenticates with their own TravelCode account
 
-**Legacy mode:** You can also set `TRAVELCODE_API_TOKEN` environment variable to use a static API token.
+**Legacy mode:** Set `TRAVELCODE_API_TOKEN` environment variable to use a static API token (skips OAuth).
 
-## Environment Variables
+## Configuration
 
-| Variable | Required | Default | Description |
-|----------|----------|---------|-------------|
-| `TRAVELCODE_API_TOKEN` | No | — | Static API token (skips OAuth) |
+| Environment Variable | Required | Default | Description |
+|---------------------|----------|---------|-------------|
+| `TRAVELCODE_API_TOKEN` | No | — | Static API token (bypasses OAuth) |
 | `TRAVELCODE_API_BASE_URL` | No | `https://api.travel-code.com/v1` | API base URL |
-| `TRAVELCODE_POLL_INTERVAL_MS` | No | 2000 | Flight search polling interval (ms) |
-| `TRAVELCODE_POLL_TIMEOUT_MS` | No | 90000 | Flight search timeout (ms) |
+| `TRAVELCODE_POLL_INTERVAL_MS` | No | `2000` | Flight search polling interval in milliseconds |
+| `TRAVELCODE_POLL_TIMEOUT_MS` | No | `90000` | Flight search timeout in milliseconds |
 
-## Example Conversations
+## Development
 
-> "Find hotels in Dubai for April 15-18, 2 adults, 4-5 stars, all inclusive"
+```bash
+git clone https://github.com/egorceo/mcp-travelcode.git
+cd mcp-travelcode
+npm install
+
+npm run dev          # Run with tsx (hot reload)
+npm run build        # Compile TypeScript
+npm test             # Run tests
+npm run inspect      # Test interactively with MCP Inspector
+npm run start:http   # Start HTTP+SSE transport server
+```
 
-Uses `search_hotel_locations` → `search_hotels` with star rating and meal plan filters.
+### Project Structure
 
-> "Search flights from London to Barcelona on March 15, economy, 2 adults"
+```
+src/
+├── index.ts          # stdio entry point
+├── http-server.ts    # HTTP+SSE entry point
+├── server.ts         # MCP server setup & tool registration
+├── config.ts         # Environment configuration
+├── auth/             # OAuth 2.1 PKCE flow & CLI
+├── client/           # TravelCode API client
+├── tools/            # 19 MCP tool implementations
+├── formatters/       # Response formatting
+└── polling/          # Async flight search polling
+```
 
-Uses `search_airports` → `search_flights` → returns formatted flight options.
+## Tech Stack
 
-> "Show my orders" / "Cancel order 12345"
+- **TypeScript** — full type safety
+- **[@modelcontextprotocol/sdk](https://github.com/modelcontextprotocol/typescript-sdk)** — official MCP SDK
+- **Zod** — runtime schema validation for all tool inputs
+- **Express 5** — HTTP transport server
+- **Vitest** — testing framework
 
-Uses `list_orders`, `check_order_cancellation` → `cancel_order`.
+## Use Cases
 
-> "Is flight LO776 on time today?"
+- **Corporate travel management** — search and book business travel through AI assistants
+- **Travel agencies** — integrate flight and hotel search into AI-powered agent workflows
+- **Trip planning** — find flights, compare prices, check schedules via natural conversation
+- **Flight monitoring** — track flight status, delays, gate changes in real-time
+- **Travel analytics** — analyze flight delay patterns, airport performance, route statistics
+- **Booking automation** — automate repetitive booking tasks through AI agents
+- **Customer support** — help travelers check bookings, modify orders, handle cancellations
 
-Uses `get_flight_status` to check real-time status.
+## Related
 
-## Development
+- [Model Context Protocol](https://modelcontextprotocol.io) — the open standard for AI tool integration
+- [TravelCode](https://travel-code.com) — corporate travel management platform
+- [MCP Servers Directory](https://github.com/modelcontextprotocol/servers) — official MCP server registry
+- [Claude Desktop](https://claude.ai/download) — AI assistant with MCP support
 
-```bash
-npm run dev         # Run with tsx (hot reload)
-npm run build       # Compile TypeScript
-npm run inspect     # Test with MCP Inspector
-npm run start:http  # Run HTTP transport (OAuth for browser clients)
-```
+## Contributing
+
+Contributions welcome! Please open an issue or submit a pull request.
 
 ## License
 
-MIT
+[MIT](LICENSE) © [Travel Code](https://travel-code.com)

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.1",
+  "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",