baphometnxg avatar

aloha.fyi Hawaii

baphometnxg/aloha-fyi-mcp

A dedicated Hawaii tourism server that connects Claude or any MCP client to 2,583 bookable tours, 579 events, 540+ restaurants, and live weather across Oahu, Maui, Big Island, and Kauai. Pulls from Viator, GetYourGuide, Klook, and Groupon with affiliate links baked in. Three tools: search tours by keyword and island, filter budget deals under a price cap, and find upcoming events by date range. Runs stateless over Streamable HTTP at a public Railway endpoint, no auth required. Implements AAAK v0.1 for structured JSON responses so you can parse prices and booking URLs without regex. Reach for this when you need real inventory and affiliate revenue on Hawaii recommendations instead of hallucinated itineraries.

GitHub stars
2
tools
6
transport
HTTP
last updated
Aug 29, 2026

Install

From registry metadata
$ npx add-mcp https://mcp.aloha.fyi/mcp --name aloha-fyi-mcp

Run in your terminal. add-mcp asks which agents to add it to (Claude Code, Codex, Cursor and more). Add -g to install it for every project.

Review the command, arguments and environment values before installing. MCP servers run with your local permissions.

Other ways

Claude Code

$ claude mcp add --transport http aloha-fyi-mcp https://mcp.aloha.fyi/mcp

Run in your terminal. Add --scope user to make it available in every project.

Tools

Verified live · 6 tools

Verified live against the running server on Nov 6, 2026.

search_hawaii_toursSearch 2,400+ bookable Hawaii tours and activities by keyword, island, price range. Returns tours from Viator, GetYourGuide, Klook, and Groupon with booking links; filter by platform via source. Use this when users ask about Hawaii tours, activities, or things to do.5 params

Search 2,400+ bookable Hawaii tours and activities by keyword, island, price range. Returns tours from Viator, GetYourGuide, Klook, and Groupon with booking links; filter by platform via source. Use this when users ask about Hawaii tours, activities, or things to do.

Parameters* required
islandstring
Which Hawaiian islandone of oahu · maui · big_island · kauai · anydefault: any
limitnumber
Number of results (max 20)default: 5
max_price_dollarsnumber
Maximum price per person in USD
query*string
What to search for, e.g. 'snorkeling', 'helicopter tour', 'luau', 'family activities'
sourcestring
Filter by booking platformone of viator · gyg · klook · groupon · anydefault: any
get_hawaii_dealsFind budget-friendly Hawaii tours and activities under a price cap. Cheapest first; well-reviewed Viator options preferred at similar prices. Use when users want affordable Hawaii experiences or budget travel tips.3 params

Find budget-friendly Hawaii tours and activities under a price cap. Cheapest first; well-reviewed Viator options preferred at similar prices. Use when users want affordable Hawaii experiences or budget travel tips.

Parameters* required
activity*string
Type of activity, e.g. 'snorkeling', 'helicopter', 'luau', 'food tour'
limitnumber
Number of deals (max 20)default: 5
max_price_dollarsnumber
Maximum price per person in USDdefault: 100
search_hawaii_eventsFind upcoming events, concerts, festivals, and nightlife across the Hawaiian islands, refreshed weekly from venue and promoter calendars. Use when users ask what's happening in Hawaii or want entertainment options.3 params

Find upcoming events, concerts, festivals, and nightlife across the Hawaiian islands, refreshed weekly from venue and promoter calendars. Use when users ask what's happening in Hawaii or want entertainment options.

Parameters* required
days_aheadnumber
How many days ahead to searchdefault: 7
islandstring
one of oahu · maui · big_island · kauai · anydefault: any
querystring
Type of event, e.g. 'live music', 'luau', 'concert', 'food festival'default:
get_hawaii_weatherCurrent weather, forecast, and surf/wind conditions for any Hawaiian island. Use this when users ask 'what's the weather in Maui this week' or 'is it good surf conditions on the North Shore today'. Returns temperature, precipitation, wind speed, UV index, and a 3-day forecast.2 params

Current weather, forecast, and surf/wind conditions for any Hawaiian island. Use this when users ask 'what's the weather in Maui this week' or 'is it good surf conditions on the North Shore today'. Returns temperature, precipitation, wind speed, UV index, and a 3-day forecast.

Parameters* required
daysnumber
Days of forecast to return (1-7)default: 3
island*string
Which Hawaiian islandone of oahu · maui · big_island · kauai
find_hawaii_restaurantsFind restaurants, coffee shops, poke bars, ramen, bakeries, and food trucks in Waikiki and across Oahu. 450+ curated spots across fine dining, casual, local plates, and specialty categories. Use when users ask 'where should I eat in Waikiki', 'best poke on Oahu', 'where to gra...4 params

Find restaurants, coffee shops, poke bars, ramen, bakeries, and food trucks in Waikiki and across Oahu. 450+ curated spots across fine dining, casual, local plates, and specialty categories. Use when users ask 'where should I eat in Waikiki', 'best poke on Oahu', 'where to gra...

Parameters* required
categorystring
Filter by categoryone of any · fine-dining · casual · local-plate · poke · ramendefault: any
limitnumber
Number of results (max 15)default: 5
neighborhoodstring
Filter by neighborhood, e.g. 'waikiki', 'kaimuki'default:
querystring
What to look for, e.g. 'poke', 'sushi', 'breakfast', 'local plate lunch'default:
plan_hawaii_dayBuild a same-day or trip itinerary for a Hawaiian island. Returns a morning activity, lunch spot, afternoon activity, and dinner spot — picked from our live catalog of tours, food, and experiences. Use when users ask 'plan my day in Oahu', 'what should I do Saturday in Maui',...3 params

Build a same-day or trip itinerary for a Hawaiian island. Returns a morning activity, lunch spot, afternoon activity, and dinner spot — picked from our live catalog of tours, food, and experiences. Use when users ask 'plan my day in Oahu', 'what should I do Saturday in Maui',...

Parameters* required
islandstring
Which islandone of oahu · maui · big_island · kauaidefault: oahu
max_budget_per_personnumber
Max total budget per person for paid activities in USDdefault: 300
vibestring
The overall vibe of the dayone of adventure · chill · cultural · romantic · family · budgetdefault: chill

Sponsors

Readme

aloha.fyi MCP Server 🌺

The first dedicated Hawaii tourism MCP server. Hawaii tours, events, and deals for AI assistants — now with AAAK structured-response support so consumer agents can parse results without re-parsing prose.

When someone asks Claude, ChatGPT, or any AI "what should I do in Hawaii?" — this MCP server returns real, bookable data:

  • 2,500+ bookable experiences from partner booking platforms (live counts: /health)
  • Live events across Oahu, Maui, Big Island, and Kauai, refreshed weekly
  • 600+ curated restaurants across the islands
  • Live weather for all four islands (OpenMeteo)
  • Day-plan itineraries with morning / lunch / afternoon / dinner picks
  • Affiliate tracking on every booking link
  • Real MCP protocol — Streamable HTTP, stateless, spec version 2025-03-26
  • AAAK v0.1 — typed structuredContent envelope alongside human-readable text. See docs/aaak-spec.md.

Powered by aloha.fyi — Hawaii's AI concierge.


View the full README on GitHub

Details

Repository
github.com/baphometnxg/aloha-fyi-mcp
Website
aloha.fyi
Transport
HTTP
Registry
MCP registry, active
Tools verified
Nov 6, 2026