Open Waters AIS MCP server
Commit Nov 16, 2026Lets an AI client track live vessel positions, search by name or MMSI, and view vessel tracks and coverage using real-time AIS data.
Also known as openwatersio/aiscast, aiscast
- Stars
- 10
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 0.18.3
- Last commit
- Nov 16, 2026
- License
- AGPL-3.0
What is Open Waters AIS MCP?
Open Waters AIS lets an AI client track live vessel positions, search by name or MMSI, and view vessel tracks and coverage using real-time AIS data.
Summary generated from the project's README
About Open Waters AIS MCP server
Open Waters AIS provides real-time vessel traffic data streamed from community networks, government feeds, and volunteer receivers. This MCP server allows AI clients to monitor maritime activity by accessing live AIS data through six read-only tools. Developers can use it with Claude, ChatGPT, Cursor, or VS Code by connecting to the provided URL.
Users can perform specific maritime queries such as searching for vessels by name, tracking a vessel's path, or finding ships within a specific geographic area. The server also provides tools to check coverage and locate vessels near a specific point or another ship. While basic access requires no sign-in, providing an Authorization Bearer token allows users to bypass anonymous limits. The system integrates diverse data sources including Kystverket, BarentsWatch, and Fintraffic Digitraffic to ensure comprehensive maritime visibility.
What you can do with it
- 1Track specific vessel movementsFind the historical path and current location of a ship using its unique identifier.
- 2Monitor regional maritime trafficIdentify all ships currently operating within a defined bounding box or geographic area.
- 3Locate ships by nameSearch the live AIS feed for a specific vessel using its registered name.
- 4Analyze local vessel densityDetermine which vessels are positioned near a specific coordinate or another ship.
Written from the project's README. Every use case is checked against a quote from it.
How to install Open Waters AIS MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Open Waters AIS MCP in Claude Code
$ claude mcp add --transport http aiscast https://ais.openwaters.io/mcpInstall Open Waters AIS MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"aiscast": {
"url": "https://ais.openwaters.io/mcp"
}
}
}Install Open Waters AIS MCP in VS Code
.vscode/mcp.json
{
"servers": {
"aiscast": {
"type": "http",
"url": "https://ais.openwaters.io/mcp"
}
}
}Install Open Waters AIS MCP in VS Code CLI
$ code --add-mcp '{"name":"aiscast","type":"http","url":"https://ais.openwaters.io/mcp"}'Install Open Waters AIS MCP in Codex
$ codex mcp add aiscast --url https://ais.openwaters.io/mcpInstall Open Waters AIS MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.aiscast] url = "https://ais.openwaters.io/mcp"
Install Open Waters AIS MCP in Gemini CLI
$ gemini mcp add -s user --transport http aiscast https://ais.openwaters.io/mcpInstall Open Waters AIS MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"aiscast": {
"url": "https://ais.openwaters.io/mcp",
"type": "http"
}
}
}Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachableopenwatersio/aiscast is public and reachablegithub.com/openwatersio/aiscast ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)AGPL-3.0spdx.org/licenses/AGPL-3.0.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-12github.com/openwatersio/aiscast ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeinitialize answered with protocol 2025-06-18 in 106 msPass
README
View on GitHubaiscast
Live AIS vessel traffic, streamed by bounding box, from community networks, open government feeds, and volunteer receivers. Part of Open Waters. The public instance is ais.openwaters.io. A live map is at openwaters.io/ais/vessels.
This is a beta. There is no SLA. Coverage is uneven. The terms for re-serving some sources are still unsettled (see Coverage). Live status and uptime history are at status.openwaters.io.
Usage
aisstream.io clients. aiscast speaks aisstream.io's protocol on wss://ais.openwaters.io/v0/stream: the same subscribe message, the same MessageType / MetaData / Message frames. Change the hostname and use your aiscast token as the APIKey. Existing code keeps working: aisstream-ts, the official Go/Python/JS examples, and signalk-aisstream.
Native API (full reference).
wss://ais.openwaters.io/v1/stream: send{"type":"subscribe","bbox":[[minLat,minLon,maxLat,maxLon]]}or{"type":"subscribe","mmsi":[368168720]}(or both). Feeder and partner tokens can also follow vessels by IMO number with"imo":[9241061]. You receive one JSON event per decoded AIS message. Each event carries its source, station, receive time, raw sentence, and the decoded fields. Add"snapshot":trueto get the last known messages for every vessel already tracked in the subscription first, then live traffic. Subscribing needs no token.GET https://ais.openwaters.io/v1/vessels?bbox=minLat,minLon,maxLat,maxLon(or?mmsi=a,b,c): GeoJSON of every vessel currently in view. Each vessel carries its last position, name, type, course, speed, heading, flag, and when and from where aiscast last heard it, plus IMO number, call sign, destination, ETA, draught, length, beam, and the AIS antenna's distances to bow, stern, port, and starboard once its static data has been heard. No token.GET https://ais.openwaters.io/v1/stations: every source aiscast is hearing, with message counts and age.
AI assistants. https://ais.openwaters.io/mcp is an MCP (Model Context Protocol) server with six read-only tools: vessels by MMSI, vessels in an area, vessels near a point or another vessel, search by name, a vessel's track, and coverage. No sign-in. Claude lists it in its connector directory. Claude Code: claude mcp add --transport http open-waters-ais https://ais.openwaters.io/mcp. ChatGPT, Cursor, and VS Code take the URL as a custom connector or mcp.json entry; setup for each is on the MCP server page. A token in an Authorization: Bearer header raises the anonymous limits.
Tokens. /v0/stream needs a token. A personal token is self-serve and never expires. Use the token page, or generate an Ed25519 keypair and POST https://ais.openwaters.io/v1/keys with {"pubkey":"<base64url public key>"}, signed with that key as the API reference shows. The response is your token. It carries the personal tier: 2 streams, 50 messages/s, and a 20°×20° area. Feed data from the same token and it becomes a feeder token by itself.
Tiers and limits are in docs/limits.md. For more than the feeder tier, or for commercial use, write to hello@openwaters.io.
Events carry a source, so you can tell a live volunteer receiver from a government feed or an aggregate. synthesized: true marks messages that aiscast re-encoded from a non-NMEA source.
Contributing data
If you run an AIS receiver, send its data here. aiscast re-serves it to everyone, deduplicates it against the open feeds and every other station, and shares volunteer receptions with AISHub as part of our contribution to its community network. Only data received directly by volunteer stations goes to AISHub; public feeds and synthesized messages stay out. You are welcome to keep contributing to other networks too. The terms for contributing are the contributor agreement.
- AIS-catcher (preferred: authenticated, realtime, works behind any NAT): get a token at openwaters.io/ais/token (one click, stays in your browser), then
AIS-catcher ... -Q wssmqtt://x:<token>@ais.openwaters.io:443/v1/stream MSGFORMAT NMEA. Each message is sent as it is decoded, over MQTT on the same WebSocket address the JSON stream uses. Your data appears assource: station:<station id>. Name your station on the token page; until you do, it is labeled by the town nearest the traffic it hears. AIS-catcher's HTTP output works too:-H https://ais.openwaters.io/v1/receive USERPWD x:<token> GZIP on INTERVAL 5posts a batch every five seconds under the same station. - UDP (no token): AIS-catcher
-u udp.ais.openwaters.io 10110, docker-shipfeeder with hostudp.ais.openwaters.ioport10110, or any NMEA forwarder sending plain!AIVDM/!AIVDOsentences (TAG blocks welcome). Your station appears asudp:<id>, a keyed hash of your address, never the address itself. If a sender's!AIVDOsentences identify the vessel, aiscast keys the station by that MMSI instead. - Signal K: add a UDP target
udp.ais.openwaters.io:10110inais-forwarder(forward AIVDM and AIVDO). Or install thesignalk-aiscastplugin. It needs no token. It shares what your receiver hears, and your own position, taken from the transponder or built from Signal K when an AIS transponder is not available. It shows aiscast traffic when you have no receiver.
Your station page is https://openwaters.io/ais/stations/<your id>, and the station list links every station. It shows the station's uptime, its messages per hour over the last week, the vessels it heard in the last day by type and how many no other station heard, and the cells it heard over the last week on the map. GET /v1/stations/{id} and /v1/coverage/tiles.json?station=<id> return the same figures. Feeders get the deduplicated raw stream back on wss://ais.openwaters.io/v1/nmea.
Coverage
| Source | Where | Freshness |
|---|---|---|
| Kystverket | Norwegian coast, 40–60 nm out | live |
| BarentsWatch | Norwegian EEZ, Svalbard, Jan Mayen (satellite + offshore receivers) | live |
| Fintraffic Digitraffic | Finnish waters | live |
| Volunteer receivers | wherever they are (Buzzards Bay / Vineyard Sound as of the first station) | live |
| AISHub aggregate | worldwide terrestrial, ~50k vessels | about a minute behind |
| aisstream.io | worldwide, when it is up | live, but frequently down |
AISHub and its contributors make much of our worldwide terrestrial coverage possible. We contribute volunteer receptions in return and credit AISHub on every event from its aggregate.
/v1/stats reports each source's current delay from broadcast to arrival (delay.p50 and delay.p99, in seconds).
Every event names the source it came from. docs/policy.md lists the sources this project leaves out on purpose, and why.
Licensing and attribution
Licensing is per source. aiscast does not relicense the aggregate. aiscast re-serves each event under the terms of the source it came from. That is why source is on every event, every vessel, and every archived hour, and why every /v1 event carries a license tag and an attribution credit line. Every attribution opens with "Open Waters AIS (https://openwaters.io/ais/)"; sources with their own terms add their credit after it. If you display or redistribute the data, display the attribution message included with each event. /v1/vessels carries the same credits as a top-level attribution member on the feature collection, one entry per source present. The table below is the same information as reference.
| Source | License | What you must do |
|---|---|---|
| Kystverket | NLOD 2.0 | Credit: "Contains data under the Norwegian licence for Open Government data (NLOD) distributed by the Norwegian Coastal Administration." NLOD is not sublicensable, so it binds you directly. |
| BarentsWatch | NLOD per the BarentsWatch API terms | Credit: "Data delivered by BarentsWatch." It is the same AIS Norge data as Kystverket, so the Kystverket credit applies too. |
| Fintraffic Digitraffic | CC BY 4.0 | Credit: "Source: Fintraffic / digitraffic.fi, license CC 4.0 BY." |
| Volunteer receivers | The contributor agreement dedicates receptions to the public domain under CC0 and publishes the aggregate under ODbL | Credit "Open Waters AIS (https://openwaters.io/ais/)". Individual receptions are CC0. The aggregate carries ODbL. |
| AISHub aggregate | AISHub terms and any applicable written agreement | Credit AISHub contributors and keep source: aishub. Reuse and redistribution must follow the applicable terms. |
| aisstream.io | no published terms | Best effort, may disappear. source: aisstream. |
| Wikidata particulars | CC0 1.0 | Nothing. The wikidata object on /v1/vessels/{mmsi} and in MCP get_vessels says so with license: CC0-1.0. The Commons photos its image and commons_category link to carry their own licenses. |
| US Coast Guard PSIX | Public domain (U.S. government work) | Nothing. The uscg object on /v1/vessels/{mmsi} and in MCP get_vessels says so in its license. |
| AMSA ship register | CC BY 4.0 | Credit: "© Australian Maritime Safety Authority". The sources.amsa entry on /v1/vessels/{mmsi} and in MCP get_vessels carries it with license: CC-BY-4.0. |
| MarineCadastre | Public domain (U.S. government work); NOAA labels its 2024 release CC0 | Nothing required. Track history from it credits "U.S. Coast Guard Nationwide AIS, via MarineCadastre.gov (NOAA and BOEM)." and keeps source: marinecadastre. |
| Danish Maritime Authority | Reuse under the Danish public sector information act; the data management policy forbids combining it so that private individuals become identifiable | Track history from it credits "Danish Maritime Authority." and keeps source: dma. |
aiscast's code, including the web client, is AGPL-3.0. The Signal K plugin (signalk-plugin/) stays MIT. Code released before the switch stays available under the MIT license it was released under. Contributors sign the Contributor License Agreement; see CONTRIBUTING.md. The code license covers the software only: the data keeps the per-source terms above. aiscast identifies UDP stations by a keyed hash instead of an address (a station that sends !AIVDO is keyed by that MMSI, and its position is in the data it shares). Station labels on /v1/stations, and near on vessel searches and /v1/vessels/{mmsi}, name the nearest town from GeoNames, CC BY 4.0. The archive keeps raw receptions per source, so the project can purge any source. docs/policy.md states the full position: what the contributor agreement says, the privacy rules, and how the project intends to fund itself without relicensing data.
Contributing
Developers and operators: see CONTRIBUTING.md.
Open Waters AIS MCP questions
How do I add Open Waters AIS MCP to Claude Code?
Run claude mcp add --transport http aiscast https://ais.openwaters.io/mcp in your terminal. Add --scope user to make it available in every project.
How do I add Open Waters AIS MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools are available through the MCP server?
The server provides six read-only tools: vessels by MMSI, vessels in an area, vessels near a point or another vessel, search by name, a vessel's track, and coverage.
How can I increase my usage limits?
Providing an Authorization: Bearer header with a token will raise the anonymous limits.