Branded Fares Upsell MCP Server Integration Guide

Technical Overview & Protocol Integration

The Branded Fares Upsell API, provided by Amadeus, is a specialized flight shopping service designed to unlock incremental revenue streams for airlines, travel agencies, and online travel platforms. Its core capability is to take an existing, often basic, flight offer and intelligently generate a curated set of premium fare options or ancillary bundles for upselling to a customer. By analyzing the initial offer context—including route, booking class, and available inventory—the API returns a list of higher-fare branded products with their respective price differences and added benefits (such as extra baggage, seat selection, lounge access, or greater flexibility). This transforms a simple fare search into a dynamic merchandising moment. Typical use cases include airlines looking to increase ancillary revenue on their booking engines, travel agencies aiming to enhance agent-assisted bookings with higher-margin options, and OTAs building sophisticated shopping flows that present value-added choices at the point of sale. It is fundamentally a tool for conversion optimization, enabling businesses to present the right upgrade at the right time to maximize customer value and satisfaction.

When exposed as a tool via the Model Context Protocol (MCP) to an AI coding assistant like Claude Desktop or Cursor, this API becomes a powerful engine for automating and enhancing developer workflows related to travel commerce. The AI agent can act as an intelligent intermediary, dynamically interfacing with the upselling engine without the developer needing to manually construct complex payloads or interpret response schemas. This integration allows the AI to programmatically query for upsell opportunities based on any flight offer, instantly generating data that can be embedded into UI mockups, used in automated testing suites for booking flows, or incorporated into logic simulations for revenue management. The value lies in abstracting away the API's complexity, enabling developers to instruct the AI in natural language to "fetch premium fare options for this economy flight from Paris to Tokyo" or "simulate how upsell revenue changes if we adjust the price threshold by 10%." This accelerates prototyping, reduces integration time, and allows developers to focus on higher-level application logic while the AI handles the precise API interactions and data transformation.

A developer can leverage this MCP-enabled AI agent to perform a variety of dynamic, context-aware tasks that streamline development and operational processes. For instance, the agent can be instructed to query the API to do X, such as: "For all economy flight offers in this JSON array, call the upsell API and append the best available premium fare to each record, creating a enriched dataset for our recommendation engine." Similarly, it can automate Z by being asked to update Y: "Using the output from the last upsell query, automatically generate a set of mock API responses for our integration tests, ensuring they cover scenarios where upsell options are available, priced above a certain threshold, or entirely unavailable." In a more advanced workflow, the AI agent could continuously query the API with variations of a test offer to map out fare ladder behaviors, helping developers understand pricing thresholds and brand structures. This turns a simple API call into a component of a larger, automated analysis pipeline, enabling rapid iteration on features like dynamic UI displays or personalized upgrade logic.

Critical to the secure and effective use of this API is proper authentication and adherence to security best practices. While the specific endpoint may not require an authentication payload in every call, it is imperative that the underlying access token generated via the Amadeus authorization process is securely managed and injected into requests by the server. Developers must ensure that the token, which grants access to commercial data and billing, is never exposed to client-side environments or logged in plaintext. Following the principle of least privilege is key; if using API keys, they should be scoped only to the specific endpoints and resources required for the upselling function. When setting up the MCP server, configuration should include secure storage for credentials (such as environment variables or a secrets manager), robust error handling for token expiration, and strict validation of all data returned from the API before it is used in downstream processes. It is also essential to work within the constraints of the test environment, which is explicitly noted as a subset of production, to ensure that development and testing do not incur unintended costs or affect live data.

By translating the OpenAPI 3.0 specification for Branded Fares Upsell into native Model Context Protocol (MCP) tool definitions, developers and AI agents gain programmatic access to endpoints over stdio or HTTP transports. Every endpoint is translated into a discrete tool payload complete with input argument validation, parameter descriptions, and return type definitions.