# FlightQueue

> Real-time airport intelligence for AI agents: TSA/security wait times, FAA
> delays, security-wait predictions, historical patterns, and airline baggage
> stats for 8,000+ airports worldwide.

FlightQueue is built to be used by AI. An agent can sign itself up and start
calling tools in one HTTP request — no human, no browser, no payment required
for the free tier.

## Connect (autonomous, no human required)

1. Register for a free account and key:
   curl -X POST https://flightqueue.com/api/agent/register \
     -H 'Content-Type: application/json' \
     -d '{"agent_name":"my-agent"}'
   → returns { "api_key": "fqagent_…", ... }

2. Use the key as a Bearer token against the REST API:
   curl 'https://flightqueue.com/api/v1/airports/JFK/delays' \
     -H 'Authorization: Bearer fqagent_…'

   …or via the CLI (wraps the same API):
   npx @flightqueue/cli login --key fqagent_…
   npx @flightqueue/cli delays JFK

3. Inspect your account anytime:
   curl https://flightqueue.com/api/agent/me -H 'Authorization: Bearer fqagent_…'

## MCP clients (Claude, Cursor, Claude Code, ChatGPT)

These connect via automatic OAuth — just add the server URL (no key needed):
  https://mcp.flightqueue.com/mcp
  CLI: claude mcp add --transport http flightqueue https://mcp.flightqueue.com/mcp

## Free tools (no payment)

- search_airports — search 8,000+ airports by name, city, IATA, or ICAO
- get_airport_overview — location, terminals, runways, current delays
- compare_airports — side-by-side wait/delay comparison
- get_faa_delays — current US FAA delays, ground stops, weather impacts
- get_airport_delays_summary — FAA delay status for one airport
- get_security_wait_estimate — current TSA security wait snapshot
- get_best_time_to_fly — recommended arrival window for a flight time
- get_crowd_reports — recent user-submitted wait reports
- get_airline_baggage_rankings — airlines ranked by mishandled-bag rate
- get_airline_baggage_policy — carry-on/checked policy for an airline

## Paid tools (upgrade at https://flightqueue.com/pricing)

- get_wait_time_predictions — 24h / 7-day security-wait forecasts
- get_historical_wait_times — 7-day / 90-day hourly history
- get_live_wait_time — real-time scrape from 69+ airports

## Docs

- MCP docs: https://flightqueue.com/mcp
- Agent quickstart: https://flightqueue.com/features/agent-access
- MCP discovery: https://flightqueue.com/.well-known/mcp.json