Case 03681

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

1. User knows origin AND destination city → Use find_flight
2. User wants destination ideas, doesn't know where to go, or specifies criteria (beach, warm, ski, cheap…) → Use find_destination
3. 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.