Kiwi.com MCP Server

Reservas, viajes y reembolsos en tu cuenta de Kiwi.com.

Servidor MCP alojado

npx add-mcp 'https://cotlet.dev/mcp/v1/kiwi-com'

Se instala en Claude Code, Codex, Cursor y más

Documentación

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.

MCP setup REST API guide

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 needKiwi.com MCP serverTequila APICotlet
Search flights with a booking linkYes, freeInvited partnersYes
See the trips on your accountNoNoYes
Passport details and boarding passesNoNoYes
Bags, seats and cancellationsNoNoYes, after your OK
Open to anyone todayYesBy invitationYes

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?

  1. Sign in to Kiwi.com. Use your own account in its Cotlet Cloud Browser.
  2. Choose MCP or REST. Connect your agent or create a Cotlet API key.
  3. 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.

  1. Switch on Kiwi.com for agents. Open a Cotlet account, sign in to Kiwi.com in its Cloud Browser and press Enable for agents.
  2. Add the Cotlet address. Enter https://cotlet.dev/mcp/v1 in the MCP or connector settings of your agent.
  3. 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

ToolConnect throughExample workflow
n8nHTTP RequestRead upcoming trips and trip details into a journey brief with missing-document requirements.
MakeHTTP > Make a requestCollect available boarding-pass and invoice links in a private trip-document archive.
Python or Node.jsREST APIRead 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

  1. Reads the trip. Self-transfer, hidden city or past the 36-hour cutoff stops it early.
  2. Prices the options. Each bag per traveller, with the price Kiwi.com shows.
  3. Waits for your OK. Traveller, bag and price, in your Cotlet console.
  4. Reads it back. The trip again, to confirm the bag is on both flights.
ActionUndo
Add a bagNo. It cannot be removed or moved to another traveller, only upgraded
Pick a seatNo undo tool. A paid seat is charged when it is picked
Cancel a tripNo. Kiwi.com handles it under the ticket type and airline rules
Search, trips, passes, invoicesNothing 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.

JobCallsCredits
Check-in sweep of upcoming trips, daily2 × 30600
Add passport details for a traveller3 × 6180
Collect boarding passes on flight days1 × 16160
Add a checked bag5 × 2100
Invoices for expenses, monthly5 × 150
Cancel a trip after a refund check4 × 140
Cloud Browser, 30 days1,500
Total2,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

OptionWhat it doesWhere it stops
Kiwi.com MCP serverOfficial 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-mcpMIT, 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 ApifyAn 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.

Also listed on: Odel, mcpbeat

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.