@tixxly-ai/travel-mcp

MCP server that connects AI agents to Tixxly's travel commerce infrastructure. Search tours, check availability, and book experiences through any MCP-compatible AI assistant.

Tools

| Tool | Description | |------|-------------| | experiences_search | Search for tours, activities, and experiences | | experiences_detail | Get full details for a specific experience | | experiences_availability | Check available dates and time slots with pricing | | booking_options | Get booking form requirements (passenger details, questions) | | booking_reserve | Create a reservation and initiate payment | | booking_confirm | Confirm reservation and capture payment | | booking_status | Check the status of an existing reservation |

Setup

With Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "tixxly": {
      "command": "npx",
      "args": ["@tixxly-ai/travel-mcp"],
      "env": {
        "TIXXLY_API_URL": "https://api.tixxly.ai",
        "TIXXLY_API_KEY": "your-api-key"
      }
    }
  }
}

With any MCP client

TIXXLY_API_URL=https://api.tixxly.ai TIXXLY_API_KEY=your-key npx @tixxly-ai/travel-mcp

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | TIXXLY_API_URL | Yes | Tixxly API base URL | | TIXXLY_API_KEY | Yes | Vendor API key (with mcp group). Create one from your Tixxly dashboard. |

Authentication

The MCP server uses your vendor-specific API key (sent via x-api-key header). Each key is:

• Scoped to your vendor -- only your products are visible
• Tier-gated -- requires the Infrastructure plan for full MCP access
• Revocable -- can be deactivated from the admin dashboard

Example Conversation

"Find me a sunset sailing tour in Santorini"

The agent calls experiences_search with query "sunset sailing" and location "Santorini", then presents the results.

"Book the first one for 2 adults on June 15th"

The agent calls experiences_availability, then booking_options, booking_reserve, and booking_confirm to complete the booking flow.

Development

npm install
npm run dev       # Watch mode
npm run build     # Compile
npm run typecheck # Type-check

License

MIT