Mothership — Claude Code MCP server: what it does, how to install
Links an AI assistant to a Mothership freight account for rate quotes, shipment tracking and cancellations in plain language.
MIT ★ 8 updated 2026-10-29
claude mcp add --transport http mothership https://mcp.mothership.comWhat Mothership 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.
What it helps with
- 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 for the agent
- 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
How to install Mothership
Platform CLI: remote server
claude mcp add --transport http mothership https://mcp.mothership.comPlatform CLI: remote server
codex mcp add mothership --url https://mcp.mothership.comConfig file
{
"mcpServers": {
"mothership": {
"url": "https://mcp.mothership.com"
}
}
}Config file
{
"servers": {
"mothership": {
"type": "http",
"url": "https://mcp.mothership.com"
}
}
}Platform CLI: remote server
gemini mcp add -t http mothership https://mcp.mothership.comStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Mothership
How do I install Mothership in Claude Code?
Run claude mcp add --transport http mothership https://mcp.mothership.com.
What does the Mothership MCP server do?
It connects an AI assistant to a Mothership freight account so it can fetch carrier quotes, track and cancel shipments, check invoices and look up NMFC freight classes on request.
Do I need a Mothership account to use this server?
Yes, the server authenticates over OAuth 2.1 against your Mothership account, and the assistant only sees data that account can access.