io.github.Spacemandomains/hawaii-conditions

Official20 tools

Hawaii Conditions MCP Server

Real-time surf, weather, trail status, volcano, ocean safety, and restaurants for Hawaii.

Real-time data for surfing, weather, trails, volcanoes, and dining in Hawaii.

Captured live from the server via tools/list.

ping

Health check — returns server status. Free.

No parameters.

register_agent

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

Parameters (2)

agent_idstring
Optional unique identifier for this agent
display_namestring
Human-readable name for this agent

get_balance

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

Parameters (1)

api_keystring
Optional api key. Prefer X-MCP-Account header.

create_wallet_setup

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

No parameters.

save_payment_method

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

Parameters (1)

payment_method_idstringrequired
Stripe payment method ID (pm_…)

link_stripe_customer

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

Parameters (1)

customer_idstringrequired
Stripe customer ID (cus_…)

recent_transactions

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

Parameters (2)

api_keystring
Optional api key. Prefer X-MCP-Account header.
limitnumber
Number of transactions to return (max 50)

add_funds_5

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

No parameters.

add_funds_10

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

No parameters.

add_funds_20

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

No parameters.

get_sun_times

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

Parameters (2)

islandstring
datestring
Date in YYYY-MM-DD format (defaults to today)

get_moon_phase

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

Parameters (1)

datestring
Date in YYYY-MM-DD format (defaults to today)

get_weather

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

Parameters (1)

islandstringrequired
Island name (e.g. oahu, maui, kauai, big-island)

get_surf_conditions

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

Parameters (1)

islandstringrequired
Island name (e.g. oahu, maui, kauai, big-island)

get_trail_status

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

Parameters (1)

islandstringrequired
Island name (e.g. oahu, maui, kauai, big-island)

get_volcano_status

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

No parameters.

get_ocean_safety

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

Parameters (1)

islandstringrequired
Island name (e.g. oahu, maui, kauai, big-island)

get_full_briefing

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

Parameters (1)

islandstringrequired
Island name (e.g. oahu, maui, kauai, big-island)

search_restaurants

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

Parameters (4)

locationstringrequired
Location to search (e.g. Waikiki, Kailua, Lahaina)
cuisinestring
Cuisine type (e.g. Hawaiian, Japanese, Mexican)
pricestring
Price range
open_nowboolean
Filter for currently open restaurants

get_restaurant_details

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

Parameters (1)

place_idstringrequired
Google place_id returned from search_restaurants

Install

claude_desktop_config.json

{
  "mcpServers": {
    "hawaii-conditions": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://hawaii-conditions.vercel.app/api/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.