Hawaii Conditions MCP Server

Official20 toolsLive

by Spacemandomains

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

io.github.Spacemandomains/hawaii-conditions (MCP Server)

This MCP server provides Hawaii-related information across multiple domains, including real-time surf, weather, trail status, volcano updates, ocean safety, and restaurant listings. The server is identified by the slug io-github-spacemandomains-hawaii-conditions and exposes 20 tools for retrieving this data.

🛠️ Key Features

Real-time surf data
Weather information
Trail status updates
Volcano-related updates
Ocean safety information
Restaurant listings

🚀 Use Cases

Building location-aware Hawaii dashboards for surf and weather
Surf and safety planning with ocean safety context
Tracking trail conditions and volcano-related changes
Supporting local discovery with restaurant information

⚡ Developer Benefits

Consistent MCP tool interface (20 tools)
Focused dataset scoped to Hawaii conditions and services

Captured live from the server via tools/list.

ping

Health check — returns server status. Free.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "required": []
}

register_agent

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

Parameters2

agent_id	string	optional	Optional unique identifier for this agent
display_name	string	optional	Human-readable name for this agent

Raw schema

{
  "type": "object",
  "properties": {
    "agent_id": {
      "type": "string",
      "description": "Optional unique identifier for this agent"
    },
    "display_name": {
      "type": "string",
      "description": "Human-readable name for this agent"
    }
  }
}

get_balance

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

Parameters1

api_key

string

optional

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

Raw schema

{
  "type": "object",
  "properties": {
    "api_key": {
      "type": "string",
      "description": "Optional api key. Prefer X-MCP-Account header."
    }
  },
  "required": []
}

create_wallet_setup

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

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "required": []
}

save_payment_method

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

Parameters1

payment_method_id

string

required

Stripe payment method ID (pm_…)

Raw schema

{
  "type": "object",
  "properties": {
    "payment_method_id": {
      "type": "string",
      "description": "Stripe payment method ID (pm_…)"
    }
  },
  "required": [
    "payment_method_id"
  ]
}

link_stripe_customer

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

Parameters1

customer_id

string

required

Stripe customer ID (cus_…)

Raw schema

{
  "type": "object",
  "properties": {
    "customer_id": {
      "type": "string",
      "description": "Stripe customer ID (cus_…)"
    }
  },
  "required": [
    "customer_id"
  ]
}

recent_transactions

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

Parameters2

api_key	string	optional	Optional api key. Prefer X-MCP-Account header.
limit	number	optional	Number of transactions to return (max 50)

Raw schema

{
  "type": "object",
  "properties": {
    "api_key": {
      "type": "string",
      "description": "Optional api key. Prefer X-MCP-Account header."
    },
    "limit": {
      "type": "number",
      "description": "Number of transactions to return (max 50)",
      "default": 20
    }
  }
}

add_funds_5

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

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "required": []
}

add_funds_10

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

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "required": []
}

add_funds_20

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

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "required": []
}

get_sun_times

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

Parameters2

island	string	optional
date	string	optional	Date in YYYY-MM-DD format (defaults to today)

Raw schema

{
  "type": "object",
  "properties": {
    "island": {
      "type": "string",
      "enum": [
        "oahu",
        "maui",
        "kauai",
        "big-island",
        "molokai",
        "lanai"
      ],
      "default": "oahu"
    },
    "date": {
      "type": "string",
      "description": "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.

Parameters1

date

string

optional

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

Raw schema

{
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "description": "Date in YYYY-MM-DD format (defaults to today)"
    }
  }
}

get_weather

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

Parameters1

island

string

required

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

Raw schema

{
  "type": "object",
  "properties": {
    "island": {
      "type": "string",
      "description": "Island name (e.g. oahu, maui, kauai, big-island)",
      "enum": [
        "oahu",
        "maui",
        "kauai",
        "big-island",
        "molokai",
        "lanai"
      ]
    }
  },
  "required": [
    "island"
  ]
}

get_surf_conditions

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

Parameters1

island

string

required

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

Raw schema

{
  "type": "object",
  "properties": {
    "island": {
      "type": "string",
      "description": "Island name (e.g. oahu, maui, kauai, big-island)",
      "enum": [
        "oahu",
        "maui",
        "kauai",
        "big-island",
        "molokai",
        "lanai"
      ]
    }
  },
  "required": [
    "island"
  ]
}

get_trail_status

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

Parameters1

island

string

required

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

Raw schema

{
  "type": "object",
  "properties": {
    "island": {
      "type": "string",
      "description": "Island name (e.g. oahu, maui, kauai, big-island)",
      "enum": [
        "oahu",
        "maui",
        "kauai",
        "big-island",
        "molokai",
        "lanai"
      ]
    }
  },
  "required": [
    "island"
  ]
}

get_volcano_status

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

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

get_ocean_safety

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

Parameters1

island

string

required

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

Raw schema

{
  "type": "object",
  "properties": {
    "island": {
      "type": "string",
      "description": "Island name (e.g. oahu, maui, kauai, big-island)",
      "enum": [
        "oahu",
        "maui",
        "kauai",
        "big-island",
        "molokai",
        "lanai"
      ]
    }
  },
  "required": [
    "island"
  ]
}

get_full_briefing

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

Parameters1

island

string

required

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

Raw schema

{
  "type": "object",
  "properties": {
    "island": {
      "type": "string",
      "description": "Island name (e.g. oahu, maui, kauai, big-island)",
      "enum": [
        "oahu",
        "maui",
        "kauai",
        "big-island",
        "molokai",
        "lanai"
      ]
    }
  },
  "required": [
    "island"
  ]
}

search_restaurants

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

Parameters4

location	string	required	Location to search (e.g. Waikiki, Kailua, Lahaina)
cuisine	string	optional	Cuisine type (e.g. Hawaiian, Japanese, Mexican)
price	string	optional	Price range
open_now	boolean	optional	Filter for currently open restaurants

Raw schema

{
  "type": "object",
  "properties": {
    "location": {
      "type": "string",
      "description": "Location to search (e.g. Waikiki, Kailua, Lahaina)"
    },
    "cuisine": {
      "type": "string",
      "description": "Cuisine type (e.g. Hawaiian, Japanese, Mexican)"
    },
    "price": {
      "type": "string",
      "enum": [
        "$",
        "$$",
        "$$$",
        "$$$$"
      ],
      "description": "Price range"
    },
    "open_now": {
      "type": "boolean",
      "description": "Filter for currently open restaurants"
    }
  },
  "required": [
    "location"
  ]
}

get_restaurant_details

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

Parameters1

place_id

string

required

Google place_id returned from search_restaurants

Raw schema

{
  "type": "object",
  "properties": {
    "place_id": {
      "type": "string",
      "description": "Google place_id returned from search_restaurants"
    }
  },
  "required": [
    "place_id"
  ]
}

Install

Tools (20)

pingregister_agentget_balancecreate_wallet_setupsave_payment_methodlink_stripe_customerrecent_transactionsadd_funds_5

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://hawaii-conditions.vercel.app/api/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

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.

io.github.Spacemandomains/hawaii-conditions (MCP Server)

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

ping

register_agent

get_balance

create_wallet_setup

save_payment_method

link_stripe_customer

recent_transactions

add_funds_5

add_funds_10

add_funds_20

get_sun_times

get_moon_phase

get_weather

get_surf_conditions

get_trail_status

get_volcano_status

get_ocean_safety

get_full_briefing

search_restaurants

get_restaurant_details

Install

Remote endpoint

Related servers