Kiwi.com MCP Server
Bookings, trips and refunds on your Kiwi.com account.
เซิร์ฟเวอร์ MCP แบบโฮสต์
npx add-mcp 'https://cotlet.dev/mcp/v1/kiwi-com'ติดตั้งลง Claude Code, Codex, Cursor และอื่นๆ
เอกสาร
Cotlet · Integrations · How it works · Security · For developers · For automation agencies · Blog · API docs · Help center · Changelog · Contact · Pricing · Sign up
Kiwi.com API and MCP server: Let your AI agent look after your Kiwi.com trips.
Kiwi.com runs an official MCP server for flight search, and it does not sign in to your account, so it cannot see or change a booking (checked 24 Oct 2026). Its partner API, Tequila, is closed to new sign-ups. Cotlet runs 13 Kiwi.com tools hosted, over MCP for agents and REST for scripts.
Read your Kiwi.com trips and travel documents through MCP or REST. Connect an AI agent, automation workflow or script to prepare your travel brief.
- Free 7-day trial, no card
- Unofficial, not affiliated with Kiwi.com
- Page: https://cotlet.dev/integrations/kiwi-com-api-mcp-server
Cotlet is an independent service. It is not affiliated with, endorsed by or sponsored by Kiwi.com. Kiwi.com is a trademark of its owner. If Kiwi.com's own integrations cover what you need, use them first.
What can you automate in Kiwi.com?
- Add passport details before the cutoff
- Save boarding passes to a folder
- Add a checked or cabin bag
- Pick seats where the airline allows
- Price a cancellation, then cancel
- Download invoices for expenses
Does Kiwi.com have an MCP server or an API?
- mcp.kiwi.com, built with Alpic, lists two tools: search-flight, whose results each carry a link to book on Kiwi.com, and feedback-to-devs, which Kiwi.com reserves for comments on search.
- Tequila has taken new partners by invitation only since 30 May 2024, aimed at airlines, airports and destination companies. partners.kiwi.com now redirects to that announcement.
- No Zapier app and no n8n node. Nothing official adds travel documents, bags or seats, fetches boarding passes or invoices, or cancels a trip.
| What you need | Kiwi.com MCP server | Tequila API | Cotlet |
|---|---|---|---|
| Search flights with a booking link | Yes, free | Invited partners | Yes |
| See the trips on your account | No | No | Yes |
| Passport details and boarding passes | No | No | Yes |
| Bags, seats and cancellations | No | No | Yes, after your OK |
| Open to anyone today | Yes | By invitation | Yes |
Checked 24 Oct 2026. Sources: Kiwi.com Flight Search MCP, Kiwi.com: a new approach to partnerships (30 May 2024), Kiwi Connector for Claude and ChatGPT (Kiwi.com, Dec 2025), Kiwi.com Help: how Kiwi.com online check-in works, Kiwi.com Help: how to add or change baggage, Kiwi.com Help: how can I cancel my trip for a refund
How does Cotlet connect to Kiwi.com?
- Sign in to Kiwi.com. Use your own account in its Cotlet Cloud Browser.
- Choose MCP or REST. Connect your agent or create a Cotlet API key.
- Run your workflow. Ask your agent or send an HTTP request.
We never save your Kiwi.com password, and no bag, seat or cancellation goes through until you approve it.
Connect Kiwi.com to your agent or workflow
Use MCP with your AI agent, or HTTP requests in n8n, Make, Zapier and scripts. Follow the MCP setup below or jump to the REST guide.
- Switch on Kiwi.com for agents. Open a Cotlet account, sign in to Kiwi.com in its Cloud Browser and press Enable for agents.
- Add the Cotlet address. Enter https://cotlet.dev/mcp/v1 in the MCP or connector settings of your agent.
- Sign in to Cotlet or use a key. Chat apps send you through a Cotlet sign-in. Code editors and scripts take an API key from the console.
The same connection carries Kiwi.com and every other app you enable. You can keep Kiwi.com's own search server next to it; the two do not clash. Enabled Kiwi.com after connecting? Refresh the connector to load its tools.
Claude:
Settings > Connectors > Add custom connector
URL: https://cotlet.dev/mcp/v1/connect
Claude Code:
claude mcp add --transport http cotlet \
https://cotlet.dev/mcp/v1 \
--header "Authorization: Bearer $COTLET_API_KEY"
ChatGPT:
Settings > Apps & Connectors > Create
MCP server URL: https://cotlet.dev/mcp/v1/connect
Authentication: OAuth
Cursor:
// ~/.cursor/mcp.json
{
"mcpServers": {
"cotlet": {
"url": "https://cotlet.dev/mcp/v1",
"headers": { "Authorization": "Bearer ${env:COTLET_API_KEY}" }
}
}
}
Codex:
# ~/.codex/config.toml
[mcp_servers.cotlet]
url = "https://cotlet.dev/mcp/v1"
bearer_token_env_var = "COTLET_API_KEY"
n8n:
MCP Client Tool (inside an AI Agent)
Transport: HTTP Streamable
URL: https://cotlet.dev/mcp/v1
Auth: Bearer, <your key>
Tool: kiwi_com_read
Make, Zapier:
Make: MCP Client > Call a tool
Zapier: MCP Client by Zapier > Run Tool
Server URL: https://cotlet.dev/mcp/v1
Token: <your key>
Tool: kiwi_com_write
How to use the Kiwi.com REST API
Create your Cotlet API key
Create a Cotlet API key with access to Kiwi.com and its read operations. Store it as COTLET_API_KEY in your environment or automation platform's credential store.
Sign in to Kiwi.com in its Cotlet Cloud Browser and enable the app for agents. Use the Kiwi.com account that holds your bookings.
Make your first Kiwi.com API request
cURL:
curl "https://cotlet.dev/api/v1/kiwi-com/trips?when=upcoming" \
-H "Authorization: Bearer $COTLET_API_KEY"
Read trip IDs and travel documents
A successful REST call puts the tool output in result. This illustrative response excerpt omits call IDs, messages and credit details.
Illustrative response excerpt:
{
"status": "success",
"app": "kiwi-com",
"tool": "list_trips",
"result": {
"trips": [
{
"trip_id": "512834907",
"route": "PRG-BCN-PRG",
"departs": "2026-11-14T07:20:00+01:00",
"passengers": 1,
"documents_missing": true
}
]
}
}
Read result.trips and use a returned trip_id for details and travel documents. Trip listing has no cursor, page, offset or limit inputs.
Compare departure dates, document requirements and check-in state as well as trip IDs. A later update can affect an existing booking.
Boarding passes appear only after Kiwi.com check-in. Passes obtained through airline self-check-in are not held by Kiwi.com.
Kiwi.com workflows for agents and automations
| Tool | Connect through | Example workflow |
|---|---|---|
| n8n | HTTP Request | Read upcoming trips and trip details into a journey brief with missing-document requirements. |
| Make | HTTP > Make a request | Collect available boarding-pass and invoice links in a private trip-document archive. |
| Python or Node.js | REST API | Read your credit balance to prepare reminders for expiring credit in your chosen destination. |
Send Authorization: Bearer <your Cotlet API key> in request headers. You configure the schedule, destination and record comparisons.
Cotlet reads Kiwi.com; your workflow steps write to your chosen destination. These HTTP workflows do not require a native Cotlet connector or a prebuilt template.
Python and Node.js can use the same HTTP requests without an AI agent. Keep access keys in credentials, outside shared workflow exports.
The API and MCP reference lists operations and inputs. The REST API guide explains authentication, errors and approvals.
Kiwi.com API endpoints and MCP tools
Flight search
The same job as Kiwi.com's own server: each flight comes with a booking link, and you pay on Kiwi.com.
- Search flights (
search_flights, read): Flights between two places for set dates, with price, duration and a booking link.
Trips, check-in and boarding passes
Kiwi.com takes passport details until 24 hours before departure, then checks you in. Passes come at least 6 hours before the flight, 2 hours for Ryanair.
- List trips (
list_trips, read): Trips on your account with booking number, route, dates and whether travel documents are missing. - Get trip (
get_trip, read): One trip: flights, passengers, bags, seats, check-in status and which travel documents are still needed. - Add travel documents (
add_travel_documents, write, asks first): Add the passport or ID details Kiwi.com needs to check a passenger in. - Get boarding passes (
get_boarding_passes, read): Boarding passes Kiwi.com received after checking you in, as download links.
Bags and seats
Bags are sold for the whole itinerary until 36 hours before the trip. Seats close 48 hours before departure, where the airline sells them at all.
- Get baggage options (
get_baggage_options, read): Bags you can still add to a trip, with the price of each. - Add baggage (
add_baggage, write, asks first): Buy a bag from get_baggage_options for the price shown there. - Get seat map (
get_seat_map, read): Seats you can pick on one flight of a trip, where the airline offers seat selection. - Select seat (
select_seat, write, asks first): Pick a seat for a passenger on one flight, where the airline offers it.
Cancellations, Credit and invoices
Cancelling closes 48 hours before the trip. Kiwi.com Credit shows up within minutes, money in about 7 to 10 business days.
- Get cancellation options (
get_cancellation_options, read): What you get back if you cancel this trip now, under its ticket type. - Cancel trip (
cancel_trip, write, asks first): Cancel a trip and request the refund you picked from get_cancellation_options. - Get Credit balance (
get_credit_balance, read): Your Kiwi.com Credit balance and its expiration date. - Get invoice (
get_invoice, read): Invoice of a booking as a PDF download link.
Inputs, REST path and example response of every tool: https://cotlet.dev/integrations/kiwi-com-api-mcp-server#tools
Who can see my Kiwi.com session, and how do I revoke it?
- What we store. Your signed-in Kiwi.com profile, AES-256-GCM encrypted, in Finland. Not the password.
- What your agent gets. The 13 Kiwi.com tools, never the cookie or the login.
- What the session sees. Your trips, every traveller on them and their document details, your Credit.
- What no tool touches. Password, saved cards, account settings and account deletion.
- If Kiwi.com signs you out. An email with a sign-in link reaches you. We never sign in in your place.
- How to cut access. Disable Kiwi.com for agents, reset its browser or delete the key. The next call is turned away.
Passport numbers pass through the tools only when you ask for add_travel_documents, and we do not log call contents. A+ on Qualys SSL Labs, securityheaders.com and Mozilla Observatory (live results).
Approvals, undo and mistakes
- Reads the trip. Self-transfer, hidden city or past the 36-hour cutoff stops it early.
- Prices the options. Each bag per traveller, with the price Kiwi.com shows.
- Waits for your OK. Traveller, bag and price, in your Cotlet console.
- Reads it back. The trip again, to confirm the bag is on both flights.
| Action | Undo |
|---|---|
| Add a bag | No. It cannot be removed or moved to another traveller, only upgraded |
| Pick a seat | No undo tool. A paid seat is charged when it is picked |
| Cancel a trip | No. Kiwi.com handles it under the ticket type and airline rules |
| Search, trips, passes, invoices | Nothing to undo, they only read |
4 of 13 tools ask first: passport details, bags, seats and cancellations. A timed-out bag purchase is never sent twice; the agent reads the trip first to see whether it went through. Turn the wait off per tool once you trust a rule.
MCP call:
{
"name": "add_baggage",
"arguments": {
"trip_id": "512834907",
"bag_option_id": "bo_chk20_p1"
}
}
REST:
curl -X POST https://cotlet.dev/api/v1/kiwi-com/trips/512834907/baggages \
-H "Authorization: Bearer $COTLET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"bag_option_id":"bo_chk20_p1"}'
Tool output:
{
"trip_id": "512834907",
"status": "added",
"bag": {
"bag_option_id": "bo_chk20_p1",
"description": "Checked bag, 20 kg",
"passenger_id": "p1"
},
"price": {
"amount": 64,
"currency": "EUR"
}
}
REST under /api/v1/kiwi-com serves the same tools to scripts and cron jobs, with one key and one price. The tools table lists the REST path of each tool.
How much does the Kiwi.com MCP server cost?
About $15 a month for about four round trips a month, 2,630 credits. Tickets, bags and seats are still paid to Kiwi.com.
| Job | Calls | Credits |
|---|---|---|
| Check-in sweep of upcoming trips, daily | 2 × 30 | 600 |
| Add passport details for a traveller | 3 × 6 | 180 |
| Collect boarding passes on flight days | 1 × 16 | 160 |
| Add a checked bag | 5 × 2 | 100 |
| Invoices for expenses, monthly | 5 × 1 | 50 |
| Cancel a trip after a refund check | 4 × 1 | 40 |
| Cloud Browser, 30 days | 1,500 | |
| Total | 2,630 |
- Free 7-day trial, no card
- 10 credits per successful call, MCP or REST
- 50 credits a day for the Cloud Browser
- A free Kiwi.com account is enough
Kiwi.com sold 18.9 million seats in 2025, about two per customer a year, so one trip a year is the usual account. Our example is a heavier one: four round trips, eight flights, a team assistant or a frequent flyer. Dollars at the $29 pack rate.
Kiwi.com MCP server: official, on GitHub or hosted
| Option | What it does | Where it stops |
|---|---|---|
| Kiwi.com MCP server | Official and free, no sign-in. One search tool with 47 filters: flexible dates, nights away, bags, airlines, self-transfer. | Search only. Its feedback tool says account and booking questions are out of scope. |
| fdionisi/kiwi-mcp | MIT, Rust, 0 stars. One plan_trip tool on the Tequila search API. | Needs a Tequila key, which new users cannot get since May 2024; last push 29 Mar 2025. |
| Kiwi MCP server on Apify | An Apify actor for Kiwi.com flight search, called with an Apify token. | Search only, paid by Apify usage, no account access. |
| npm kiwi-mcp (MCP Registry) | Third-party search and airline lookup, "needs a free API key". | Its source repo answers 404; search only. |
Looking for flights in a chat? Add Kiwi.com's own server, it is free and maintained by Kiwi.com. A GitHub server only helps if you already hold a Tequila key. Cotlet is for the part after you book: documents, passes, bags, seats, refunds and invoices on your own trips.
Who runs Cotlet
Cotlet belongs to Take Group sp. z o.o., a software company registered in Poland, EU (VAT PL6342984273) and working since 2019. Bart Krawczyk (Co-founder, CTO) and Jake Slugocki (Co-founder, SEO, sales and marketing) founded it. Questions about the Kiwi.com tools go to contact@cotlet.dev.
Kiwi.com API and MCP: questions
Can I use the Kiwi.com API without an AI agent?
Yes. Call Cotlet's REST API from a script or an HTTP step in n8n, Make or Zapier with your Cotlet key. MCP is the alternative for AI agents; you do not need to connect an agent to use REST.
How do I get access?
Sign up free at https://cotlet.dev, open Kiwi.com under Integrations in the console and sign in to Kiwi.com in its Cloud Browser. The trial starts when you sign up, no card asked.
How do I connect Kiwi.com to ChatGPT or Claude?
Sign up at cotlet.dev, log in to Kiwi.com once in its Cloud Browser and add Cotlet to ChatGPT or Claude, following the steps in your console. No API key is needed. ChatGPT and Claude then work in your Kiwi.com account through Cotlet, in their phone apps too.
What can ChatGPT do in Kiwi.com?
With Cotlet, ChatGPT, Claude and other AI agents handle jobs like these in Kiwi.com: online check-in and boarding passes; get your boarding passes; add a checked bag to a booked trip. You ask in plain words, and anything that reaches other people waits for your OK first.
Is booking a new flight possible?
search_flights finds flights and returns a Kiwi.com booking link for each, like the official MCP server does (checked 11 Oct 2026). You complete the booking and payment on Kiwi.com; Cotlet covers the trips already on your account.
Which Kiwi.com account does it use?
The account that holds your bookings, signed in once in your Cloud Browser. Cotlet keeps only the session, never your password, and reconnect asks you again if Kiwi.com signs you out.
Why not just use Kiwi.com's own MCP server?
For finding flights, do; it is free and has more search filters. It never signs in, so it cannot add passport details, fetch boarding passes, buy a bag, pick a seat or cancel a trip you already booked.
Can I still get a Tequila API key?
Not by signing up. Since 30 May 2024 new Tequila partnerships are by invitation only, aimed at airlines, airports and destination companies. Tequila was always for partners selling Kiwi.com flights, never for managing your own bookings.
Does it work on bookings made as a guest?
Kiwi.com links a booking to the email used for it, and signing in with that email shows the booking in your account. Bookings that show in your Kiwi.com account are the ones the tools see.
Is the MCP server different from the REST API?
Only in how you call it. Both carry the same 13 tools, inputs and answers, under one API key and one price. Agents use MCP; scripts, cron jobs and HTTP steps use REST.
Is Cotlet affiliated with Kiwi.com?
No. Cotlet is independent and not affiliated with Kiwi.com.
Give your AI agents your signed-in browser.
Product: Integrations · How it works · Pricing · Security
Resources: Blog · API docs · Help center · Changelog · GitHub
Solutions: For developers · For automation agencies
Company: About · AI info: company facts · Contact
Legal: Terms of service · Privacy policy · Refund policy · Acceptable use · Cookie policy · DPA · Subprocessors
Elsewhere: Status page · Cotlet on GitHub · Cotlet on X · Cotlet on LinkedIn · Cotlet on Product Hunt · Cotlet on Crunchbase · Cotlet on SaaSHub
Cotlet.dev is built by Bart Krawczyk and Jake Slugocki, the founders of Take Group sp. z o.o., ul. Wincentego Janasa 4, 40-855 Katowice, Poland. KRS 0000871398, NIP 6342984273, VAT EU: PL6342984273. About us
Cotlet is an independent service. It is not affiliated with, endorsed by or sponsored by any of the products listed on this site. Product names are trademarks of their respective owners.