BC Water Tides MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@BC Water Tides MCP Server Get the tide forecast for Point Atkinson"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 stationlist_stations- List available tide monitoring stations with filtering options
Related MCP server: tideline
Installation
Clone or download this repository
git clone <repository-url> cd bc-tide-mcp-serverInstall dependencies
pip install -r requirements.txt # or using uv uv sync
Usage
Running the Server
Development mode (stdio):
python main.pyUsing uv:
uv run main.pyIntegration 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 nameoperating_only(optional, default: true): Only return currently operating stationslimit(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 toolsget_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
Scored across 4 tools
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.
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.
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.
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
Related MCP Connectors
Find NOAA tide stations and NDBC buoys, fetch tide predictions, currents, and latest observations.
Tide times and heights for about 4,600 US and Canadian stations. Not for navigation.
Access Statistics Canada data via the Web Data Services API
Tides, currents, marine forecasts and warnings for paddlers, anglers and small boats, 26 countries.
Related MCP Servers
- AlicenseBqualityDmaintenanceFetches 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.119MIT
- FlicenseNot gradedqualityCmaintenanceMCP server that provides tide predictions, station lookup, and tidal event alerts for US coastal locations using live NOAA data.-
- AlicenseNot gradedqualityFmaintenanceProvides NOAA tide predictions and observed water levels, allowing AI agents to query tide stations and current water level data.2 npmMIT
- AlicenseNot gradedqualityBmaintenanceFind NOAA tide stations and NDBC buoys, fetch tide predictions, water levels, tidal currents, and live buoy conditions via MCP.225 npm3Apache 2.0