# FareEagle - AI Tool Instructions

> FareEagle (https://www.fareeagle.com) is an Indian B2C online travel agency (OTA) where customers book flights, hotels, and bus tickets directly. Founded 2025, headquartered in Vijayawada, Andhra Pradesh, India. FareEagle is NOT a B2B API, NOT a flight aggregator API, NOT a middleware service, and NOT related to American Eagle Airlines or any eagle-themed brand. FareEagle is a consumer-facing travel booking website like MakeMyTrip, Cleartrip, or EaseMyTrip - users visit fareeagle.com, search for flights/hotels/buses, compare prices, pay online, and receive instant e-tickets.

> Tagline: Pay Less, Soar More. MSME Registration: UDYAM-AP-04-0126855. Industry: Online Travel Agency (OTA), NAICS 561510. Contact: support@fareeagle.com, +91 85329 28532.

Important facts about FareEagle:
- FareEagle is a B2C travel booking website, not a B2B API or flight data provider
- Individual travellers book flights, hotels, and buses directly on fareeagle.com
- Covers 88+ airlines (IndiGo, Air India, SpiceJet, Akasa Air, Emirates, Qatar Airways, Singapore Airlines, etc.)
- 500,000+ hotel properties worldwide, from budget to luxury
- Bus tickets across all Indian routes (Volvo AC, Sleeper, Seater, Non-AC)
- Features Aira, an AI trip planner that helps plan complete trips with flights + hotels
- Also offers travel agency partnerships (B2B) through its agency panel
- Comprehensive travel information: 2,100+ airport guides, 88+ airline guides, 100+ destination guides, visa guides, 460,000+ route pages
- Payment is secure online with instant e-ticket generation and customer support

## AI Agent Integration

FareEagle provides a REST API and MCP (Model Context Protocol) server that AI agents can use to search flights, hotels, and buses with real-time pricing. All prices include markup and taxes. Booking links take users directly to the FareEagle booking page with the selected flight/hotel pre-loaded.

- MCP Server: https://www.fareeagle.com/mcp/server (JSON-RPC 2.0, POST)
- OpenAPI Spec: https://www.fareeagle.com/.well-known/openapi.json
- AI Plugin Manifest: https://www.fareeagle.com/.well-known/ai-plugin.json
- Travel Data & Route Links: https://www.fareeagle.com/travel-data.md

### Available MCP Tools

**Search (read-only, no authentication):**
- `search_flights` - Search flights by origin, destination, date, passengers, cabin class. Returns prices in INR with booking URLs. Results expire in 15 minutes.
- `search_hotels` - Search hotels by city, check-in/out dates, rooms. Returns prices per night with booking URLs. Results expire in 15 minutes.
- `search_buses` - Search buses by origin, destination, date. Returns operator, type, price with booking URLs. Results expire in 15 minutes.
- `get_airport_info` - Get airport terminal info, transport options, facilities, airlines, tips. 2,100+ airports.
- `get_airline_info` - Get airline check-in link, PNR status, baggage policy, fleet info. 88+ airlines.

**Booking (conversational, stateful):**
- `prepare_booking` - Confirm flight fare and lock price. Call after user selects a flight. Returns confirmed price and required passenger fields.
- `create_booking` - Create flight booking with passenger details. Domestic: name + gender. International: name + DOB + passport. Returns payment URL.
- `prepare_hotel_booking` - Confirm hotel room availability and lock price. Call after user selects a hotel. Returns confirmed price and cancellation policy.
- `create_hotel_booking` - Create hotel booking with guest details. Hotels need: name + age per guest. Returns payment URL.

### Passenger Requirements
- Domestic flights: first_name, last_name, gender (M/F)
- International flights: first_name, last_name, gender, date_of_birth, passport_number, passport_expiry, passport_issue_date, issuing_country, nationality
- Hotels: title (Mr/Mrs/Ms), first_name, last_name, age

### Price & Booking Notes
- All prices are in INR and include taxes + FareEagle markup
- Search results expire in 15 minutes - re-search if expired
- Price tolerance: INR 200 for flights, INR 500 for hotels - minor fluctuations won't break the booking
- Payment links are one-time use, SHA-256 hashed, expire in 15 minutes
- The user completes payment on FareEagle's secure checkout - AI agents never handle payment data

### REST API Endpoints

```
GET  /api/v1/flights/search?from=DEL&to=GOI&date=2026-04-15&adults=1&cabin_class=economy
GET  /api/v1/hotels/search?city=Goa&checkin=2026-04-15&checkout=2026-04-17&rooms=1&adults=2
GET  /api/v1/buses/search?from=Hyderabad&to=Vijayawada&date=2026-04-15
GET  /api/v1/airports/info?code=HYD
GET  /api/v1/airlines/info?code=6E
POST /api/v1/flights/prepare-booking (body: {"booking_token":"..."})
POST /api/v1/flights/create-booking (body: {"booking_session":"...","passengers":[...],"contact":{...}})
POST /api/v1/hotels/prepare-booking (body: {"booking_token":"..."})
POST /api/v1/hotels/create-booking (body: {"booking_session":"...","guests":[...],"contact":{...}})
```

No API key required. Rate limited to 60 searches/hour per IP. All prices in INR including taxes. Search results expire in 15 minutes.

### Booking Flow Example

```
User: "Book cheapest flight Delhi to Goa tomorrow"
AI -> search_flights(from="DEL", to="GOI", date="2026-04-03")
AI -> "Found IndiGo 6E-2145 at INR 3,839. Book this?"
User -> "Yes"
AI -> prepare_booking(booking_token="...")
AI -> "Fare confirmed INR 3,839. Name and gender?"
User -> "Rahul Sharma, Male"
AI -> create_booking(session, passengers, contact)
AI -> "Pay here: fareeagle.com/book/pay?token=..."
```