Claude guide

Connect FlightSweeper to Claude

Add FlightSweeper as a custom Claude connector for live flight comparison and a hosted approval handoff.

OAuth setup supported

Claude connects to FlightSweeper with OAuth authorization code, PKCE, rotating refresh tokens, and an owner-scoped access token. The client never receives passenger identity or payment data.

Best for

Travelers using Claude on the web who want careful comparison of flexible dates and trip rules.

Starter prompt

Use FlightSweeper to compare live flights from LAX to ORD for two adults. Preserve quote time, expiry, refund terms, and role disclosure. After I choose and ask to buy, use book_flight.

Setup flow

Every client uses the same Streamable HTTP endpoint and documented public tool set. The primary book_flight action hides the internal intent and approval stages; approval and payment stay hosted.

FlightSweeper publishes OAuth discovery and Dynamic Client Registration. OAuth access tokens expire after 10 minutes, refresh tokens rotate, and the connection can be revoked from FlightSweeper.

1

In Claude, open Settings → Connectors and add a custom connector.

2

Use https://flightsweeper.com/api/agent/mcp as the remote server URL.

3

Authorize the connector with your FlightSweeper account using OAuth.

4

Confirm Claude discovers the documented FlightSweeper public tool set before the first live search.

5

Review the refreshed total and enter passenger and card details only on FlightSweeper.

Tool permissions

Every client should keep the same transaction boundary: search can happen in the agent, but booking happens after the traveler confirms a hosted checkout page.

Fare-bearing results include all-in total, currency, quotedAt, expiresAt, and refresh state.
book_flight is resumable: it binds the selected quote, returns the hosted approval/payment action, and resumes to canonical confirmation.
cancel_booking_intent applies only to approved, unpaid intents. Paid-order servicing and refunds stay hosted.
Booking status, policy summaries, and opaque traveler summaries are scoped to the authenticated owner.