Jinko Flight Search
Search flights and discover destinations via the Jinko MCP server (find_destination and find_flight tools).
MCP Connection
Connect the Jinko MCP server in Claude's settings or project integrations using this URL:
https://mcp.gojinko.com
This provides two tools: Jinko:find_destination and Jinko:find_flight.
Tool Selection
- User knows origin AND destination city → Use
find_flight - User wants destination ideas, doesn't know where to go, or specifies criteria (beach, warm, ski, cheap…) → Use
find_destination - User asks for the cheapest dates to a single known destination → Use
find_flight
Tool 1: find_destination — Discover Where to Go
Use when the user is exploring options and hasn't committed to a single destination city.
Required Parameters
origins— Array of IATA codes for ALL nearby airports at the user's origin.trip_type—"roundtrip"(default) or"oneway"(only when user explicitly says one-way).
Optional Parameters
| Parameter | Use when |
|---|---|
destinations |
User mentions a region, criteria, or list of candidate cities. Generate IATA codes matching the intent. Leave empty for global discovery ("anywhere", "surprise me"). |
departure_dates / departure_date_ranges |
User specifies dates or periods. All dates MUST be in the future. |
return_dates / return_date_ranges |
User specifies return windows. |
stay_days / stay_days_range |
User mentions trip length ("a week", "5-10 days"). |
max_price |
User mentions a budget. |
direct_only |
User asks for nonstop/direct flights. |
cabin_class |
"economy", "premium_economy", "business", or "first". |
currency |
ISO 4217 code matching user's locale. |
locale |
e.g. "en-US", "fr-FR". |
sort_by |
"lowest" (default) or "recommendation". |
Airport Identification — Critical
Always expand a city to ALL its airports:
- New York →
["JFK","LGA","EWR"] - London →
["LHR","LGW","STN","LTN","LCY"] - Paris →
["CDG","ORY"] - Tokyo →
["NRT","HND"] - Chicago →
["ORD","MDW"] - Los Angeles →
["LAX"] - San Francisco / SFO →
["SFO"]
Destination Generation — Critical
When users describe criteria, generate matching IATA codes before calling the tool:
- "Beach" →
["MIA","SAN","HNL","CUN","PUJ","SJU","NAS","MBJ"] - "Asia" →
["NRT","HND","ICN","PVG","PEK","HKG","SIN","BKK","KUL","MNL"] - "European capitals" →
["LHR","CDG","FRA","MAD","FCO","AMS","BRU","VIE","PRG","CPH"] - "Ski" →
["DEN","SLC","ZRH","INN","GVA","TRN"] - "Warm in winter" →
["MIA","MCO","SAN","PHX","HNL","CUN","PUJ","PTY","LIM","GIG"]
When to Re-call
Re-call find_destination when the user changes destination criteria, dates, or asks to explore different options — especially when they are already viewing the widget in fullscreen.
Examples
| User says | origins | destinations | other params |
|---|---|---|---|
| "Where should I travel from NYC next month?" | ["JFK","LGA","EWR"] |
[] (global) |
departure_date_ranges for next month |
| "Cheap flights from SF to Europe under $800" | ["SFO"] |
European airports | max_price: 800 |
| "Somewhere warm from Chicago, 1 week in Dec" | ["ORD","MDW"] |
warm-weather airports | stay_days: 7, Dec date range |
| "Best weekend getaways from Boston" | ["BOS"] |
[] (global) |
stay_days_range: {min:2, max:4} |
Tool 2: find_flight — Search a Specific Route
Use when both origin and destination cities are known.
Required Parameters
origin— Single IATA airport or city code (e.g."JFK","PAR").destination— Single IATA airport or city code (e.g."CDG","LON").trip_type—"roundtrip"(default) or"oneway".
Optional Parameters
Same date, stay, price, cabin, currency, locale, direct, and sort parameters as find_destination.
Examples
| User says | origin | destination | other params |
|---|---|---|---|
| "Flights from JFK to CDG next month" | "JFK" |
"CDG" |
departure_date_ranges for next month |
| "LA to Tokyo for a week in December" | "LAX" |
"TYO" |
stay_days: 7, Dec date range |
| "Business class NYC to London, 5-10 days" | "NYC" |
"LON" |
cabin_class: "business", stay_days_range: {min:5, max:10} |
| "Cheapest ORD to LHR under $600" | "ORD" |
"LHR" |
max_price: 600 |
General Rules
- Default to roundtrip. Only use
"oneway"when the user explicitly writes "one way" or "one-way". - All dates must be in the future. Never send a past date.
- Fill as many search parameters as possible from the user's intent to get the best results.
- Use city codes (e.g.
"LON","NYC","PAR","TYO") when searching across all airports in a city. - Provide results in the user's preferred currency and locale when identifiable.
