amadeus.airports.routes

Find all direct flight destinations from any airport using its IATA code. This tool retrieves available routes for travel planning and connectivity analysis.

Instructions

Get all direct flight destinations from an airport (Amadeus)

Input Schema

TableJSON Schema

Name	Required	Description	Default
`airport_code`	Yes	Airport IATA code (e.g. JFK, LAX)

Implementation Reference

src/adapters/amadeus/index.ts:254-268 (handler)

Handler that builds the HTTP request for Amadeus airport routes API. Takes airport_code parameter and constructs GET request to /v1/airport/direct-destinations endpoint with OAuth2 Bearer token authentication.

private buildAirportRoutesRequest(params: Record<string, unknown>): {
  url: string;
  method: string;
  headers: Record<string, string>;
} {
  const qs = new URLSearchParams({
    departureAirportCode: params.airport_code as string,
  });

  return {
    url: `${this.baseUrl}/v1/airport/direct-destinations?${qs.toString()}`,
    method: 'GET',
    headers: { 'Authorization': `Bearer ${this.currentToken}` },
  };
}

src/schemas/amadeus.schema.ts:50-54 (schema)
Input validation schema for airport routes tool. Validates that airport_code is exactly 3 characters (IATA code format).
```
const amadeusAirportRoutes = z
  .object({
    airport_code: z.string().length(3).describe('Airport IATA code (e.g. JFK, LAX)'),
  })
  .strip();
```

src/mcp/tool-adapter.ts:311-317 (registration)

Tool registration mapping internal toolId 'amadeus.airport_routes' to MCP name 'amadeus.airports.routes'. Marks tool as read-only operation.

{
  toolId: 'amadeus.airport_routes',
  mcpName: 'amadeus.airports.routes',
  title: 'Get Airport Routes',
  description: 'Get all direct flight destinations from an airport (Amadeus)',
  annotations: READ_ONLY,
},

src/adapters/amadeus/index.ts:127-133 (handler)

Response parser for airport routes. Validates the API response contains expected data field and returns typed AmadeusDirectDestinationResponse.

case 'amadeus.airport_routes': {
  const data = body as AmadeusDirectDestinationResponse;
  if (!data.data) {
    throw new Error('Missing data in Amadeus airport routes response');
  }
  return data;
}

src/adapters/amadeus/types.ts:172-180 (helper)

Type definitions for airport routes response. AmadeusDirectDestination describes a destination airport with IATA code, name, and metadata.

export interface AmadeusDirectDestination {
  type: string;
  id: string;
  subType: string;
  name: string;
  iataCode: string;
}

export type AmadeusDirectDestinationResponse = AmadeusResponse<AmadeusDirectDestination>;

APIbase