Gemini CLI setup

Connect Gemini CLI to live award availability

One command adds Award Travel Finder to Gemini CLI. Sign in with /mcp auth. There is no API key to paste. 142 tools, no API key.

Set up Gemini CLI OAuth reference

Set up Gemini CLI

Run this command in your terminal:

gemini mcp add --transport http award-travel-finder https://mcp.awardtravelfinder.com/mcp

Or add the server to ~/.gemini/settings.json. Streamable HTTP servers use the httpUrl key:

{
  "mcpServers": {
    "award-travel-finder": {
      "httpUrl": "https://mcp.awardtravelfinder.com/mcp"
    }
  }
}

Inside Gemini CLI, run /mcp auth. Your browser opens so you can sign in to Award Travel Finder.

Available tools

142 tools in total. A few of the ones you will use most:

search_availability
Search award seats for a route, date range and cabin.
search_monthly_availability
See which days in a month have award space.
price_award_route
Price a route in points across programs.
find_transfer_paths
Find which card points transfer to the program you need.
compare_cash_vs_points
Compare the cash fare with the points price.
estimate_award_fees
Estimate the taxes and fees on an award ticket.
create_route_monitor
Watch a route and get told when award space opens.

Try these prompts

Route

“Find business class award seats from JFK to London Heathrow in the next three months.”
“What is the cheapest month to fly San Francisco to Tokyo in business class with miles?”

Program or alliance

“Which Star Alliance programs show saver award space from Chicago to Frankfurt?”
“How do I transfer Amex Membership Rewards points to book a Virgin Atlantic award?”

Filters

“Show nonstop first class awards only from Los Angeles to Sydney under 100,000 points.”
“Find two seats together in premium economy from Boston to Dublin next summer.”

Details

“Estimate the taxes and fees on that award, and tell me if cash would be cheaper.”
“Set up a monitor for award space on Seattle to Paris and tell me when it opens.”

Frequently asked questions

How do I add Award Travel Finder to Gemini CLI?

Run gemini mcp add --transport http award-travel-finder https://mcp.awardtravelfinder.com/mcp, then run /mcp auth inside Gemini CLI to sign in.

Should I use httpUrl or url in settings.json?

Use httpUrl for a streamable HTTP server like this one. The url key is for SSE servers.

How do I sign in again?

Run /mcp auth inside Gemini CLI.

Do I need an API key?

No. The endpoint is OAuth-only, so no API key or Authorization header is needed.

What can I ask once it is connected?

Ask for award seat availability by route, date and cabin, compare programs and transfer partners, price a route in points, and set up route monitors. The prompts on this page are a starting point.