MCP 服务器

aloha-fyi-hawaii

First dedicated Hawaii tourism MCP server. Search 2,583 tours, 579 events, Groupon deals across Oahu, Maui, Big Island, and Kauai. Every result includes affiliate booking links. Powered by aloha.fyi.

README

aloha.fyi MCP Server 🌺

The first dedicated Hawaii tourism MCP server. Hawaii tours, events, and deals for AI assistants.

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

2,583 bookable experiences from Viator, GetYourGuide, Klook, and Groupon
579 events across Oahu, Maui, Big Island, and Kauai
Affiliate tracking on every booking link
Real MCP protocol — Streamable HTTP, stateless, spec version 2025-03-26

Hosted endpoint

Production MCP server (no install, no setup):

https://mcp-server-nani-v3-20.up.railway.app/mcp

Transport: Streamable HTTP (stateless)
Protocol version: 2025-03-26
Auth: none (public, read-only)
Health: GET /health
Discovery: GET /.well-known/mcp/server.json

Connect to Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "aloha-fyi-hawaii": {
      "url": "https://mcp-server-nani-v3-20.up.railway.app/mcp"
    }
  }
}

Restart Claude Desktop. You should see the three Hawaii tools appear in the tool picker. Try:

Find me snorkeling tours in Oahu under $100

What events are happening in Honolulu this weekend?

Plan a family adventure day on the Big Island — cheapest options

Connect to any MCP-compatible client

Any client that supports Streamable HTTP MCP can point directly at:

https://mcp-server-nani-v3-20.up.railway.app/mcp

No API key, no OAuth, no signup.

Manual protocol test

curl -X POST https://mcp-server-nani-v3-20.up.railway.app/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"curl","version":"1.0"}}}'

Tools

`search_hawaii_tours`

Search 2,583 bookable Hawaii tours and activities by keyword, island, price range. Returns tours from Viator, GetYourGuide, Klook, and Groupon with affiliate booking links.

Param	Type	Description
`query`	string (required)	e.g. "snorkeling", "helicopter tour", "family luau"
`island`	`oahu` \| `maui` \| `big_island` \| `kauai` \| `any`	Defaults to `any`
`max_price_dollars`	number	Maximum price per person in USD
`source`	`viator` \| `gyg` \| `klook` \| `groupon` \| `any`	Filter by booking platform
`limit`	number	Results (max 20, default 5)

`get_hawaii_deals`

Find budget deals and discounts. Returns Groupon deals and low-price options sorted cheapest first.

Param	Type	Description
`activity`	string (required)	e.g. "snorkeling", "helicopter", "luau"
`max_price_dollars`	number	Default 100
`limit`	number	Results (max 20, default 5)

`search_hawaii_events`

Find upcoming events, concerts, festivals, and nightlife across all Hawaiian islands. 579+ events from 70+ venues, updated weekly.

Param	Type	Description
`query`	string	e.g. "live music", "luau", "concert"
`island`	`oahu` \| `maui` \| `big_island` \| `kauai` \| `any`	Defaults to `any`
`days_ahead`	number	How many days ahead to search (default 7)

Run it yourself

git clone https://github.com/baphometnxg/aloha-fyi-mcp.git
cd aloha-fyi-mcp
npm install
npx tsc
DATABASE_URL="postgresql://..." PORT=9624 node dist/http.js

Requires:

Node.js 20+
DATABASE_URL env var (PostgreSQL with an experiences table — schema in schema.sql)

Privacy

No PII is collected by the MCP server. Stateless mode — no sessions, no cross-request profiles. Standard request metadata is logged for abuse prevention only.

Full privacy policy: aloha.fyi/privacy

About

Built by Michael Crain — Hawaii resident, cinematographer, and founder of aloha.fyi.

aloha.fyi is an AI-powered multilingual tourism concierge for Hawaii's visitor industry. The concierge agent "Nani" speaks 5 languages (English, Japanese, Korean, Chinese, Spanish) and has access to 2,583 bookable experiences across 6 affiliate networks.

This MCP server exposes a subset of that capability to any AI assistant that speaks the Model Context Protocol.