Cabin API

Flight search and booking with USDC on Base, exposed as an MCP server for AI-assisted flight tools.

javascript

0

GitHub Stars

javascript

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "yolo-maxi-cabin": {
      "command": "node",
      "args": [
        "/full/path/to/cabin-api/src/mcp-server.js"
      ],
      "env": {
        "CABIN_API_URL": "https://api.cabin.team"
      }
    }
  }
}

You can search for flights, create bookings, and manage payments using the Cabin MCP Server, which exposes flight tools to AI assistants through the Model Context Protocol. This enables conversational agents to discover flight options, place bookings, and guide users through USDC payments on Base in a streamlined, automated way.

How to use

You will interact with Cabin’s flight tools through an MCP client. The tools allow you to search for flights, create bookings from offers, check booking status, and retrieve USDC payment instructions. Use these capabilities to build AI-assisted flight experiences where users can browse options, select itineraries, and complete payments without leaving the conversational context.

How to install

Prerequisites: ensure you have Node.js and npm installed on your system.

Install dependencies for the Cabin MCP server.
Run the MCP server in stdio mode to enable local messaging or start the HTTP server for web access.
Verify the MCP server is running and reachable by your MCP client.
If you want to use a local configuration for Claude Desktop, place the MCP server configuration in the appropriate Claude Desktop config file and restart Claude Desktop.

Additional setup notes

Claude Desktop configuration example for MCP integration shows how to register the Cabin MCP server with a local path to the server script and an environment variable that points to the Cabin API base URL.

{
  "mcpServers": {
    "cabin-flights": {
      "command": "node",
      "args": ["/full/path/to/cabin-api/src/mcp-server.js"],
      "env": {
        "CABIN_API_URL": "https://api.cabin.team"
      }
    }
  }
}

Test commands and runtime modes

For local testing, you can run the MCP server in stdio mode to pipe JSON-RPC messages between the client and the server.

node src/mcp-server.js

Or run the server in HTTP mode to expose endpoints on port 3321.

node src/mcp-server.js --http

Available tools

cabin_search

Search for flights between airports, returning matching itineraries and prices.

cabin_book

Create a booking from a selected flight offer, initiating the end-to-end booking flow.

cabin_status

Check the status of an existing booking by its identifier.

cabin_pay

Provide USDC payment instructions for completing a booking on Base.