@cabin/agent

AI-first travel booking for assistants and agents. Search and book real flights with natural language and crypto payments.

Quick Start

# Install globally
npm install -g @cabin/agent

# Configure for Claude Desktop
npx @cabin/agent setup-claude

# Edit ~/.claude_desktop_config.json with your wallet private key
# Restart Claude Desktop and start searching flights!

Or use programmatically:

import { CabinX402Gate } from '@cabin/agent';

const gate = new CabinX402Gate({
  walletPrivateKey: process.env.X402_PRIVATE_KEY,
  cabinApiUrl: 'https://api.cabin.com',
  paymentEndpoint: 'https://api.x402.com/v1'
});

const flights = await gate.searchFlights({
  from: 'NYC',
  to: 'LAX',
  departure: '2026-03-15'
});

Features

• 🔍 Flight Search: Real-time data across 500+ airlines
• 💳 x402 Payments: $0.01 USDC per search, no subscriptions
• 🤖 MCP Integration: Works with Claude Desktop, Cursor, any MCP client
• 🏠 Self-Hosted: Run your own instance, control your data

Components

X402 Payment Gate

Handles cryptocurrency micropayments for API access:

import { CabinX402Gate } from '@cabin/agent/x402';

// Automatic payment + API call
const results = await gate.searchFlights(params);

MCP Server

Model Context Protocol server for AI assistants:

# Run standalone
cabin-mcp

# Or via Node.js
node dist/mcp/server.js

Landing Page

Static site at src/landing/index.html. Deploy anywhere:

# Serve locally
npm run start:landing

# Deploy to cabin.team
git push origin main

Configuration

Required environment variables:

• X402_PRIVATE_KEY - EVM wallet private key for payments
• CABIN_API_URL - Cabin backend API endpoint
• X402_PAYMENT_ENDPOINT - x402 service URL

Architecture

AI Agent → MCP Server → X402 Gate → Cabin API → Flight Data
    ↓         ↓           ↓           ↓           ↓
  Natural   Tool Call   USDC Pay   Search    Structured
 Language              ($0.01)    500+ Arlines  Response

Development

# Install dependencies
pnpm install

# Build TypeScript
pnpm build

# Watch mode
pnpm dev

# Run tests
pnpm test

# Start MCP server
pnpm start:mcp

Deployment

The package is designed for easy deployment:

• MCP Server: Runs as Node.js process, configure in Claude Desktop
• Landing Page: Static HTML, deploy to Vercel/Netlify/anywhere
• X402 Gate: Import as library in your own apps

Roadmap

• [ ] Flight booking (search is implemented)
• [ ] Hotel and car rental search
• [ ] Travel insurance integration
• [ ] Multi-agent trip planning
• [ ] Custom airline preferences

Support

• 📚 Documentation
• 🐛 Report Issues
• 💬 Discussions

License

MIT