# ShipsGo MCP by usefulapi

> ShipsGo MCP by usefulapi is an MCP server. Track ocean containers and air cargo, read their routes, and manage shipments in ShipsGo. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/shipsgo/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/shipsgo
- **MCP Registry name:** io.usefulapi/shipsgo
- **Listing updated:** 2026-11-13

## About

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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://shipsgo.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "shipsgo": {
      "url": "https://shipsgo.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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}.

## 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

---
Source: https://ai-powered.com/mcp/shipsgo-mcp-by-usefulapi
