Grandline Mcp

io.github.dmsnavinPublished by GitHub account dmsnavinv0.2.1Updated Oct 24, 2026

Empirical maritime distances from real AIS tracks: 4 route variants, port lookup, bulk matrix

VerifiedSTDIODesktop onlyLocation & LifestyleData & Analytics

Overview

AI-generated overview

Local MCP server that gives an assistant empirical maritime distances from real AIS tracks, with route variants, port lookup and bulk matrices.

What you can do
  • Look up ports and compute sea distances between them from real AIS vessel tracks.
  • Compare four route variants for a given voyage.
  • Build bulk distance matrices across many port pairs.
  • Optionally point requests at a different API base URL.
When to use it
Useful when an assistant needs shipping distances, voyage routing options or port-to-port matrices for logistics, freight or maritime analysis, rather than straight-line or synthetic distances.
Requirements
Runs as a local Python package (grandline-mcp) over stdio on desktop. Needs network access to the Grandline API; a GRANDLINE_API_KEY bearer token from the provider's registration page is optional, and without it the anonymous tier allows 5 calls total per IP. GRANDLINE_API_URL can override the default API base URL.
Before you install
The API key is a secret sent as a bearer token; keep it out of shared configs. Without a key you are limited to 5 calls per IP in total, so real use needs registration. Requests and port pairs go to the third-party Grandline service, and overriding GRANDLINE_API_URL sends your key to whatever host you specify.

Installation

In SourceWeft

  1. Open Grandline Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

This repository has no README.

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.2.1LatestSep 16, 2026

Score

25% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts

    Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.

  • License10 pts

    Declare a license in the repository or the registry entry.