# Airsockfly

> Travel marketplace for flights, hotels, tours, car rental, airport parking and travel insurance. AI agents can search offers and, with the user's agent token, manage the user's bookings through the Model Context Protocol.

## MCP server

Streamable HTTP endpoint: https://www.airsockfly.com/api/mcp. The server supports protocol versions 2024-11-05 to 2025-11-25 with initialize, and 2026-07-28 with server/discover. It is stateless and exposes tools only.

Public tools work without credentials. Account tools need the header Authorization: Bearer with an agent token that the user creates at https://www.airsockfly.com/en/settings/agents. The token acts like a signed-in session, expires after 7 days without use and can be revoked at any time.

Browser agents: every public page and the customer panel register the same tools through WebMCP, using document.modelContext, plus open_page and open_offer_page. In the browser the tools act on the user's signed-in session.

## Public tools

- `search_flights` — Search flights between two airports or cities. Returns offers with the price in grosze, schedule, fare family and a link to the offer page. Use suggest_places first when you only know a city name.
- `search_hotels` — Search hotels in a city or area for given check-in and check-out dates. Returns offers with the total price of the stay, rating, board type and a link to the offer page.
- `search_tours` — Search package holidays and tours to a destination, departing from a given city within a date window.
- `search_cars` — Search car rentals for a pickup place, date and time. Prices cover the whole rental; the drop-off place defaults to the pickup place.
- `search_parking` — Search airport and city parking for an entry and exit date. Prices cover every calendar day from entry to exit inclusive.
- `search_insurance` — Get travel insurance quotes for a trip: destination, dates and the age of every insured person. Premiums are calculated by the server.
- `get_offer` — Refresh one offer by its externalId before booking. Returns the current price, availability, cancellation policy and details, or not_found when the offer has expired.
- `get_flight_fare_rules` — Get the fare rules of a flight offer: baggage, changes and refunds. The offer is re-priced with the airline on the first call.
- `suggest_places` — Resolve a city, airport or region name to place suggestions with IATA codes that the search tools accept.
- `list_destinations` — List travel destination guides published on Airsockfly, with hints for searching each destination.
- `get_destination` — Read one destination guide by slug: highlights, airports, attractions and the best time to go.
- `list_faq` — Read Airsockfly frequently asked questions about booking, payments and cancellations.

## Account tools (agent token required)

- `get_profile` — Read the signed-in user's profile and travel preferences such as language, currency and home airport.
- `list_travellers` — List travellers saved by the user with names and birth dates. Document numbers are never returned. Use them to fill create_booking.
- `list_bookings` — List the user's orders, newest first, with status and totals.
- `get_booking` — Read one order with its bookings, insurance policies, vouchers and invoice reference.
- `create_booking` — Reserve an offer for the user: re-prices the offer, holds availability and creates an order awaiting payment. Ask the user to confirm the offer, travellers and contact details first. When the result is price_changed, show the new price and call accept_price_change only if the user agrees.
- `accept_price_change` — Accept the changed price of an order after create_booking returned price_changed, and continue to payment.
- `start_payment` — Start payment for an order and get a secure Stripe checkout URL. The user must open the URL and pay personally. The agent never pays and must not claim that a payment was made.
- `get_payment_status` — Check whether an order has been paid and confirmed.
- `preview_cancellation` — Show what cancelling a booking would cost: penalty, refund and the deadline for free cancellation.
- `cancel_booking` — Cancel a booking. This is irreversible: call preview_cancellation, tell the user the penalty and refund, and set confirm to true only after the user explicitly agreed.
- `request_date_change` — Ask to move the dates of a hotel, tour or car rental booking. Creates a change request that the provider handles.
- `list_saved_offers` — List offers and collections the user saved.
- `toggle_saved_offer` — Save an offer to the user's favourites, or remove it when it is already saved.
- `list_price_alerts` — List the user's price alerts.
- `create_price_alert` — Create a price alert for an offer. The user is notified when the price drops to the threshold.
- `delete_price_alert` — Delete one of the user's price alerts.
- `get_loyalty` — Read the user's loyalty points balance and recent point history.
- `list_rewards` — List rewards the user can get for loyalty points, with their cost in points and remaining stock.
- `redeem_reward` — Exchange loyalty points for a reward. This spends points: confirm the reward and its cost with the user and set confirm to true only after explicit agreement. Physical rewards need a shipping address.
- `list_notifications` — Read the user's in-app notifications, newest first.
- `list_support_cases` — List the user's support cases and their status.
- `create_support_case` — Open a support case with Airsockfly customer service about a booking or another issue.

## Machine-readable resources

- [Full reference for language models (llms-full.txt)](https://www.airsockfly.com/llms-full.txt)
- [Developer documentation (MCP, WebMCP, agent tokens)](https://www.airsockfly.com/en/developers)
- [MCP Server Card](https://www.airsockfly.com/api/mcp/server-card)
- [Agentic Resource Discovery catalog (ard.json)](https://www.airsockfly.com/.well-known/ard.json)
- [AI catalog (ai-catalog.json)](https://www.airsockfly.com/.well-known/ai-catalog.json)
- [Blog RSS feed](https://www.airsockfly.com/en/rss.xml)
- [Blog Atom feed](https://www.airsockfly.com/en/atom.xml)

Every public page is also available as Markdown: send the header Accept: text/markdown or append .md to the address (for example https://www.airsockfly.com/en/hotels.md).

## Links

- [Website](https://www.airsockfly.com/en)
- [Help center](https://www.airsockfly.com/en/help)
- [Sitemap](https://www.airsockfly.com/sitemap.xml)
