Developer Documentation

MCP Server Documentation

Technical reference for the Look Book & Fly MCP server. Integrate private jet charter search, quoting, and booking into AI assistants via the Model Context Protocol.

Overview

The Look Book & Fly MCP server enables AI assistants to search for private jet charter flights across the global marketplace, submit quote requests to aircraft operators, and track quote status — all on behalf of the user within a conversational interface.

Server URL

https://www.lookbookandfly.com/api/mcp

Transport

Streamable HTTP (primary), SSE (legacy)

Authentication

None required (public API)

Operator

Jet Token Inc. (DOT-registered air charter broker)

Available Tools

search_airportsRead Only

Search for airports by name, city, or ICAO/FAA code. Returns up to 10 results ranked by relevance. For US airports, 3-letter FAA codes work (e.g., 'SAN' finds KSAN).

Parameters: query (string, min 2 chars), limit (number, optional)

search_flightsRead Only

Search for available charter aircraft between two airports. Returns aircraft options with estimated prices, flight times, images, safety ratings, and empty leg deals. Queries the global Avinode marketplace in real time (10-30 second response). On supported clients, renders an interactive UI with aircraft cards.

Parameters: from (ICAO), to (ICAO), date (YYYY-MM-DD), time (HH:MM), passengers (1-16), returnDate (optional), returnTime (optional)

request_quoteWrite

Submit formal quote requests to aircraft operators for selected aircraft from a search. Creates a trip record and sends RFQs via Avinode. Returns a reference code for tracking. Maximum 3 aircraft selections.

Parameters: searchId, selectedLeads (array), firstName, lastName, email, phone, message (optional), rerouteSelections (optional array)

get_quote_statusRead Only

Check the status of a quote request by reference code. Returns trip details, flight legs, and any quotes received from operators with firm pricing.

Parameters: quoteId (reference code or UUID)

contact_usWrite

Send a message to the charter team for inquiries outside the standard search-and-quote flow: group charters, special requirements, general aviation questions.

Parameters: name, email, phone (optional), message

Typical Workflow

Find airports

Use search_airports to resolve city names to ICAO codes (e.g., 'San Diego' → KSAN)

Search flights

Use search_flights with ICAO codes to get available aircraft, prices, and empty leg deals

Select aircraft

User selects up to 3 aircraft from the results (interactive UI on supported clients)

Request quotes

Use request_quote with selected IDs and customer contact info to submit RFQs to operators

Track status

Use get_quote_status with the reference code to check for operator responses

Usage Examples

Example 1: One-way flight search

User Prompt

Find me a private jet from San Diego to Las Vegas for 4 passengers next Friday morning.

Tools Used

search_airportssearch_flights

Expected Behavior

The assistant resolves "San Diego" to KSAN and "Las Vegas" to KLAS using search_airports, then calls search_flights with those codes, the date, time "09:00", and 4 passengers. Results include 8-15 aircraft options ranging from ~$8,500 (Light Jet) to ~$18,000 (Midsize Jet), plus any available empty leg deals. On supported clients, the user sees interactive aircraft cards with photos, specs, and prices they can click to select.

Example 2: Round-trip with quote request

User Prompt

I need a round trip from New York to Miami. 6 passengers, departing this Friday at 2pm, returning Sunday at 4pm. Get quotes on the cheapest midsize option and any empty legs.

Tools Used

search_airportssearch_flightsrequest_quote

Expected Behavior

The assistant: 1. Resolves airports: "New York" → KTEB (Teterboro) and "Miami" → KOPH (Opa-Locka Executive) via search_airports 2. Searches flights with returnDate and returnTime parameters 3. Identifies the cheapest midsize jet and any empty leg deals from results 4. Collects the user's name, email, and phone number 5. Submits the quote request via request_quote with the searchId and selected aircraft IDs Returns a reference code (e.g., "JK7M2P") and a tracking URL. The user receives a confirmation email. Operators typically respond with firm pricing within hours.

Example 3: Check quote status

User Prompt

What's the status of my quote request JK7M2P?

Tools Used

get_quote_status

Expected Behavior

The assistant calls get_quote_status with the reference code "JK7M2P". Returns the trip details (route, date, passengers), current status, and any quotes received from operators. If operators have responded, shows aircraft type, operator name, and firm pricing for each quote. The user can then decide whether to accept a quote.

Example 4: General inquiry via contact

User Prompt

I'm planning a corporate retreat for 30 people from Chicago to Aspen. Can you reach out to the charter team about group options?

Tools Used

contact_us

Expected Behavior

The assistant collects the user's name and email, then uses contact_us to send a message to the Look Book & Fly charter team describing the group charter need (30 passengers, Chicago to Aspen, corporate retreat). The charter team responds via email with options for multiple aircraft or larger cabin-class jets that can accommodate the group.

Setup Instructions

No authentication or API keys required. Simply add the server URL to your MCP client.

// Claude: Settings > Connectors > Add custom connector
Server URL: https://www.lookbookandfly.com/api/mcp

// ChatGPT: Settings > Apps > Developer Mode > Create
Server URL: https://www.lookbookandfly.com/api/mcp

// Claude Desktop (claude_desktop_config.json)
{
  "mcpServers": {
    "lookbook": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://www.lookbookandfly.com/api/mcp"]
    }
  }
}

Privacy & Support

How we handle data collected through the MCP server.

Terms governing use of Look Book & Fly services.

Email Support

contact@jettoken.com

Phone Support (24/7)

800-602-5678