Skip to content
MCP server

Machship MCP

Machship freight API for agents: live rates, consignments, labels, tracking and invoices

Runs locallyStatus and history
Pricing
Open source
Platforms
CLI, API
Runs
Locally
Version
1.4.0
Listing updated
2 days ago

About Machship MCP

Machship MCP is an open-source MCP server for freight and logistics. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

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

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

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

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

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

Configuration

  • MACHSHIP_API_TOKENYour Machship API token (Settings → API → Generate token)Required
  • MACHSHIP_API_URLOverride the Machship API base URL (default: https://live.machship.com)

What it does

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

Pricing

Open source

Server is free; a Machship account and API token are required

Prices change. Check devkind.com.au before you buy.

Machship MCP 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 to Machship MCP

  1. Free US truckload rate estimates for any lane, 8 truck types, history from 2003

    • 13 tools
    • Remote
    • Free
    • Freight and logistics
  2. Zentria Flow

    MCP server

    US tariff layers by HTS code and origin, origin comparison and landed cost for importers

    Runs locally
    • 4 tools
    • Freemium
    • Freight and logistics
  3. Gangway AIS

    MCP server

    Vessel positions, port calls and anchorage waiting times from licensed AIS data

    • 21 tools
    • Remote
    • Freemium
    • Freight and logistics
  4. Cofinal

    MCP server

    Check orders, stock, inbound shipments, returns and invoices at a Danish warehouse

    • Remote
    • Paid
    • Freight and logistics
  5. X3 Compliance

    MCP server

    Regulation-citing tools for trucking, OSHA, 811 dig times, eCFR and Coast Guard records

    • 20 tools
    • Remote
    • Free
    • Security
  6. RouteMetrics

    MCP server

    Road miles, drive times, stop order and truck IFTA miles in your AI assistant

    Not checked yet
    • Remote
    • Freemium
    • Maps and travel