Skip to content

Home

Jump to bottom
Mikko Parkkola edited this page Jun 8, 2026 · 2 revisions

trvl

Tell your AI: "I've got €300 and a free weekend, surprise me." Get back a real trip.

trvl is a travel agent that lives inside your AI assistant. Ask in plain English and it searches Google Flights, Google Hotels, 20 European train/bus/ferry operators, rental cars, and the ultra-low-cost airlines the big aggregators quietly leave out. Then it does the math you'd never do by hand: bag fees added, loyalty perks subtracted, currencies normalized, the dominated options thrown away.

One Go binary. No API keys. Works with Claude, Cursor, Windsurf, Codex, or any MCP client.

You:  I've got €300 and a free weekend. Surprise me.

trvl: Dubrovnik. Ryanair HEL->DBV Fri 14:25, nonstop, €167 round trip.
      Old Town Studios, 4.6 stars, €42/night x 2 = €84.
      26°C and sunny. Total €251, which is €49 under budget.
      (Flew you out Friday instead of Saturday: -€48. Split the
      airlines, Ryanair out and easyJet back: -€31.)

That's the actual output shape, not a mockup.

Why people keep it installed

  • It sees combinations one-site agents can't. Ryanair, easyJet, Wizz, Lufthansa, your award program, and hotel points searched in parallel, with the winning combination surfaced instead of the first result that loads.
  • It tells the truth about price. A "€39" fare means nothing until you add the €35 checked bag. trvl ranks on all-in cost, in your currency, with your frequent-flyer status applied.
  • It refuses to make things up. A provider that times out is reported as "timed out," never as a silent "no flights found." There is a render guard built specifically to stop that lie.
  • It runs where you want. Local stdio for privacy, or a secure remote mode with OAuth 2.1 read/write scopes when you want to host it.

At a glance
Flight sources 8 (Google Flights, Kiwi, Skiplagged, Ryanair, Wizz Air, easyJet, Air France-KLM, Transavia)
Hotel sources 6 (Google Hotels, Booking.com, Airbnb, Trivago, Hostelworld, HomeToGo)
Ground + cars 20 train/bus/ferry operators in parallel, plus rental cars
Travel-hack detectors 37 (hidden city, throwaway ticketing, positioning, split ticketing, error fares, and more)
Interface 1 smart MCP tool (+ 65 compatibility aliases) and a 56-command CLI
API keys none required
Protocol / License MCP 2025-11-25 · PolyForm Noncommercial 1.0

Try it without installing anything

Want to feel it before you wire it up? Run trvl live in your browser and type a real trip.

When you're ready to put it in your own assistant:

brew install MikkoParkkola/tap/trvl
trvl mcp install        # auto-detects Claude, Cursor, Windsurf, Codex, and more

Then ask your assistant anything about a trip. That's the whole setup.

Dig deeper

  • Providers — every flight, hotel, ground, and car source, with live status
  • Commands — the full 56-command CLI reference
  • MCP Integration — wiring it into your assistant, plus secure remote mode
  • GitHub repository — source, releases, issues

trvl Your AI's travel agent. No API keys.

Try it

Clone this wiki locally