Koskamo

aloha.fyi MCP

A read-only MCP server providing access to a maintained catalog of over 2,500 tours, 600+ restaurants, events, and live weather data across Hawaii's four main islands. It supports structured responses with typed content for prices, islands, and booking URLs, enabling agents to search tours, find deals, locate restaurants, check weather, and plan day itineraries without scraping.

Endpoint and access

No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.

aloha.fyi MCP logo, by aloha.fyiCommunity listingStreamable HTTPNo sign-inEndpoint checked 2026-11-07Published by aloha.fyi
MCP endpoint (Streamable HTTP)
https://mcp.aloha.fyi/mcp
Vendor documentation

What its tools do

6 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.

Read-only (6)

6 of 6 have a description · 6 of 6 declare behavior hints · 5 of 6 with parameters document them all

Checks and signals

Each line is separate evidence, not a trust score.

  • Passed Endpoint answered the live check ·
  • Availability 1 of 1 checks passed in 30 days

What you can do with it

  • Search for Hawaii tours and experiences
  • Find restaurants and deals on specific islands
  • Check live weather conditions
  • Plan day-by-day itineraries

Source and maintenance

Community listingRegistry 1.3.0
mcp-registry: io.github.baphometnxg/aloha-fyi-mcp@1.3.0Source repositoryProject website
Maintenance checked

Protocol and capabilities

Server
aloha-fyi-hawaii 1.0.0
MCP protocol negotiated in check
2025-11-25
Tools
6 advertised
Resources
Not advertised
Resource templates
Not advertised
Prompts
Not advertised
Server-advertised capabilities
{
  "tools": {
    "listChanged": true
  },
  "logging": {}
}

Tools

6 advertised

search_hawaii_tours — Search Hawaii Tours
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

search_hawaii_tours input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "query"
  ],
  "properties": {
    "limit": {
      "type": "number",
      "default": 5,
      "description": "Number of results (max 20)"
    },
    "query": {
      "type": "string",
      "description": "What to search for, e.g. 'snorkeling', 'helicopter tour', 'luau', 'family activities'"
    },
    "island": {
      "enum": [
        "oahu",
        "maui",
        "big_island",
        "kauai",
        "any"
      ],
      "type": "string",
      "default": "any",
      "description": "Which Hawaiian island"
    },
    "source": {
      "enum": [
        "viator",
        "gyg",
        "klook",
        "groupon",
        "any"
      ],
      "type": "string",
      "default": "any",
      "description": "Filter by booking platform"
    },
    "max_price_dollars": {
      "type": "number",
      "description": "Maximum price per person in USD"
    }
  },
  "additionalProperties": false
}
search_hawaii_tours annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
get_hawaii_deals — Hawaii Budget Deals
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

get_hawaii_deals input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "activity"
  ],
  "properties": {
    "limit": {
      "type": "number",
      "default": 5,
      "description": "Number of deals (max 20)"
    },
    "activity": {
      "type": "string",
      "description": "Type of activity, e.g. 'snorkeling', 'helicopter', 'luau', 'food tour'"
    },
    "max_price_dollars": {
      "type": "number",
      "default": 100,
      "description": "Maximum price per person in USD"
    }
  },
  "additionalProperties": false
}
get_hawaii_deals annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
search_hawaii_events — Hawaii Events & Concerts
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

search_hawaii_events input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "query": {
      "type": "string",
      "default": "",
      "description": "Type of event, e.g. 'live music', 'luau', 'concert', 'food festival'"
    },
    "island": {
      "enum": [
        "oahu",
        "maui",
        "big_island",
        "kauai",
        "any"
      ],
      "type": "string",
      "default": "any"
    },
    "days_ahead": {
      "type": "number",
      "default": 7,
      "description": "How many days ahead to search"
    }
  },
  "additionalProperties": false
}
search_hawaii_events annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
get_hawaii_weather — Hawaii Weather & Surf Conditions
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

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.

get_hawaii_weather input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "island"
  ],
  "properties": {
    "days": {
      "type": "number",
      "default": 3,
      "description": "Days of forecast to return (1-7)"
    },
    "island": {
      "enum": [
        "oahu",
        "maui",
        "big_island",
        "kauai"
      ],
      "type": "string",
      "description": "Which Hawaiian island"
    }
  },
  "additionalProperties": false
}
get_hawaii_weather annotations
{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}
find_hawaii_restaurants — Hawaii Restaurants & Food
Advertised by the server during the last successful anonymous check.
Advertised read-only

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 grab coffee', or 'cheap eats near me'.

find_hawaii_restaurants input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "limit": {
      "type": "number",
      "default": 5,
      "description": "Number of results (max 15)"
    },
    "query": {
      "type": "string",
      "default": "",
      "description": "What to look for, e.g. 'poke', 'sushi', 'breakfast', 'local plate lunch'"
    },
    "category": {
      "enum": [
        "any",
        "fine-dining",
        "casual",
        "local-plate",
        "poke",
        "ramen",
        "food-truck",
        "cafe",
        "coffee",
        "bakery",
        "dessert",
        "breakfast",
        "bar"
      ],
      "type": "string",
      "default": "any",
      "description": "Filter by category"
    },
    "neighborhood": {
      "type": "string",
      "default": "",
      "description": "Filter by neighborhood, e.g. 'waikiki', 'kaimuki'"
    }
  },
  "additionalProperties": false
}
find_hawaii_restaurants annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
plan_hawaii_day — Plan a Hawaii Day
Advertised by the server during the last successful anonymous check.
Advertised read-only

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', or 'family itinerary for Kauai'.

plan_hawaii_day input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "vibe": {
      "enum": [
        "adventure",
        "chill",
        "cultural",
        "romantic",
        "family",
        "budget"
      ],
      "type": "string",
      "default": "chill",
      "description": "The overall vibe of the day"
    },
    "island": {
      "enum": [
        "oahu",
        "maui",
        "big_island",
        "kauai"
      ],
      "type": "string",
      "default": "oahu",
      "description": "Which island"
    },
    "max_budget_per_person": {
      "type": "number",
      "default": 300,
      "description": "Max total budget per person for paid activities in USD"
    }
  },
  "additionalProperties": false
}
plan_hawaii_day annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}

Prompts

Not advertised

No prompt definitions available.

Resources

Not advertised

No resource definitions available.

30-day availability

Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.

Successful checks
1 of 1 (100%)
Average latency
866 ms
95th percentile latency
866 ms

Maintenance history

Public check and source-refresh events. Editorial and ownership records remain private.

  • · probe · passed · 866 ms · metadata changed · 6 tool(s)

Connect from your client

Each snippet registers the same endpoint; pick the client you use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers the remote server. Use --scope project to write .mcp.json for the repo.
Claude Code configuration
claude mcp add --transport http aloha-fyi-mcp https://mcp.aloha.fyi/mcp

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).
Codex configuration
codex mcp add aloha-fyi-mcp --url https://mcp.aloha.fyi/mcp

Cursor

Merge this server into .cursor/mcp.json in your project, then enable aloha-fyi-mcp in your MCP settings.
Cursor configuration
{
  "mcpServers": {
    "aloha-fyi-mcp": {
      "url": "https://mcp.aloha.fyi/mcp"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure).
Cline configuration
{
  "mcpServers": {
    "aloha-fyi-mcp": {
      "type": "streamableHttp",
      "url": "https://mcp.aloha.fyi/mcp",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start aloha-fyi-mcp and inspect its tools.
VS Code configuration
{
  "servers": {
    "aloha-fyi-mcp": {
      "type": "http",
      "url": "https://mcp.aloha.fyi/mcp"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.
Gemini CLI configuration
gemini mcp add --transport http aloha-fyi-mcp https://mcp.aloha.fyi/mcp

Claude Desktop

Open Claude Settings > Connectors > Add custom connector, enter this server URL and enable it for the conversation. This is a manual remote-connector handoff, not a desktop JSON configuration.
Claude Desktop configuration
https://mcp.aloha.fyi/mcp

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.
Windsurf configuration
{
  "mcpServers": {
    "aloha-fyi-mcp": {
      "serverUrl": "https://mcp.aloha.fyi/mcp"
    }
  }
}

Let your agent find its tools

Find servers like aloha.fyi MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.

Connect Koskamo Explore workflows
See all 1,475