--- name: moltflights description: Search cheap flights via the MoltFlights API. Find deals, compare prices, track routes, and set up price alerts. homepage: https://moltflights.com metadata: openclaw: emoji: "✈️" keywords: [travel, flights, cheap-flights, search, booking, price-alerts, digital-nomad] tools: moltflights_search: description: Search for flights between two airports. Returns real-time prices with direct booking links. url: https://moltflights.com/api/search method: GET parameters: type: object properties: origin: type: string description: "IATA airport code for departure (e.g. HEL, JFK, LHR)" destination: type: string description: "IATA airport code for arrival (e.g. BKK, NRT, BCN)" date: type: string description: "Departure date YYYY-MM-DD. Omit for cheapest flights across the month." returnDate: type: string description: "Return date YYYY-MM-DD for round-trips. Omit for one-way." adults: type: integer description: "Number of adults 1-9 (default: 1)" children: type: integer description: "Number of children ages 2-12, 0-8 (default: 0)" infants: type: integer description: "Number of infants under 2, 0-8 (default: 0)" required: [origin, destination] moltflights_autocomplete: description: Look up IATA airport codes by city or airport name. url: https://moltflights.com/api/autocomplete method: GET parameters: type: object properties: term: type: string description: "City or airport name to search (min 2 characters)" required: [term] ---

MoltFlights — Flight Search Skill

Search cheap flights using the MoltFlights API. Returns structured JSON with real-time prices and direct booking links.

No API key required. No authentication. Just call the endpoint.

---

Tools

moltflights_search — Search Flights

GET https://moltflights.com/api/search?origin=HEL&destination=BKK&date=2026-03-15

| Parameter | Required | Type | Description | |---------------|----------|---------|--------------------------------------| | origin | yes | string | IATA airport code (e.g. HEL) | | destination | yes | string | IATA airport code (e.g. NRT) | | date | no | string | Departure date YYYY-MM-DD | | returnDate | no | string | Return date YYYY-MM-DD (round-trip)| | adults | no | integer | Number of adults, 1–9 (default: 1) | | children | no | integer | Children ages 2–12, 0–8 (default: 0) | | infants | no | integer | Infants under 2, 0–8 (default: 0) |

If date is omitted, the API returns the cheapest flights for the upcoming month.

moltflights_autocomplete — Look Up Airport Codes

GET https://moltflights.com/api/autocomplete?term=bangkok

| Parameter | Required | Type | Description | |-----------|----------|--------|------------------------------------------| | term | yes | string | City or airport name (min 2 characters) |

---

Example: Search Flights

curl "https://moltflights.com/api/search?origin=HEL&destination=BKK&date=2026-03-15"

Response

{
  "meta": {
    "source": "MoltFlights",
    "origin": "HEL",
    "destination": "BKK",
    "date": "2026-03-15",
    "adults": 1,
    "children": 0,
    "infants": 0,
    "results": 12
  },
  "data": [
    {
      "airline": "Finnair",
      "flight_number": "809",
      "price": "€432",
      "price_per_person": "€432",
      "departure": "2026-03-15T10:30:00",
      "return_at": "",
      "transfers": 1,
      "origin": "HEL",
      "destination": "BKK",
      "book_link": "https://www.aviasales.com/search/..."
    }
  ]
}

Each result includes a book_link — a direct booking URL the user can open.

---

Example: Round-Trip with Passengers

curl "https://moltflights.com/api/search?origin=JFK&destination=CDG&date=2026-06-01&returnDate=2026-06-15&adults=2&children=1"

The price field shows the total for all seat-occupying passengers. price_per_person shows the per-person price.

---

Common Use Cases

1. Find the cheapest flight to a destination

Search without a specific date to get the cheapest options for the whole month:

curl "https://moltflights.com/api/search?origin=LHR&destination=TYO"

2. Compare prices across dates

Run multiple searches for different dates and compare:

for date in 2026-04-01 2026-04-08 2026-04-15; do
  echo "=== $date ==="
  curl -s "https://moltflights.com/api/search?origin=HEL&destination=BKK&date=$date" | head -20
done

3. Price monitoring / alerts (cron job)

Check a route daily and alert when price drops below a threshold:

# Run daily via cron: 0 8 * * * /path/to/check-price.sh
PRICE=$(curl -s "https://moltflights.com/api/search?origin=HEL&destination=BKK&date=2026-05-01" \
  | grep -o '"price":"€[0-9]*"' | head -1 | grep -o '[0-9]*')

if [ "$PRICE" -lt 400 ]; then
  echo "Deal found: HEL→BKK for €$PRICE"
fi

4. Multi-city search

Search several routes and pick the cheapest:

for dest in BKK TYO BCN LIS; do
  echo "=== HEL → $dest ==="
  curl -s "https://moltflights.com/api/search?origin=HEL&destination=$dest" \
    | grep -o '"price":"€[0-9]*"' | head -1
done

---

Common IATA Codes

| Code | City | Code | City | |------|-----------------|------|---------------| | HEL | Helsinki | LHR | London | | JFK | New York | CDG | Paris | | NRT | Tokyo Narita | BKK | Bangkok | | BCN | Barcelona | FCO | Rome | | SIN | Singapore | DXB | Dubai | | LAX | Los Angeles | SFO | San Francisco | | BER | Berlin | AMS | Amsterdam | | IST | Istanbul | LIS | Lisbon |

Don't know the code? Use the moltflights_autocomplete tool:

curl "https://moltflights.com/api/autocomplete?term=bangkok"

---

Error Handling

• 400 — Missing origin or destination parameter
• Empty data array — No flights found for this route/date. Try a different date or omit the date for flexible search.

---

Tips

• Prices are in EUR (€)
• Results are sorted: exact date matches first, then nearby dates by price
• Omitting date gives you the cheapest flights across the whole upcoming month
• The API is free and requires no authentication
• Responses are cached for 5 minutes