Gillby

Gillby MCP

Florida marine conditions for AI agents. Tides, waves, wind, marine forecasts, hazards, red tide, rip currents, depth-aware boat routing and 84 verified coastal spots, through one remote MCP server and a public HTTP API.

Connect any MCP-compatible agent (Claude, ChatGPT, Cursor, Windsurf, Claude Code) to Gillby, a guide to Florida water. Public data needs no API key, no login, no signup: point your agent at https://www.gillby.com/mcp and ask.

Why Gillby exists

I'm newer to boating. I'm not from Florida, but I've been down here for years. My wife said it first: it was way too hard to get a good read on the weather without checking five different things, and when we asked an AI, it didn't have good answers on its own.

So I built Gillby. It's a hobby and a passion project: one map and one clock for a day on Florida water, plus this MCP server so your assistant can answer from real water data instead of guessing. More in Why I built Gillby.

"Can I run Boca Inlet tomorrow morning?" · "Is the Gulf Stream close off Palm Beach?" · "Any red tide on the Gulf coast?" · "Will my 2.5 ft draft make it to the sandbar at low tide?"

What makes it different

• One map, one clock. Wind, waves, tide, radar and lightning line up on the same timeline, per spot.
• Chop for your boat. Ride comfort accounts for boat size and hull, so a 21-foot center console gets a different answer than a big sportfish.
• Bridge clearance at today's tide. 97 bridges, with charted clearance adjusted for the NOAA tide prediction and the nearest live water-level gauge when it passes checks.
• Calibrated rain and thunder chances. Probabilities are recalibrated against airport observations, so a stated chance matches how often it actually rains.
• A 16-day outlook with honest confidence. Ensemble ranges and a trend against normal. From day 10 on, every day is labeled "Low confidence: trend only."
• Sources stay attached. Every answer carries source names, observation times, freshness and anything unavailable.

Endpoint

https://www.gillby.com/mcp

Streamable HTTP transport.

Quick connect

Claude (claude.ai and Claude Desktop)

1. Open Settings, then Connectors. Choose Add connector, then Add custom connector.
2. Enter Gillby as the name and paste the server URL above. Choose no sign-in for public conditions, then Add and Connect.
3. Start a new conversation with Gillby enabled and approve tool use when asked.

Connectors added on claude.ai also show up in Claude Desktop.

ChatGPT

1. Open Plugins (some accounts call it Apps or Connectors). Choose Add, then Add custom MCP server. Workspaces may need admin access.
2. Enter Gillby as the name, paste the server URL, and choose No authentication for public conditions. Create it, then Connect.
3. Start a new chat and select Gillby from your tools.

Claude Code

claude mcp add --transport http gillby https://www.gillby.com/mcp

Cursor / Windsurf — add to your MCP config:

{

"mcpServers": { "gillby": { "type": "http", "url": "https://www.gillby.com/mcp" } } }

Try it: *"Use Gillby to check current conditions at Boca Inlet. Include source freshness and any unavailable data."* Full steps and troubleshooting: connection guide.

Claude Code plugin

This repo is also a Claude Code plugin: the Gillby MCP server plus 9 skills and 6 agents.

/plugin marketplace add OneWave-AI/gillby-mcp

/plugin install gillby@gillby

On Claude Code 2.1.275+ this is one step: /plugin install gillby --marketplace OneWave-AI/gillby-mcp.

Agents and evals call tools as mcp__plugin_gillby_gillby__ . If you also connected Gillby as a claude.ai connector, the same tools appear twice; either works with the skills.

Evals

evals/ holds 6 cases (spot conditions, go/no-go, route asks for draft, kite asks for wind range, swim no-go with no wading, captain agent). MCP calls are answered by mocks recorded from the live server (evals/mocks/gillby/), so runs need no network access to Gillby.

claude plugin eval . --judge-model sonnet

Tools

105 tools on the hosted server, generated from the live tool reference. Start with list_spots and get_conditions with view=summary; that one result carries the forecast, tides, scores, advisories, hazards, lightning and source freshness.

All 105 tools by category

Start here (8)

Forecast and conditions (23)

| get_chop | Boa