# Mothership

Links an AI assistant to a Mothership freight account for rate quotes, shipment tracking and cancellations in plain language.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 8 repo stars
- Author: mothership
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/mothership/agent-plugins
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/mothership

## What it does

The server exposes a freight marketplace for LTL, truckload and local shipping. An assistant connected to it can pull carrier quotes with prices and delivery dates, look up a shipment by its Mothership reference, PRO, BOL or pickup number, and cancel a booking only after showing the fee and refund amount. It also handles NMFC class lookups from weight and dimensions, address serviceability checks, invoices, payment methods and freight claims.

Connection runs over Streamable HTTP with OAuth 2.1 sign-in, so the assistant only sees what the signed-in Mothership account can access. The server has no dynamic client registration, which is why Cursor authenticates through a client ID that Mothership pre-registered for it rather than a generic OAuth flow.

The same repository ships a companion plugin for Claude and Codex that bundles Mothership's task instructions for quoting, tracking and cancelling shipments. Skip the plugin and the server still exposes those same instructions through its `skill-get` tool.

## Requirements
- Remote server: `https://mcp.mothership.com`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http mothership https://mcp.mothership.com
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add mothership --url https://mcp.mothership.com
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mothership": {
            "url": "https://mcp.mothership.com"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mothership": {
            "type": "http",
            "url": "https://mcp.mothership.com"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http mothership https://mcp.mothership.com
```

## When to use it
- get LTL, truckload or local freight quotes from multiple carriers
- track a shipment by BOL, PRO or pickup number
- cancel a shipment after reviewing the fee and refund first
- look up an NMFC freight class from weight and dimensions
- check whether an address is serviceable or residential

## Example prompts
- Get a quote for a 450 lb pallet shipping from Chicago to Dallas
- Track shipment with BOL number 12345
- Check the cancellation fee for my latest shipment before I cancel it

## Similar
- [Easyship](https://affpapa.org/en/nevibecode/mcp/easyship.md) — MCP server
- [ocean-schedules](https://affpapa.org/en/nevibecode/mcp/ocean-schedules.md) — MCP server · 3149 installs
- [Shipping Rates](https://affpapa.org/en/nevibecode/mcp/shipping-rates.md) — MCP server · 1820 installs
- [carrier-relationship-management](https://affpapa.org/en/nevibecode/skills/carrier-relationship-management.md) — skill · ★ 85 repo stars
- [FreightUtils MCP Server](https://affpapa.org/en/nevibecode/mcp/freightutils-mcp-server.md) — MCP server · ★ 8 repo stars
- [Shippo](https://affpapa.org/en/nevibecode/mcp/shippo.md) — MCP server · ★ 3 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
