# Machship MCP

> Machship MCP is an open-source MCP server for freight and logistics. Machship freight API for agents: live rates, consignments, labels, tracking and invoices. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API
- **Website:** https://devkind.com.au/services
- **Repository:** https://github.com/devkindhq/machship-mcp
- **MCP Registry name:** io.github.devkindhq/machship-mcp
- **Categories:** freight and logistics
- **Listing updated:** 2026-11-15

## About

With 125 tools over the Machship freight platform API, this server lets an agent work through the shipping cycle: get live rates and quotes, create consignments, produce labels and manifests, track freight and look at invoices. It runs with `npx` over stdio, or as an HTTP endpoint on port 3000.

You need Node.js 22 or later and a Machship API token, generated in Machship under Settings, then API. The token goes in the `MACHSHIP_API_TOKEN` environment variable, and the README advises keeping it in user-level client config rather than a committed project file. A first prompt such as asking the agent to ping the Machship API confirms the token works.

No Docker image is published; the repo can be built into one for either stdio or HTTP use. Setup steps are given for Claude Desktop, Claude Code, Cursor, VS Code, Windsurf, Goose, LM Studio and Warp, and a Claude Code plugin is available. It is built by Devkind, a Melbourne web development agency.

## Features

- **125 freight tools:** Covers rates, quotes, consignments, labels, manifests, tracking and invoices.
- **Stdio or HTTP:** Runs through npx over stdio, or as an HTTP endpoint.
- **Token-based access:** Uses a Machship API token set in an environment variable.
- **Wide client setup:** Config steps for Claude Desktop, Claude Code, Cursor, VS Code, Windsurf, Goose, LM Studio and Warp.
- **Docker build:** Build the image from the repo for stdio or HTTP mode.

## Good for

- Compare live freight rates from an AI chat
- Book a consignment and print its label
- Track a shipment's progress
- Look up freight invoices
- Prepare manifests for a dispatch run

## Install

### Claude Code (Terminal)

```sh
claude mcp add machship-mcp --env MACHSHIP_API_TOKEN='<MACHSHIP_API_TOKEN>' -- npx -y @devkind/machship-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "machship-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@devkind/machship-mcp"
      ],
      "env": {
        "MACHSHIP_API_TOKEN": "<MACHSHIP_API_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "machship-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@devkind/machship-mcp"
      ],
      "env": {
        "MACHSHIP_API_TOKEN": "<MACHSHIP_API_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "machship-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@devkind/machship-mcp"
      ],
      "env": {
        "MACHSHIP_API_TOKEN": "<MACHSHIP_API_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "machship-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@devkind/machship-mcp"
      ],
      "env": {
        "MACHSHIP_API_TOKEN": "<MACHSHIP_API_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "machship-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@devkind/machship-mcp"
      ],
      "env": {
        "MACHSHIP_API_TOKEN": "<MACHSHIP_API_TOKEN>"
      }
    }
  }
}
```

## FAQ

### What do I need to use it?

Node.js 22 or later and a Machship API token from Settings, then API.

### How many tools does it have?

The README says 125.

### Is a Docker image published?

No. You build it from the repo.

### How do I check it works?

Ask your agent to ping the Machship API; a successful reply confirms the token.

### Where do I keep the token?

In user-level client config, not a committed project .mcp.json.

### Is Machship MCP free?

Yes. Machship MCP is open source, so you can use and self-host it for free.

### How do I add Machship MCP to Claude Code?

Run this command in your terminal: claude mcp add machship-mcp --env MACHSHIP_API_TOKEN='<MACHSHIP_API_TOKEN>' -- npx -y @devkind/machship-mcp

### What are the best alternatives to Machship MCP?

The closest alternatives to Machship MCP are Lane Cost freight rates, Zentria Flow, Gangway AIS, Cofinal and X3 Compliance.

## Alternatives

- [Lane Cost freight rates](https://ai-powered.com/mcp/lane-cost-freight-rates): Lane Cost freight rates is a free MCP server for freight and logistics.
- [Zentria Flow](https://ai-powered.com/mcp/zentria-flow): Zentria Flow is a freemium MCP server for freight and logistics.
- [Gangway AIS](https://ai-powered.com/mcp/gangway-ais): Gangway AIS is a freemium MCP server for freight and logistics.
- [Cofinal](https://ai-powered.com/mcp/cofinal): Cofinal is a paid MCP server for freight and logistics.
- [X3 Compliance](https://ai-powered.com/mcp/x3-compliance): X3 Compliance is a free MCP server for security.
- [RouteMetrics](https://ai-powered.com/mcp/routemetrics): RouteMetrics is a freemium MCP server for maps and travel.
- [Argo Hub Picking y Packing](https://ai-powered.com/mcp/argo-hub-picking-y-packing): Argo Hub Picking y Packing is a free MCP server for freight and logistics.
- [Argo Hub Coste de Devoluciones](https://ai-powered.com/mcp/argo-hub-coste-de-devoluciones): Argo Hub Coste de Devoluciones is a free MCP server for freight and logistics.

---
Source: https://ai-powered.com/mcp/machship-mcp
