# Kiwi MCP Server (`agentify/kiwi-mcp-server`) Actor

Kiwi.com flight search MCP server. Search and book flights directly from your favorite AI assistant!

- **URL**: https://apify.com/agentify/kiwi-mcp-server.md
- **Developed by:** [agentify](https://apify.com/agentify) (community)
- **Categories:** Agents, MCP servers, Open source
- **Features:** Full permissions, Single-tenant, Server interface
- **Stats:** 93 total users, 7 monthly users, 100.0% runs succeeded, 3 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.001 / flight search

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Kiwi MCP Server

Search and book flights directly from your favorite AI assistant using the Kiwi.com flight search engine!

**About this MCP Server:** To understand how to connect to and utilize this MCP server, please refer to the official Model Context Protocol documentation at [mcp.apify.com](https://mcp.apify.com).

### Connection URL

MCP clients can connect to this server at:

```text
https://mcp-servers--kiwi-mcp-server.apify.actor/mcp
```

### Client Configuration

To connect to this MCP server, use the following configuration in your MCP client:

```json
{
  "mcpServers": {
    "kiwi-mcp-server": {
      "url": "https://mcp-servers--kiwi-mcp-server.apify.actor/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_APIFY_TOKEN"
      }
    }
  }
}
```

**Note:** Replace `YOUR_APIFY_TOKEN` with your actual Apify API token. You can find your token in the [Apify Console](https://console.apify.com/account/integrations).

### Links

- **GitHub Repository**: https://github.com/alpic-ai/kiwi-mcp-server-public
- **Actor Repository**: https://github.com/apify/actor-kiwi-mcp-server
- **Apify MCP Documentation**: https://mcp.apify.com

### 🚩 Claim this MCP server

All credits to the original authors of https://github.com/alpic-ai/kiwi-mcp-server-public
To claim this server, please write to <ai@apify.com>.

***

## Kiwi.com Flight Search

This is the Kiwi.com flight search MCP server. Search and book flights directly from your favorite AI assistant!

### About this MCP Server

The [Kiwi.com](https://kiwi.com) MCP server allow you to search and book for flights using the Kiwi.com flights search engine.

The MCP server exposes a single tool: search-flight. This allows you to get instant access to a curated list of the best flights for your trip based on:

1. Round-trip or one-way flight
2. Origin / destination (city or airport)
3. Travel dates
4. Flexibility up to +/- 3 days
5. Number and types of passengers (adult, child, infant)
6. Cabin class (economy, premium economy, business, first class)

Simply ask your AI assistant something like:

- "Can you help me book a first-class ticket from Paris to Rome tomorrow?"
- "Find me the best options for our family vacation. I need a round-trip flight for my husband, me and our two children from Vienna to London, August 3 to 10."

You can also narrow your query by choosing your preferred airport, or enlarge it by specifying that your dates are flexible. Each result includes a booking link directly to the flight chosen.

### Available Tools

#### search-flight

Search for flights using the Kiwi.com flight search engine. This tool allows you to:

- Search for round-trip or one-way flights
- Specify origin and destination (city or airport codes)
- Set travel dates with flexibility up to +/- 3 days
- Configure passenger details (adults, children, infants)
- Select cabin class (economy, premium economy, business, first class)
- Get booking links for selected flights

### Installation Guide

<details>
<summary>Claude Teams</summary>

#### Manual steps

*Note: Only workspace owners and admins have permission to add custom connectors*

- Navigate to **Settings > Connectors**

- Toggle to **Organization connectors** at the top of the page

- At the bottom of the page, click on **Add custom connector** and fill the following information:
  - Name: `kiwi-com-flight-search`
  - Remote MCP server URL: `https://mcp-servers--kiwi-mcp-server.apify.actor/mcp`

- Click **Add** to finish the setup

</details>

<details>
<summary>Claude Pro and Max</summary>

#### Manual steps

- Navigate to **Settings > Connectors**
- Click **Add custom connector** at the bottom of the section
- Enter the URL of the remote MCP server: `https://mcp-servers--kiwi-mcp-server.apify.actor/mcp`
- Click **Add** to finish the setup
- If using Claude desktop, restart to make sure changes take effect

</details>

<details>
<summary>OpenAI ChatGPT</summary>

##### Manual steps:

*Note: In Team, Enterprise, and Edu workspaces, only workspace owners and admins have permission*

- Navigate to **Settings > Connectors**
- Add a custom connector with the server URL: `https://mcp-servers--kiwi-mcp-server.apify.actor/mcp`
- It should then be visible in the **Composer > Deep research** tool
- You may need to add the server as a source

*Connectors can only be used with __Deep Research__*

</details>

<details>
<summary>Cursor</summary>

##### One-click installation:

Open this link in a browser: cursor://anysphere.cursor-deeplink/mcp/install?name=kiwi-com-flight-search\&config=eyJ1cmwiOiJodHRwczovL21jcC1zZXJ2ZXJzLS1raXdpLW1jcC1zZXJ2ZXIuYXBpZnkuYWN0b3IvbWNwIn0

##### Manual steps:

- Go to **Settings > Cursor Settings > Tools & Integrations**
- Under **MCP tools**, click **Add Custom MCP**
- Paste the configuration into **mcp.json**
- Save the file to apply the configuration
- Restart **Cursor** if prompted

##### Configuration:

```json
{
  "mcpServers": {
    "kiwi-com-flight-search": {
      "url": "https://mcp-servers--kiwi-mcp-server.apify.actor/mcp"
    }
  }
}
```

</details>

<details>
<summary>VS Code</summary>

##### One-click installation:

[<img src="https://img.shields.io/badge/VS_Code-VS_Code?style=flat-square&label=Install%20Server&color=0098FF" alt="Install in VS Code">](https://insiders.vscode.dev/redirect?url=vscode:mcp/install?%7B%22type%22%3A%22http%22%2C%22name%22%3A%22kiwi-com-flight-search%22%2C%22version%22%3A%220.0.1%22%2C%22description%22%3A%22Search%20and%20book%20flights%20directly%20from%20your%20favorite%20AI%20assistant%20using%20the%20Kiwi.com%20flight%20search%20engine!%22%2C%22url%22%3A%22https%3A%2F%2Fmcp-servers--kiwi-mcp-server.apify.actor%2Fmcp%22%2C%22author%22%3A%22Kiwi.com%22%2C%22tags%22%3A%5B%22kiwi-com-flight-search%22%2C%22mcp%22%2C%22server%22%5D%2C%22categories%22%3A%5B%22mcp%22%5D%7D)
and click on **Install**

##### Manual steps:

Use the command line:

```bash
code --add-mcp '{"type":"http","name":"kiwi-com-flight-search","version":"0.0.1","description":"Search and book flights directly from your favorite AI assistant using the Kiwi.com flight search engine!","url":"https://mcp-servers--kiwi-mcp-server.apify.actor/mcp","author":"Kiwi.com","tags":["kiwi-com-flight-search","mcp","server"],"categories":["mcp"]}'
```

Then go to Extensions, find the **Kiwi.com Flight Search** MCP server in the list, open the menu with right-click and click on and **Start Server**.

</details>

<details>
<summary>Claude Code</summary>

##### Manual steps:

Use the command line to add the MCP server:

```bash
claude mcp add --transport http kiwi-com-flight-search https://mcp-servers--kiwi-mcp-server.apify.actor/mcp
```

</details>

<details>
<summary>Cline</summary>

##### Manual steps:

- Click on the **Cline** icon in the VSCode sidebar
- Click on the **MCP Servers** tab
- Click on the **Remote Servers** tab
- Fill in the required information:
  - Server Name: `kiwi-com-flight-search`
  - Server URL: `https://mcp-servers--kiwi-mcp-server.apify.actor/mcp`
- Click **Add Server** to initiate the connection
- Cline will attempt to connect to the server and display the connection status
- If the connection is successful, click on **Done**

</details>

<details>
<summary>Goose</summary>

##### One-click installation:

[![Install in Goose](https://block.github.io/goose/img/extension-install-dark.svg)](https://block.github.io/goose/extension?url=https%3A%2F%2Fmcp-servers--kiwi-mcp-server.apify.actor%2Fmcp\&id=kiwi-com-flight-search-mcp-server\&name=Kiwi.com%20Flight%20Search\&description=Search%20and%20book%20flights%20directly%20from%20your%20favorite%20AI%20assistant%20using%20the%20Kiwi.com%20flight%20search%20engine!\&type=streamable_http)

##### Manual steps:

- Go to **Extensions**
- Click on **Add custom extension**
- Fill the following information:
  - Extension Name: `kiwi-com-flight-search`
  - Type: `HTTP`
  - Description: `Search and book flights directly from your favorite AI assistant using the Kiwi.com flight search engine!`
  - Endpoint: `https://mcp-servers--kiwi-mcp-server.apify.actor/mcp`
- Click **Add Extension** to finish the setup

</details>

***

Thank you!

*These installation instructions were generated by the [MCP Install Instructions Generator](https://mcp-install-instructions.alpic.cloud/) by [Alpic.ai](https://alpic.ai)*

### References

To learn more about Apify and Actors, take a look at the following resources:

- [Apify SDK for JavaScript documentation](https://docs.apify.com/sdk/js)
- [Apify SDK for Python documentation](https://docs.apify.com/sdk/python)
- [Apify Platform documentation](https://docs.apify.com/platform)
- [Apify MCP Server](https://docs.apify.com/platform/integrations/mcp)
- [Webinar: Building and Monetizing MCP Servers on Apify](https://www.youtube.com/watch?v=w3AH3jIrXXo)
- [Join our developer community on Discord](https://discord.com/invite/jyEM2PRvMU)

# Actor input Schema

## Actor input object example

```json
{}
```

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {};

// Run the Actor and wait for it to finish
const run = await client.actor("agentify/kiwi-mcp-server").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {}

# Run the Actor and wait for it to finish
run = client.actor("agentify/kiwi-mcp-server").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{}' |
apify call agentify/kiwi-mcp-server --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,agentify/kiwi-mcp-server"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/twysz32HL4q7OdmMY/builds/yE9IzNWWIgj5czoMs/openapi.json
