Skip to content
Airsockfly

Developers and AI agents

Connect your AI agent to Airsockfly

Airsockfly exposes its search and booking features to AI assistants through an MCP server, browser WebMCP tools and machine-readable discovery files.

MCP server

One address for every MCP client. Search works without a token; account tools need an agent token.

Server address

https://www.airsockfly.com/api/mcp
  • Transport: Streamable HTTP (JSON responses)
  • Protocol versions: 2026-07-28, 2025-11-25, 2025-06-18, 2025-03-26, 2024-11-05

Account tools need an agent token. Create it in your account settings, under AI agents.

Configuration

Claude Code (terminal)

claude mcp add --transport http airsockfly https://www.airsockfly.com/api/mcp --header "Authorization: Bearer AGENT_TOKEN"

JSON configuration (Claude Desktop, Cursor, VS Code)

{
  "mcpServers": {
    "airsockfly": {
      "type": "http",
      "url": "https://www.airsockfly.com/api/mcp",
      "headers": {
        "Authorization": "Bearer AGENT_TOKEN"
      }
    }
  }
}

Replace AGENT_TOKEN with your token, or remove the header to use public tools only.

Tools

Tools available on the MCP server. Irreversible actions, like cancelling a booking, run only after the user confirms.

Tools
MCPToolsAccess
search_flights

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.

Public
search_hotels

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.

Public
search_tours

Search tours

Search package holidays and tours to a destination, departing from a given city within a date window.

Public
search_cars

Search car rentals

Search car rentals for a pickup place, date and time. Prices cover the whole rental; the drop-off place defaults to the pickup place.

Public
search_parking

Search parking

Search airport and city parking for an entry and exit date. Prices cover every calendar day from entry to exit inclusive.

Public
search_insurance

Get travel insurance quotes

Get travel insurance quotes for a trip: destination, dates and the age of every insured person. Premiums are calculated by the server.

Public
get_offer

Get offer details

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.

Public
get_flight_fare_rules

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.

Public
suggest_places

Suggest places

Resolve a city, airport or region name to place suggestions with IATA codes that the search tools accept.

Public
list_destinations

List destination guides

List travel destination guides published on Airsockfly, with hints for searching each destination.

Public
get_destination

Read destination guide

Read one destination guide by slug: highlights, airports, attractions and the best time to go.

Public
list_faq

Read FAQ

Read Airsockfly frequently asked questions about booking, payments and cancellations.

Public
get_profile

Read profile

Read the signed-in user's profile and travel preferences such as language, currency and home airport.

Account
list_travellers

List saved travellers

List travellers saved by the user with names and birth dates. Document numbers are never returned. Use them to fill create_booking.

Account
list_bookings

List bookings

List the user's orders, newest first, with status and totals.

Account
get_booking

Read booking

Read one order with its bookings, insurance policies, vouchers and invoice reference.

Account
create_booking

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.

Account
accept_price_change

Accept price change

Accept the changed price of an order after create_booking returned price_changed, and continue to payment.

Account
start_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.

Account
get_payment_status

Check payment status

Check whether an order has been paid and confirmed.

Account
preview_cancellation

Preview cancellation

Show what cancelling a booking would cost: penalty, refund and the deadline for free cancellation.

Account
cancel_booking

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.

Account
request_date_change

Request date change

Ask to move the dates of a hotel, tour or car rental booking. Creates a change request that the provider handles.

Account
list_saved_offers

List saved offers

List offers and collections the user saved.

Account
toggle_saved_offer

Save or unsave offer

Save an offer to the user's favourites, or remove it when it is already saved.

Account
list_price_alerts

List price alerts

List the user's price alerts.

Account
create_price_alert

Create price alert

Create a price alert for an offer. The user is notified when the price drops to the threshold.

Account
delete_price_alert

Delete price alert

Delete one of the user's price alerts.

Account
get_loyalty

Read loyalty points

Read the user's loyalty points balance and recent point history.

Account
list_rewards

List rewards

List rewards the user can get for loyalty points, with their cost in points and remaining stock.

Account
redeem_reward

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.

Account
list_notifications

Read notifications

Read the user's in-app notifications, newest first.

Account
list_support_cases

List support cases

List the user's support cases and their status.

Account
create_support_case

Open support case

Open a support case with Airsockfly customer service about a booking or another issue.

Account

Files for agents and search engines

Standard, machine-readable entry points to the service.

WebMCP

Browser-built AI agents see the same tools on our pages, plus navigation tools. They act on the session of the signed-in user and need no token.

MCP registry

Our server is listed in the official MCP registry under the name com.airsockfly.www/airsockfly.

View in the MCP registry