SeaRoutesNav

Model Context Protocol

Ask your LLM about sea routes

Connect SeaRoutes to Claude, Cursor or another MCP client and ask for ports, registered vessels, navigable routes and voyage emissions in plain language.

Connect your clientExplore MCP tools
Ports and vesselsRoutes and geometryVoyage CO2e

SeaRoutes MCP

Streamable HTTP

Ready to connect
{
  "mcpServers": {
    "searoutes": {
      "transport": "streamable-http",
      "url": "https://searoutesnav.com/mcp",
      "headers": {
        "X-SeaRoutes-Email": "you@example.com",
        "X-SeaRoutes-Password": "••••••••"
      }
    }
  }
}
Ports and vesselsRoutes and geometryVoyage CO2e

Natural-language examples

Try asking SeaRoutes

Your client chooses the right MCP tools and returns answers from the same maritime data behind this site.

“How far is Shanghai from Rotterdam, and how long will it take at 14 knots?”
“Compare Singapore to Hamburg via Suez against the Cape of Good Hope.”
“Estimate CO2e for 1,200 TEU from Santos to Antwerp on a deep-sea container vessel.”
“Find Aquadonna, then estimate a Rotterdam to Singapore voyage carrying 40,000 tonnes.”
“Which port is NLRTM, and what are its coordinates?”
“Give me the route geometry from Suez to Singapore so I can plot it.”

Setup

Connect your client in three steps

Use your existing SeaRoutes email and password. The MCP server authenticates the requests sent by your client, so there is no separate key you need to generate.

  1. STEP 01

    Choose your client

    Select Claude Desktop, Claude Code or another streamable HTTP client.

  2. STEP 02

    Add your credentials

    Paste the generated config and replace the email and password placeholders.

  3. STEP 03

    Restart and ask

    Reload your client, then ask a port, route, vessel or emissions question.

Configuration

Open Settings → Developer → Edit Config, paste the block into claude_desktop_config.json, replace both values under env, then restart Claude Desktop.

After restarting, ask a simple port question to confirm the connection.
claude_desktop_config.json
{
  "mcpServers": {
    "searoutes": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://searoutesnav.com/mcp",
        "--header",
        "X-SeaRoutes-Email:${SEAROUTES_EMAIL}",
        "--header",
        "X-SeaRoutes-Password:${SEAROUTES_PASSWORD}"
      ],
      "env": {
        "SEAROUTES_EMAIL": "you@example.com",
        "SEAROUTES_PASSWORD": "your-searoutes-password"
      }
    }
  }
}

Your config file holds your password in plain text. Keep it out of version control and off shared machines. Sign-in attempts are rate limited, and you can change your password at any time from your account.

MCP toolkit

What your assistant can do

Your assistant calls these five tools only when the question needs them. Search and status calls do not spend a route calculation.

Port search

search_ports

Find ports by name or UN/LOCODE and return their SeaRoutes id, country and coordinates.

Trial while routes remain · BusinessDoes not spend a route

Vessel search

search_vessels

Find registered vessels by name or IMO, including known deadweight and an emissions class mapping when available.

Trial while routes remain · BusinessDoes not spend a route

Sea route calculation

calculate_sea_route

Calculate sailing distance in nautical miles, voyage duration, passages and optional full route geometry.

5 shared Trial routes · Unlimited BusinessUses 1 route

Voyage CO2 emissions

calculate_voyage_emissions

Calculate well-to-wake CO2e from route, cargo and vessel data, with the method and data quality reported in every result.

Business onlySeparate from route allowance

Account status

get_account_status

Check the active plan and how many Trial route calculations remain without spending an allowance.

Always availableDoes not spend a route

Plan access

MCP access by plan

Trial is a limited introduction. Business keeps search open and unlocks unlimited routes and voyage emissions.

Limited access

Trial

Try the core MCP workflow

A short evaluation for signed-in accounts, available only while the introductory route allowance remains.

5 route calculations total

Shared with the site calculator as one allowance. It does not reset daily.

When the allowance is used, port and vessel search also close.

  • Port searchWhile Trial routes remain
  • Vessel searchWhile Trial routes remain
  • Sea route calculations5 total, shared with the site
  • Full route geometryIncluded with a route
  • Voyage CO2 emissionsNot included over MCP
  • Account and route statusAlways available
Full access

Business

Unlimited maritime answers

Use the complete MCP toolkit for ongoing route and emissions work.

Unlimited route calculations

Port and vessel search remain available without a Trial cutoff.

Voyage CO2 emissions are included.

  • Port searchIncluded
  • Vessel searchIncluded
  • Sea route calculationsUnlimited
  • Full route geometryIncluded with a route
  • Voyage CO2 emissionsIncluded
  • Account and route statusAlways available
See Business Pricing