spacemandomains avatar

Hawaii Conditions MCP Server

spacemandomains/2_hawaii_conditions_mcp_server

Built for AI agents planning Hawaii trips or needing island conditions on demand. Pulls real-time surf forecasts with wave height and period, hyperlocal weather per island, NPS trail alerts, Kīlauea volcano status from USGS, ocean safety warnings including jellyfish and rip currents, plus restaurant recommendations. Offers a full briefing tool that bundles weather, surf, trails, volcano, and ocean data in one call. Runs on a pay-per-call model where you register to get an API key, fund your account, then query via JSON-RPC over the streamable HTTP endpoint. Includes a free ping tool to verify connectivity before making paid requests. Useful when you need authoritative Hawaii conditions without scraping multiple state and federal sources.

tools
20
transport
HTTP
last updated
Jul 11, 2026

Install

From registry metadata
$ npx add-mcp https://hawaii-conditions.vercel.app/api/mcp --name hawaii-conditions

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 hawaii-conditions https://hawaii-conditions.vercel.app/api/mcp

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

Tools

Verified live · 20 tools

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

pingHealth check — returns server status. Free.

Health check — returns server status. Free.

No parameters. Call it with no arguments.

register_agentCreate a prepaid account. Returns api_key (format: mcp_live_…). Store it immediately — shown only once. Free.2 params

Create a prepaid account. Returns api_key (format: mcp_live_…). Store it immediately — shown only once. Free.

Parameters* required
agent_idstring
Optional unique identifier for this agent
display_namestring
Human-readable name for this agent
get_balanceReturns current balance, original load amount, and low-balance flag. Free.1 params

Returns current balance, original load amount, and low-balance flag. Free.

Parameters* required
api_keystring
Optional api key. Prefer X-MCP-Account header.
create_wallet_setupInitialise Stripe SetupIntent — returns client_secret for saving a card. Free.

Initialise Stripe SetupIntent — returns client_secret for saving a card. Free.

No parameters. Call it with no arguments.

save_payment_methodAttach a Stripe payment method (pm_…) to your account for autonomous top-ups. Free.1 params

Attach a Stripe payment method (pm_…) to your account for autonomous top-ups. Free.

Parameters* required
payment_method_id*string
Stripe payment method ID (pm_…)
link_stripe_customerLink an existing Stripe customer ID (cus_…) to your account. Free.1 params

Link an existing Stripe customer ID (cus_…) to your account. Free.

Parameters* required
customer_id*string
Stripe customer ID (cus_…)
recent_transactionsView recent credits and debits (default 20, max 50). Free.2 params

View recent credits and debits (default 20, max 50). Free.

Parameters* required
api_keystring
Optional api key. Prefer X-MCP-Account header.
limitnumber
Number of transactions to return (max 50)default: 20
add_funds_5Charge your saved card $5 — balance credited after Stripe payment confirmation. Free to call.

Charge your saved card $5 — balance credited after Stripe payment confirmation. Free to call.

No parameters. Call it with no arguments.

add_funds_10Charge your saved card $10 — balance credited after Stripe payment confirmation. Free to call.

Charge your saved card $10 — balance credited after Stripe payment confirmation. Free to call.

No parameters. Call it with no arguments.

add_funds_20Charge your saved card $20 — balance credited after Stripe payment confirmation. Free to call.

Charge your saved card $20 — balance credited after Stripe payment confirmation. Free to call.

No parameters. Call it with no arguments.

get_sun_timesSunrise, sunset, and daylight duration by island (HST). Free.2 params

Sunrise, sunset, and daylight duration by island (HST). Free.

Parameters* required
datestring
Date in YYYY-MM-DD format (defaults to today)
islandstring
one of oahu · maui · kauai · big-island · molokai · lanaidefault: oahu
get_moon_phaseCurrent moon phase, illumination percentage, moonrise/moonset times, and days to next full/new moon. Free.1 params

Current moon phase, illumination percentage, moonrise/moonset times, and days to next full/new moon. Free.

Parameters* required
datestring
Date in YYYY-MM-DD format (defaults to today)
get_weather5-day forecast, UV index, wind, sunrise/sunset. Cost: $0.10.1 params

5-day forecast, UV index, wind, sunrise/sunset. Cost: $0.10.

Parameters* required
island*string
Island name (e.g. oahu, maui, kauai, big-island)one of oahu · maui · kauai · big-island · molokai · lanai
get_surf_conditionsWave height, period, direction + 3-day forecast. Cost: $0.10.1 params

Wave height, period, direction + 3-day forecast. Cost: $0.10.

Parameters* required
island*string
Island name (e.g. oahu, maui, kauai, big-island)one of oahu · maui · kauai · big-island · molokai · lanai
get_trail_statusNPS alerts and state trail closures. Cost: $0.25.1 params

NPS alerts and state trail closures. Cost: $0.25.

Parameters* required
island*string
Island name (e.g. oahu, maui, kauai, big-island)one of oahu · maui · kauai · big-island · molokai · lanai
get_volcano_statusLive Kīlauea status from USGS HVO. Cost: $0.25.

Live Kīlauea status from USGS HVO. Cost: $0.25.

No parameters. Call it with no arguments.

get_ocean_safetyBox jellyfish, rip currents, NOAA marine alerts. Cost: $0.50.1 params

Box jellyfish, rip currents, NOAA marine alerts. Cost: $0.50.

Parameters* required
island*string
Island name (e.g. oahu, maui, kauai, big-island)one of oahu · maui · kauai · big-island · molokai · lanai
get_full_briefingAll five data sources combined — weather, surf, trails, volcano, ocean safety. Best value at $2.00.1 params

All five data sources combined — weather, surf, trails, volcano, ocean safety. Best value at $2.00.

Parameters* required
island*string
Island name (e.g. oahu, maui, kauai, big-island)one of oahu · maui · kauai · big-island · molokai · lanai
search_restaurantsFind restaurants by location, cuisine, price range, open-now filter. Cost: $0.25.4 params

Find restaurants by location, cuisine, price range, open-now filter. Cost: $0.25.

Parameters* required
cuisinestring
Cuisine type (e.g. Hawaiian, Japanese, Mexican)
location*string
Location to search (e.g. Waikiki, Kailua, Lahaina)
open_nowboolean
Filter for currently open restaurants
pricestring
Price rangeone of $ · $$ · $$$ · $$$$
get_restaurant_detailsFull hours, reviews, photos for a restaurant by place_id. Cost: $0.15.1 params

Full hours, reviews, photos for a restaurant by place_id. Cost: $0.15.

Parameters* required
place_id*string
Google place_id returned from search_restaurants

Sponsors

Readme

Details

Repository
github.com/spacemandomains/2_hawaii_conditions_mcp_server
Website
hawaii-conditions.vercel.app
Transport
HTTP
Registry
MCP registry, active
Tools verified
Nov 6, 2026

More from spacemandomains