request_booking_link

Generate a booking link for a selected flight option to complete the reservation process after expressing booking intent.

Instructions

Request link for booking a flight option. This tool generates a booking link for a specific flight option.This tool is recommended to be used after the user expressed intention to book the flight option.

Input Schema

TableJSON Schema

Name	Required	Description
`search_id`	Yes	Search ID from the previous search_flights tool.
`offer_id`	Yes	Offer ID of the flight option for which to request a booking link.
`agency_id`	Yes	Internal agency ID for generating booking link.

Implementation Reference

src/flights-mcp/main.py:214-248 (handler)

The main handler function for the 'request_booking_link' tool, including decorator, parameters with schema via Field, and logic to fetch booking link from Travelpayouts API using cached search results.

@mcp.tool(
    description="Request link for booking a flight option. " \
    "This tool generates a booking link for a specific flight option." \
    "This tool is recommended to be used after the user expressed intention to book the flight option." \
)
async def request_booking_link(
    search_id: str = Field(..., description="Search ID from the previous search_flights tool."),
    offer_id: str = Field(..., description="Offer ID of the flight option for which to request a booking link."),
    agency_id: str = Field(..., description="Internal agency ID for generating booking link.")
) -> str:
    """Request a booking link for a specific flight option."""
    
    batch = search_results_cache.get(search_id)
    if not batch:
        raise ToolError(f"No search results found for search_id: {search_id}. " \
                        "It may have expired after 10 minutes. " \
                        "Please perform a search first using the `search_flights` tool.")
    
    proposal = batch.get_proposal_by_id(offer_id)
    if not proposal:
        raise ToolError(f"No flight details found for offer_id: {offer_id} in search_id: {search_id}.")
    
    terms = proposal.terms[agency_id]
    
    get_book_link_api_url = f"https://api.travelpayouts.com/v1/flight_searches/{search_id}/clicks/{terms.url}.json?marker={MARKER}"
    async with httpx.AsyncClient(timeout=40) as client:
        response = await client.get(get_book_link_api_url)
        if response.status_code != 200:
            raise ToolError(f"Aviasales API returned non-200 status code: {response.status_code}", raw_response=response.text)
        data = response.json()
        if not data or "url" not in data:
            raise ToolError("Booking link not found in the response from Aviasales API.")
        book_link = data["url"]
        agency_name = batch.gates_info.get(agency_id).label if batch.gates_info.get(agency_id) else ''
        return f"Booking link on {agency_name}: {book_link}"

src/flights-mcp/proposal.py:511-515 (helper)
Helper method on ProposalsBatchModel used to retrieve the specific Proposal instance by its sign (offer_id). Essential for accessing the flight proposal data in the handler.
```
def get_proposal_by_id(self, proposal_id: str) -> Optional[Proposal]:
    for proposal in self.proposals:
        if proposal.sign == proposal_id:
            return proposal
    return None
```

Flights MCP