Skip to content
MCP server

ShipsGo MCP by usefulapi

Track ocean containers and air cargo, read their routes, and manage shipments in ShipsGo.

Install
Runs
Remotely
Version
1.4.0
Listing updated
5 days ago

About ShipsGo MCP by usefulapi

ShipsGo MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.

Install

Run in a terminal

claude mcp add --transport http shipsgo https://shipsgo.usefulapi.io/mcp

Add to Settings → Connectors → Add custom connector

https://shipsgo.usefulapi.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "shipsgo": {
      "url": "https://shipsgo.usefulapi.io/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "shipsgo": {
      "type": "http",
      "url": "https://shipsgo.usefulapi.io/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "shipsgo": {
      "serverUrl": "https://shipsgo.usefulapi.io/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "shipsgo": {
      "type": "http",
      "url": "https://shipsgo.usefulapi.io/mcp"
    }
  }
}

Tools this server provides (13)

Read directly from the server.

shipsgo_list_ocean_carriers
List the ocean carriers ShipsGo supports, with their SCAC codes and status. Use the codes in ocean shipment tools. ShipsGo API: GET /v2/ocean/carriers.
shipsgo_list_ocean_shipments
List ocean container shipments on the account with status, carrier, route and dates. Filter by status, carrier, reference or container number. A sub-account with the Co-Worker role sees only its own shipments. ShipsGo API: GET /v2/ocean/shipments.
shipsgo_get_ocean_shipment
Get one ocean shipment with its status, containers, carrier and movement events. ShipsGo API: GET /v2/ocean/shipments/{shipment_id}.
shipsgo_get_ocean_route
Get the route of one ocean shipment as GeoJSON (ports and track points). ShipsGo API: GET /v2/ocean/shipments/{shipment_id}/geojson.
shipsgo_create_ocean_shipment
Start tracking an ocean shipment by booking number or container number. Creating a shipment uses account credits (HTTP 402 when none are left). A repeat with the same reference and booking number (or container number when no booking number is given) returns HTTP 409 with the existing shipment, at no cost. ShipsGo API: POST /v2/ocean/shipments.
shipsgo_update_ocean_shipment
Change the reference of an ocean shipment. Only the reference can be changed here. ShipsGo API: PATCH /v2/ocean/shipments/{shipment_id}.
shipsgo_delete_ocean_shipment
Delete an ocean shipment from the account. Tracking stops and the shipment cannot be restored by this server. ShipsGo API: DELETE /v2/ocean/shipments/{shipment_id}.
shipsgo_list_air_shipments
List air cargo shipments on the account with status and dates. Filter by status, reference or AWB number. A sub-account with the Co-Worker role sees only its own shipments. ShipsGo API: GET /v2/air/shipments.
shipsgo_get_air_shipment
Get one air shipment with its status, movements and AWB details. ShipsGo API: GET /v2/air/shipments/{shipment_id}.
shipsgo_get_air_route
Get the route of one air shipment as GeoJSON (airports and track points). ShipsGo API: GET /v2/air/shipments/{shipment_id}/geojson.
shipsgo_create_air_shipment
Start tracking an air cargo shipment by AWB number. Creating a shipment uses account credits (HTTP 402 when none are left). A repeat with the same AWB number (and the same reference, when one is given) returns HTTP 409 with the existing shipment, at no cost. ShipsGo API: POST /v2/air/shipments.
shipsgo_update_air_shipment
Change the reference of an air shipment. Only the reference can be changed here. ShipsGo API: PATCH /v2/air/shipments/{shipment_id}.
shipsgo_delete_air_shipment
Delete an air shipment from the account. Tracking stops and the shipment cannot be restored by this server. ShipsGo API: DELETE /v2/air/shipments/{shipment_id}.

ShipsGo MCP by usefulapi FAQ

How do I add ShipsGo MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http shipsgo https://shipsgo.usefulapi.io/mcp