Skip to content
FREE PUBLIC ACCESS / OPEN-SOURCE CONNECTION TOOLS

Water intelligence. Open to everyone.

We built Gillby MCP for anyone into boating, fishing, surfing or exploring the water. Connect your AI to public water data and Gillby’s tools for Florida and California—with more states to come.

Public access is free within published limits. Coverage varies by state and tool.

OPEN-SOURCE INSTRUCTIONS / CONNECTED WATER INTELLIGENCE

Skills & Agents.
More water knowledge for your AI.

Nine focused skills. Six specialist agents. One general-purpose Water skill to start with. Choose the workflows you need and connect them to Gillby’s sourced data.

Source files available now · Marketplace listings coming soon · Compatible client and data connection required

NINE SKILLS IN THE GILLBY BUNDLE

A workflow for the question.

Water conditions

Compare wind, waves, tides, advisories and source freshness.

Read skill

Boating outlook

Compare trip windows with vessel context and explicit constraints.

Read skill

Route planning

Depth, draft, bridges and departure-time assumptions.

Read skill

Fishing

Inshore and offshore conditions, tides and ocean context.

Read skill

Beach days

Surf, rip-current reports, water-quality records and beach hazards.

Read skill

Surf & kite

Conditions and rider-specific wind planning within available coverage.

Read skill

Dive & snorkel

Visibility estimates, currents, reefs and wrecks.

Read skill

Water quality

Dated algae, bacteria, discharge and pollution records.

Read skill

Your Gillby account

Authorized saved places, boats, trips and preferences.

Read skill

GENERAL-PURPOSE STARTER / SEPARATE RELEASE

Gillby Water

Start with a place, compare the conditions and bring your boat context when you choose. A single skill for broader water-planning conversations.

Get the starter skill

The detailed planning workflows focus on Florida. California surf, lake, river and coverage tools are available through the same connection, with coverage limits kept explicit. A listed place does not guarantee a forecast or a validated activity rating.

SIX SPECIALIST AGENT DEFINITIONS

Give the task a specialist.

Surf guide

Compare swell, wind and tide windows for Florida and supported California surf spots.

Read agent

Navigator

A specialist for draft, chart depth and bridge constraints.

Read agent

Fishing guide

Inshore and offshore conditions analysis.

Read agent

Beach scout

Beach, swim, surf and kite planning.

Read agent

Water-quality analyst

Interpret dated water-quality records and uncertainty.

Read agent

These agent definitions are published for compatible Claude plugin workflows. Other clients may require adaptation. They organize research and planning; they do not operate your boat. Personal account actions require your authorization.

Choose your setup.

01

The complete bundle

The public repository contains all nine focused skills, six agents and MCP connection configuration. Follow its current setup instructions for your client; marketplace listings remain coming soon.

Bundle setup & compatibility
02

A single starter skill

Use Gillby Water when you want one general planning workflow. Its single-file setup is below; it does not install the nine-skill bundle or the specialist agents.

Starter skill setup ↓

Published instruction files are open source under their repository licenses. Gillby’s hosted service, underlying provider data and proprietary scoring are separate. Installing instructions does not grant account access.

ONE FILE. TWO PARTS TO SETUP.

Add the skill. Connect the data.

01

Install the instructions.

Use your client’s skill importer with the GitHub skill folder, or install the single SKILL.md file in your local skills directory. These commands install only Gillby Water.

Claude Code

mkdir -p ~/.claude/skills/gillby-water
curl --fail --location 'https://raw.githubusercontent.com/OneWave-AI/claude-skills/main/gillby-water/SKILL.md' \
  --output ~/.claude/skills/gillby-water/SKILL.md

Codex

mkdir -p ~/.codex/skills/gillby-water
curl --fail --location 'https://raw.githubusercontent.com/OneWave-AI/claude-skills/main/gillby-water/SKILL.md' \
  --output ~/.codex/skills/gillby-water/SKILL.md

Open a new session or reload skills as your client requires. In Codex, you can explicitly ask to use $gillby-water; other clients use their own invocation UI.

Read the complete SKILL.md
02

Give it a source of current data.

Add Gillby as a remote MCP server in a compatible client:

https://www.gillby.com/mcp

Transport: Streamable HTTP. Public marine tools require no API key or sign-in. Personal boats, places and trips use Gillby OAuth with the permissions you choose.

Follow the connection guide

For an HTTP-based workflow, use the developer guide and current schemas. The skill handles a missing connection explicitly instead of inventing readings.

Available now as an open-source skill.

Custom MCP connections work on compatible accounts. Marketplace plugin listings remain coming soon and subject to each platform’s approval.

One connection. Current references.