---
title: "For developers and AI agents | Airsockfly"
description: "Connect AI agents to Airsockfly: the MCP server, WebMCP tools, agent tokens, llms.txt, AI catalog and feeds."
url: "https://www.airsockfly.com/en/developers"
language: "en"
---

1. [Home](https://www.airsockfly.com/en)
2. For developers and AI agents

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.

[Create an agent token](https://www.airsockfly.com/en/settings/agents) [Step-by-step guide](https://www.airsockfly.com/en/help/agenci-ai)

## 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**

| MCP | Tools | Access |
| --- | --- | --- |
| 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.

- [/llms.txt](https://www.airsockfly.com/llms.txt)Short guide for language models
- [/llms-full.txt](https://www.airsockfly.com/llms-full.txt)Full content reference for language models
- [/.well-known/ai-catalog.json](https://www.airsockfly.com/.well-known/ai-catalog.json)AI catalog for agent discovery
- [/.well-known/ard.json](https://www.airsockfly.com/.well-known/ard.json)Agentic Resource Discovery catalog
- [/api/mcp/server-card](https://www.airsockfly.com/api/mcp/server-card)MCP Server Card (server metadata)
- [/en/rss.xml](https://www.airsockfly.com/en/rss.xml)Blog articles, RSS 2.0
- [/en/atom.xml](https://www.airsockfly.com/en/atom.xml)Blog articles, Atom 1.0
- [/sitemap.xml](https://www.airsockfly.com/sitemap.xml)Map of all public pages
- [/robots.txt](https://www.airsockfly.com/robots.txt)Crawler rules and content signals
- [/en/developers.md](https://www.airsockfly.com/en/developers.md)Any public page as Markdown: header Accept: text/markdown or the .md suffix

## 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](https://registry.modelcontextprotocol.io/v0/servers?search=com.airsockfly.www%2Fairsockfly)
