Skip to main content
Glama

Alice Flights — MCP Server for Flight Search

Alice Flights MCP server — Glama score

Add real-time flight search to any MCP client. Alice Flights is a hosted, remote Model Context Protocol (MCP) server that lets an AI assistant search flights — best, cheapest, and fastest options with live seat availability — directly in a conversation. Powered by Alice, one of Israel's best-known travel apps and a top flight seller.

This repository is the reference implementation of the Alice Flights MCP server and documentation for the hosted service. For everyday use there's nothing to run — Alice hosts it at https://mcp.alice.co.il/mcp (one-click, no API key). You can also run this server yourself: it's a complete, standalone MCP server, not a proxy.

Features

  • Best / cheapest / fastest — results arrive categorized, not as a flat list; every option carries why it was picked.

  • Live seat availability — a low-seats note when only a few seats remain.

  • Interactive results widget (MCP Apps) — carrier chips, itinerary timeline, baggage info, tabs, and a nonstop filter; renders inline in hosts that support MCP Apps. (Hosted service only.)

  • Bilingual — ask in English or Hebrew; Hebrew results render right-to-left. (Hosted service only.)

  • Read-only & anonymous — it searches and links you to book on alice.co.il; it can't book, charge, or change anything, and it needs no sign-in.

Related MCP server: skrishnak7-mcp

Use it from any MCP client

Alice is a standard remote MCP server (Streamable HTTP + OAuth), so it works with any MCP-capable client. Clients that read an mcp.json:

{
  "mcpServers": {
    "alice": {
      "type": "http",
      "url": "https://mcp.alice.co.il/mcp"
    }
  }
}

For stdio-only clients, bridge the hosted endpoint with mcp-remote:

{
  "mcpServers": {
    "alice": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.alice.co.il/mcp"]
    }
  }
}

(The first connection opens a browser once for the anonymous OAuth consent.)

Run it yourself

This repo is a complete, standalone MCP server (TypeScript, stdio transport) that talks to Alice's public flight-search endpoint (api.alice.co.il). No credentials, no API key, no sign-up — the affiliate identity is attached server-side at Alice's edge, so nothing secret is ever in this repo or on your machine.

git clone https://github.com/blackrabbit-travel/alice-flights-mcp
cd alice-flights-mcp
npm install
npm run build
npm run smoke             # boots the server, runs the MCP handshake and a real live search
npm start                 # runs the MCP server on stdio

Then point any stdio MCP client at the built entry:

{
  "mcpServers": {
    "alice": {
      "command": "node",
      "args": ["/path/to/alice-flights-mcp/dist/index.js"]
    }
  }
}

Or with Docker:

docker build -t alice-flights-mcp .
docker run -i --rm alice-flights-mcp

Rate limit. The public endpoint allows 10 searches per minute and 200 per day per IP address. Beyond that it answers 429 with a Retry-After, which the server turns into a plain "try again in N seconds" message. That is plenty for personal use; for anything heavier, or for the interactive widget and Hebrew results, use the hosted endpoint above.

Configuration is optional (see .env.example):

Variable

Default

Description

ALICE_API_URL

https://api.alice.co.il/flights/search

Override the search endpoint. Leave unset.

Tools

  • search_flights — Search flights by origin, destination, dates, passengers, and cabin class. Returns options tagged best / cheapest / fastest, each with price, itinerary, baggage, and seats_remaining.

Try asking:

  • "Find me a flight from Tel Aviv to London next Thursday, back on Sunday."

  • "What's the cheapest nonstop to Athens in August for two adults?"

About

Operated by Alice (alice.co.il). The flight-search backend (the search engine and pricing) is proprietary; the MIT license in this repository covers this connector — the MCP server implementation, Dockerfile, server.json, and config examples. The hosted service adds an interactive widget, bilingual UI, and OAuth consent on top of the same search_flights tool.

Available Tools

1 tool
search_flightsSearch FlightsA
Read-only

Search for available flights between two cities. Returns a curated set of options, each tagged with one or more categories:

  • best: the engine's recommended balance of price, total duration, and stops.

  • cheapest: lowest total price.

  • fastest: shortest total travel time. The categories overlap — a single flight can be both best and cheapest. Each option includes price, total durations, layovers, its categories, and a direct booking link. Options may include seats_remaining — the number of seats left in this booking class at this price; values of 4 or fewer indicate limited availability.

Inputs: origin (required), destination (required), departure_date (required), adults, +5 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4/5.0

    Scored across 1 tool

    Disambiguation5/5

    With only one tool, there is no possibility of confusion between tools. The tool's purpose is clearly defined as flight search, making its role unambiguous.

    Naming Consistency5/5

    The single tool name 'search_flights' follows a clear verb_noun pattern, and since there is only one tool, there is no inconsistency to evaluate.

    Tool Count3/5

    The server exposes only one tool, which feels thin for a flight-related service. While it may be sufficient for a search-only endpoint, it falls below the typical 3-15 tool range and leaves the impression of an underprovisioned server.

    Completeness2/5

    The tool covers basic flight search but lacks essential parameters like travel dates or passenger count, and there are no booking or management tools. This results in significant gaps for a flight service domain.

    Maintenance

    ActivitySlowing
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers