1
Register (no auth, no payment)
One POST creates a free-tier account and returns an fqagent_ key. The key is shown once — save it.
register
curl -X POST https://flightqueue.com/api/agent/register \
-H 'Content-Type: application/json' \
-d '{"agent_name":"my-agent"}'response
{
"success": true,
"agent_id": "…",
"api_key": "fqagent_…",
"tier": "free",
"rest_api_base": "https://flightqueue.com/api/v1",
"cli": "npx @flightqueue/cli login --key YOUR_AGENT_KEY",
"free_tools": ["search_airports", "get_faa_delays", …],
"upgrade_url": "https://flightqueue.com/pricing"
}2
Connect with the key
The key authenticates the CLI and the REST API. (MCP clients like Claude and Cursor connect via OAuth and don't need a key — see below.)
cli
# Easiest: the CLI wraps the same REST API npx @flightqueue/cli login --key fqagent_… npx @flightqueue/cli delays JFK npx @flightqueue/cli airports --country US
rest
# …or hit the REST API directly with the key curl 'https://flightqueue.com/api/v1/airports/JFK/delays' \ -H 'Authorization: Bearer fqagent_…'
3
Introspect & upgrade
Check the account's tier and usage anytime. Free covers 10 airport tools; predictions, live, and historical data unlock with a paid plan.
introspect
curl https://flightqueue.com/api/agent/me \ -H 'Authorization: Bearer fqagent_…'
Using Claude, Cursor, or Claude Code?
Those clients handle OAuth automatically — you don't need a key. Just add the server URL https://mcp.flightqueue.com/mcp. The self-serve key above is for fully headless agents that don't run a browser. See the MCP docs for per-client setup.