book workflow.
Get an API key
Create a Jinko API key for scripts, CI, or MCP clients that need bearer-token access.
API key docs
Learn how to use API keys to authenticate with Jinko services.
Choose your connection method
Use MCP OAuth when the client supports it. Fall back to API keys for headless environments, or use the CLI for terminal workflows.- MCP OAuth
- API Key
- CLI
Best for Claude, ChatGPT, Cursor, and other MCP clients with OAuth + Dynamic Client Registration. Just provide the endpoint and the client handles discovery, registration, and browser sign-in automatically.MCP docs →
Available tools
| Tool | What it does |
|---|---|
| find_destination | Discover destinations and starting offers from origin airports |
| flight_calendar | Compare cheapest prices across a date range |
| flight_search | Live flight search + price-check by offer_token |
| hotel_search | Search hotels with rates and availability |
| trip | Build a trip: add items, set travelers, select ancillaries |
| book | Schedule checkout and get a Stripe checkout_url |
| get_trip | Inspect trip state — cart, quote, bookings |
| lookup_booking | Guest lookup by Jinko reference + last name |
| flight_refund | Check refund eligibility and initiate a refund |
| flight_exchange | Exchange a booked flight for a new itinerary |
Core workflow
Discover options
Use
find_destination (discovery across many routes) or flight_calendar (price calendar for a single route) to surface candidate flights.Select ancillaries (optional)
Call
trip with select_ancillaries, using the item_id returned by the quote response.Create the checkout session
Call
book with action: "fulfillment" to create the payment session and get checkout_url.