Flight + Stay Search MCP

Implementation Reference

• src/server.ts:119-136 (handler)

  The async handler function that executes the tool logic: fetches offer details via flightClient.getOffer and returns formatted JSON response.

  async (params: OfferDetails) => {
    try {
      const response = await flightClient.getOffer(params.offerId);
      
      return {
        content: [
          {
            type: 'text',
            text: JSON.stringify(response, null, 2)
          }
        ]
      };
      
    } catch (error) {
      console.error(`Error getting offer details: ${error}`);
      throw error;
    }
  }

• src/server.ts:117-137 (registration)

  The server.tool registration for the 'get_offer_details' tool, including name, schema, and handler.

    'get_offer_details',
    offerDetailsSchema.shape,
    async (params: OfferDetails) => {
      try {
        const response = await flightClient.getOffer(params.offerId);
        
        return {
          content: [
            {
              type: 'text',
              text: JSON.stringify(response, null, 2)
            }
          ]
        };
        
      } catch (error) {
        console.error(`Error getting offer details: ${error}`);
        throw error;
      }
    }
  );

• src/models/flightSearch.ts:37-41 (schema)

  Zod schema and TypeScript type definition for the tool's input parameters (offerId).

  export const offerDetailsSchema = z.object({
    offerId: z.string().describe('Unique identifier for the flight offer')
  });
  
  export type OfferDetails = z.infer<typeof offerDetailsSchema>;

• src/api/duffelClient.ts:210-223 (helper)

  Supporting method in DuffelClient class that makes the actual Duffel API call to retrieve offer details by ID.

  async getOffer(offerId: string): Promise<any> {
    try {
      if (!offerId.startsWith('off_')) {
        throw new Error('Invalid offer ID format - must start with "off_"');
      }
      
      const response = await this.client.get(`/offers/${offerId}`);
      return response.data;
      
    } catch (error) {
      console.error(`Error getting offer ${offerId}: ${error}`);
      throw error;
    }
  }