Skip to main content
Glama
BC Water Tides MCP Server

BC Water Tides MCP Server

by kykoay

BC Water Tides MCP Server

A Model Context Protocol (MCP) server that provides access to Canadian tide predictions from the Integrated Water Level System (IWLS) API. This server enables AI applications to retrieve tide forecasts for monitoring stations across Canada.

Features

Tools

  • get_tide_forecast - Get 7-day tide height predictions for a specific station

  • list_stations - List available tide monitoring stations with filtering options

Related MCP server: tideline

Installation

  1. Clone or download this repository

    git clone <repository-url>
    cd bc-tide-mcp-server
  2. Install dependencies

    pip install -r requirements.txt
    # or using uv
    uv sync

Usage

Running the Server

Development mode (stdio):

python main.py

Using uv:

uv run main.py

Integration with Claude Desktop

Add to your Claude Desktop configuration file (claude_desktop_config.json):

{
  "mcpServers": {
    "bc-tides": {
      "command": "python",
      "args": ["/absolute/path/to/bc-tide-mcp-server/main.py"]
    }
  }
}

Or using uv:

{
  "mcpServers": {
    "bc-tides": {
      "command": "uv",
      "args": ["run", "--directory", "/absolute/path/to/bc-tide-mcp-server", "main.py"]
    }
  }
}

API Reference

Tools

get_tide_forecast

Get 7-day tide height forecast for a Canadian monitoring station.

Parameters:

  • station_name (required): The name of the monitoring station (e.g., "Point Atkinson", "Vancouver", "Victoria"). Partial matching is supported.

Returns:

{
  "success": true,
  "station": {
    "name": "Point Atkinson",
    "id": "5cebf1de3d0f4a073c4bbcef",
    "code": "07795",
    "latitude": 49.3299,
    "longitude": -123.2633,
    "operating": true
  },
  "time_range": {
    "from": "2024-01-01T00:00:00Z",
    "to": "2024-01-08T00:00:00Z"
  },
  "resolution": "SIXTY_MINUTES (hourly)",
  "total_predictions": 168,
  "forecasts": [
    {
      "timestamp": "2024-01-01T00:00:00Z",
      "water_level_meters": 3.42,
      "qc_flag": "2"
    }
  ]
}

list_stations

List available tide monitoring stations.

Parameters:

  • search_term (optional): Filter stations by name

  • operating_only (optional, default: true): Only return currently operating stations

  • limit (optional, default: 20): Maximum number of stations to return (1-100)

Returns:

{
  "success": true,
  "search_term": "vancouver",
  "operating_only": true,
  "total_matching": 3,
  "stations": [
    {
      "name": "Point Atkinson",
      "alternative_name": null,
      "id": "5cebf1de3d0f4a073c4bbcef",
      "code": "07795",
      "latitude": 49.3299,
      "longitude": -123.2633,
      "operating": true
    }
  ]
}

Example Station Names

  • Point Atkinson (near Vancouver)

  • Victoria

  • Tofino

  • Prince Rupert

  • Nanaimo

  • Campbell River

Data Source

This server uses the Integrated Water Level System (IWLS) API provided by Fisheries and Oceans Canada (DFO-MPO).

API Base URL: https://api-iwls.dfo-mpo.gc.ca/api/v1

Example Usage in Claude

After setting up the server, you can use it in Claude Desktop:

"What are the tide predictions for Point Atkinson for the next week?"

"List all tide stations near Victoria"

"Get the tide forecast for Tofino"

License

This project is licensed under the MIT License.

Available Tools

4 tools
get_tide_forecastA

Get 7-day tide height forecast for a Canadian monitoring station.

This tool retrieves predicted water levels for the next 7 days from the Integrated Water Level System (IWLS) API. Data is returned at hourly intervals.

The tool first searches for the station by name (partial match supported), then retrieves the tide predictions starting from midnight UTC today.

Returns:

  • Station information (name, ID, coordinates)

  • List of hourly tide predictions with timestamps and water levels (in meters)

Examples of station names:

  • "Point Atkinson" (near Vancouver)

  • "Victoria"

  • "Tofino"

  • "Prince Rupert"

Inputs: station_name (required).

get_tide_forecast_pstA

Get tide height forecast with timestamps converted to Pacific Standard Time (PST/PDT).

This tool retrieves predicted water levels and converts all timestamps from UTC to Pacific Time (America/Vancouver timezone), automatically handling PST/PDT transitions.

Use this tool when you need tide data displayed in local BC time rather than UTC.

Returns:

  • Station information (name, ID, coordinates)

  • List of hourly tide predictions with PST timestamps and water levels (in meters)

  • High and low tide information for the requested period

Examples of station names:

  • "Point Atkinson" (near Vancouver)

  • "Campbell River"

  • "Victoria"

  • "Tofino"

Inputs: station_name (required), date.

list_stationsA

List available tide monitoring stations.

This tool retrieves a list of monitoring stations from the IWLS API. You can filter by name and operating status.

Useful for discovering station names before using the get_tide_forecast tool.

Inputs: limit, search_term, operating_only.

plot_tide_forecastA

Generate a tide height plot showing water levels as a function of time in PST.

This tool creates a visual chart of tide heights throughout a specified day, with timestamps displayed in Pacific Standard Time (PST/PDT).

The plot includes:

  • Tide height curve with hourly data points

  • Highlighted high and low tide markers with annotations

  • Optimal diving zone indicator (low tide window)

  • Dark, ocean-themed styling

Returns:

  • Plot image (either saved to file or as base64 data)

  • High and low tide summary information

Use this tool when the user wants a visual representation of tide patterns for dive planning, fishing, boating, or other marine activities.

Inputs: date (required), station_name (required), title, save_path.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.1/5.0

    Scored across 4 tools

    Disambiguation4/5

    Most tools are clearly distinct: list_stations for discovery, plot_tide_forecast for visualization. get_tide_forecast and get_tide_forecast_pst overlap heavily as the same forecast data, but their descriptions explicitly differentiate UTC vs PST output, reducing confusion.

    Naming Consistency4/5

    Tools follow a consistent verb_noun pattern (list_stations, get_tide_forecast, plot_tide_forecast). get_tide_forecast_pst introduces a timezone suffix modifier, which is a minor deviation but still predictable and readable.

    Tool Count5/5

    Four tools is well-scoped for a tide forecast server: station discovery, UTC forecast data, PST-localized forecast data, and visualization. Each tool serves a distinct need without redundancy or bloat.

    Completeness4/5

    The core workflow is covered: discover stations, retrieve forecast data, localize it, and visualize it. Minor gaps exist, such as no option to specify a custom date range or fetch real-time observed water levels, but these are not core to the stated purpose.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Fetches tide information for any location using latitude and longitude, providing detailed tide data including high/low tides and station information with automatic UTC time zone handling.
      1
      19
      MIT
    • F
      license
      Not graded
      quality
      C
      maintenance
      MCP server that provides tide predictions, station lookup, and tidal event alerts for US coastal locations using live NOAA data.
      -
    • A
      license
      Not graded
      quality
      F
      maintenance
      Provides NOAA tide predictions and observed water levels, allowing AI agents to query tide stations and current water level data.
      2 npm
      MIT